추적 상태 API
trackingstatuschanged라는 JavaScript 이벤트를 사용하여 대상의 추적 상태에 대한 변경 내용 정보를 얻을 수 있습니다. trackingstatuschanged 이벤트에는 키-값 쌍이 포함된 JSON 페이로드가 있으며, 아래와 같이 trackingStatus 키와 상태 문자열 값이 포함됩니다.
{"trackingStatus":"<tracking_status>"}
위 문자열에서 <tracking_status> 변수는 다음 상태 중 하나일 수 있습니다.
|
상태
|
설명
|
||
|---|---|---|---|
|
normal
|
대상을 추적 중이며 정상 작동을 나타냅니다.
|
||
|
extended
|
대상을 간접적으로 추적하고 있습니다. 보기에서 벗어났거나, 가려졌거나, 너무 멀거나, 너무 가까워 직접 추적할 수 없습니다.
|
||
|
limited
|
대상을 추적하고 있지만 정확도가 매우 낮습니다.
|
||
|
limited_excessive_motion
|
장치가 너무 빨리 움직이기 때문에 추적이 제한됩니다.
|
||
|
limited_insufficient_light
|
조명 조건이 좋지 않아 추적이 제한됩니다.
|
JavaScript에 구현된 이벤트 처리기에는 다음과 같은 서명이 있습니다.
function(event, target, tmlNodeName, args)
다음 표에는 사용 가능한 매개 변수와 해당 설명이 나와 있습니다..
|
매개 변수
|
설명
|
||
|---|---|---|---|
|
event
|
이벤트 객체입니다. 여기에는 이름 속성에 대한 trackingstatuschanged 문자열이 포함됩니다.
|
||
|
target
|
대상의 이름 또는 ID입니다.
|
||
|
tmlNodeName
|
객체의 유형입니다. 이 이벤트에 대한 값은 twx-dt-target입니다.
|
||
|
args
|
JSON 이벤트 데이터를 포함하는 문자열입니다.
|
예
다음은 JavaScript 이벤트 처리기의 구현 예제입니다.
$scope.$on("trackingstatuschanged", function (event, target, tmlNodeName, args) {
trackingStatus = JSON.parse(args).trackingStatus;
console.log("Tracking Status Changed Script: event: " + event.name + ", target: " + target + ", tmlNodeName: " + tmlNodeName + ", args:" + args + ", trackingStatus: " + trackingStatus);
});
다음은 로그 출력의 예입니다.
Tracking Status Changed Script: event: trackingstatuschanged, target: 740de1d2-6202-45ab-94db-1056ecf2244b, tmlNodeName: twx-dt-target, args:{"trackingStatus":"extended"}, trackingStatus: extended