追蹤狀況 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