Verfolgungsstatus-API
Sie können ein JavaScript-Ereignis namens trackingstatuschanged verwenden, um Informationen über Änderungen am Verfolgungsstatus eines Ziels zu erhalten. Das trackingstatuschanged-Ereignis hat eine JSON-Payload, die ein Schlüssel-Wert-Paar mit trackingStatus als Schlüssel und einem Statuszeichenfolgenwert enthält:
{"trackingStatus":"<tracking_status>"}
In der obigen Zeichenfolge kann die Variable <tracking_status> einen der folgenden Status aufweisen:
|
Status
|
Beschreibung
|
|
normal
|
Das Ziel wird verfolgt und zeigt einen normalen Betrieb an.
|
|
extended
|
Das Ziel wird indirekt verfolgt. Er ist entweder nicht sichtbar, verdeckt, zu weit entfernt oder zu nah, um direkt verfolgt zu werden.
|
|
limited
|
Das Ziel wird verfolgt, jedoch mit sehr geringer Genauigkeit.
|
|
limited_excessive_motion
|
Die Verfolgung ist eingeschränkt, da das Gerät zu schnell bewegt wird.
|
|
Dieser Status wird nur für Modellziele gemeldet.
|
|
|
limited_insufficient_light
|
Die Verfolgung ist aufgrund schlechter Lichtverhältnisse eingeschränkt.
|
|
Dieser Status wird nur für Modellziele gemeldet.
|
|
Der in JavaScript implementierte Ereignishandler hat die folgende Signatur:
function(event, target, tmlNodeName, args)
In der folgenden Tabelle werden die verfügbaren Parameter aufgelistet und beschrieben:
|
Parameter
|
Beschreibung
|
|
event
|
Das Ereignisobjekt. Es enthält die trackingstatuschanged-Zeichenfolge für die Eigenschaft "name".
|
|
target
|
Name oder ID des Ziels.
|
|
Dies ist eine leere Zeichenfolge für räumliche Ziele.
|
|
|
tmlNodeName
|
Typ des Objekts. Der Wert ist twx-dt-target für dieses Ereignis.
|
|
args
|
Zeichenfolge, die die JSON-Ereignisdaten enthält.
|
Beispiel
Nachfolgend finden Sie eine Beispielimplementierung des JavaScript-Ereignishandlers:
$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);
});
Dies ist ein Beispiel für die Protokollausgabe:
Tracking Status Changed Script: event: trackingstatuschanged, target: 740de1d2-6202-45ab-94db-1056ecf2244b, tmlNodeName: twx-dt-target, args:{"trackingStatus":"extended"}, trackingStatus: extended
