CMSV6 API und Videointegration: Was eine Drittanbieter-Plattform nutzen kann

Integrationsleitfaden

Eine Drittanbieter-Plattform kann CMSV6 auf vier Wegen nutzen: die HTTP-API für Daten und Alarme, Stream-Adressen für Live-Video, ein Web-Player-Plugin für Browser sowie iOS- und Android-SDKs für Apps. Eine Einschränkung ist von Anfang an wichtig: Die Live-Streams über RTSP, HTTP-FLV, HLS und RTMP unterstützen nur H.264. H.265-Video erfordert das Web-Player-Plugin.

Wie Geräte CMSV6 erreichen

Fahrzeuggeräte verbinden sich über JT/T 808 und JT/T 1078 mit CMSV6. JT/T 808 überträgt Positions- und Alarmdaten. JT/T 1078 überträgt Video. Ihre Plattform kommuniziert nicht mit dem Gerät. Sie kommuniziert mit CMSV6, das die Daten dann bereitstellt. Die Checkliste in Which Devices Can Connect to CMSV6 erklärt, wie Sie bestätigen, dass ein Gerätemodell eine Verbindung herstellen kann. Die Schnittstellen pro Modell finden Sie auf jeder Produktseite und in Ihrem Angebot.

Was die HTTP-API abdeckt

Sie melden sich mit einem CMSV6-Konto an und erhalten eine Sitzungsnummer. Jeder weitere Aufruf verwendet diese. Die Sitzung ist 4 Stunden gültig und bleibt gültig, solange Aufrufe erfolgen. Eine zweite Anmeldung mit demselben Konto beendet die erste Sitzung nicht. Die Sitzung trägt die Rolle und die Fahrzeugberechtigungen des Kontos, sodass ein API-Benutzer nur die Geräte sieht, die dieses Konto sehen darf.

Alarmabfragen können Koordinaten im Format WGS84 (Standard), Google (GCJ-02) oder Baidu (BD09) zurückgeben, wählbar über einen Anforderungsparameter. Alarmabfragen benötigen eine Start- und Endzeit und decken bis zu 90 Tage pro Anfrage ab. Die vollständige Referenz finden Sie im Abschnitt HTTP API des Help Centers.

Live-Video: Stream-Adressen

CMSV6 gibt eine Live-Video-Adresse zurück, die ein anderer Player oder eine andere Plattform öffnen kann. Die Adresse setzt sich aus der Sitzungsnummer, der Gerätenummer, dem Kanal (ab 0 gezählt) und dem Stream-Typ (0 für den Hauptstream, 1 für den Substream) zusammen.

Wenn Ihre Kameras H.265 senden, verwenden Sie für Live-Video im Browser das unten beschriebene Web-Player-Plugin. Die oben genannten Stream-Adressen unterstützen nur H.264. Details finden Sie im Abschnitt Video protocol integration.

Video und Karten in Ihre eigene Web- oder Mobile-App einbetten

• Web-Player-Plugin. Eine JavaScript-Datei und ein WebAssembly-Decoder fügen Live-Video, Wiedergabe, Gegensprechen und Broadcast zu PC- und Mobilbrowsern hinzu. Es unterstützt H.264 und H.265. Die Decoder-Datei muss im Web-Root der Seite liegen, sonst kann das Video schwarz bleiben. Eine Vue-Integrationsanleitung ist enthalten. Siehe Web video integration.
• Fertige Webseiten. Der Server stellt Seiten für Live-Video und Remote-Wiedergabe eines einzelnen Fahrzeugs bereit. Sie übergeben Parameter in der Seitenadresse – der schnellste Weg, wenn Sie nur ein Fahrzeug auf dem Bildschirm benötigen.
• Webseiten-Integration. Passwortfreie Anmeldung, eine Echtzeit-Positionsseite und eine Track-Wiedergabeseite können aus Ihrem eigenen System geöffnet werden. Siehe Web page integration.
• Mobile SDK. Native iOS- und Android-SDKs decken Echtzeit-Audio und -Video, Gegensprechen, Remote-Wiedergabe und lokale Gerätesuche ab. Siehe Mobile SDK.

Welchen Weg Sie wählen sollten

Was die Plattform auf dem Bildschirm tut, sobald die Daten eintreffen, erfahren Sie unter Live-Video-Überwachung, Track- und Video-Wiedergabe sowie Alarmregeln und Alarmbearbeitung.

Wenn Sie Ihr eigenes Gerät oder Steuergerät entwickeln

Die CMSV6-Dokumentation erklärt, wie ein Gerät an die Plattform meldet. Sie beschreibt nicht, wie die AlwayCare-Fahrerüberwachungssoftware auf einem kundeneigenen Chip ausgeführt wird. Diese Einschränkung wird am Ende dieses Abschnitts behandelt.

Zwei Verbindungswege. Ein Gerät kann sich über die Standardprotokolle JT/T 808 und JT/T 1078 verbinden oder über das private CMSV6-Protokoll, das über eine eigene geräteseitige Netzwerkbibliothek und Dokumentation verfügt.

Was ein Gerät für die Verbindung benötigt

• Drei Einstellungen am Gerät: die öffentliche IP-Adresse oder Domain des Servers, der Meldeport und die Geräte-ID. Der Plattformbetreiber stellt Adresse und Port bereit. In den geräteseitigen Menüs des privaten Protokolls, die in der Dokumentation beschrieben sind, ist der Standardport 6608; verwenden Sie den Port Ihrer eigenen Bereitstellung.
• Die Geräte-ID muss mit der Plattform übereinstimmen. JT/T-Geräte verwenden normalerweise eine 12-stellige Gerätenummer. Ist die Nummer kürzer, ergänzt die Plattform führende Nullen auf 12 Stellen. Die Geräte-ID ist das Einzige, woran die Plattform ein Gerät erkennt.
• Fügen Sie das Fahrzeug auf der Plattform hinzu. Verwenden Sie Quick Add Vehicle und geben Sie Geräte-ID, Kennzeichen, Terminaltyp und Unternehmen ein. Sie können auch Unregistered Devices öffnen. Ein Gerät, das dort erscheint, hat bereits eine Verbindung zur Plattform hergestellt, und Sie können es aus dieser Liste einem Fahrzeug zuordnen.
• Prüfen Sie das Netzwerk. Ein Gerät in einem eingeschränkten oder gerichteten Netzwerk kann nur an einen festen Server melden. Stellen Sie sicher, dass das Netzwerk dem Gerät erlaubt, Ihre Plattform zu erreichen.

Fahrerüberwachungs- und ADAS-Alarme über JT/T 808 und JT/T 1078 melden

Wenn ein Gerät einen Aktive-Sicherheit-Alarm auslöst (zum Beispiel eine Fahrermüdigkeits- oder Vorwärtskollisionswarnung), kann es Bilder oder Video anhängen. Die Plattform fordert die Anhänge an, und das Gerät lädt sie auf einen Anhangsserver hoch. Die Reihenfolge ist:

1. Das Gerät sendet Positionsdaten (Nachricht 0200), die den Aktive-Sicherheit-Alarm und die Anzahl der Anhänge enthalten.
2. Das Plattform-Gateway antwortet mit einer allgemeinen Antwort und sendet Nachricht 9208, die Adresse und Port des Anhangsservers enthält. Das Gerät antwortet mit einer allgemeinen Antwort. Der Port des Anhangsservers muss vom Gerät aus erreichbar sein.
3. Das Gerät verbindet sich mit dem Anhangsserver und sendet Nachricht 1210. Der Server sendet eine allgemeine Antwort.
4. Das Gerät sendet Nachricht 1211 zusammen mit dem Anhangsdatenstrom. Der Server antwortet nicht auf diese Nachricht.
5. Wenn die Datei vollständig ist, sendet das Gerät Nachricht 1212, und der Server antwortet mit 9212.
6. Anschließend lädt das Gerät den nächsten Anhang hoch, beginnend wieder beim Verbindungsschritt.

Wenn Alarme ohne Bilder oder Video eintreffen, empfiehlt die Dokumentation, im Gateway-Log die Sequenz 0200 vom Gerät, 8001 von der Plattform, 9208 von der Plattform und 0001 vom Gerät zu prüfen und dann zu kontrollieren, ob die Datei den Speicherserver erreicht hat. Ein Log-Parsing-Tool für 808- und 1078-Nachrichten wird bereitgestellt.

Alarmtypen und Protokollvarianten. Die Plattform listet die unterstützten Aktive-Sicherheit-Protokolltypen im Geräteinformationsformular unter Operations, Device information, Add, Protocol type auf. Die Dokumentation enthält Alarm-ID-Listen für mehrere chinesische Provinz- und lokale Aktive-Sicherheit-Standards (Jiangsu, Sichuan, Guangxi, Jilin, Jiangxi, Shaanxi, Shanghai, Yingkou, Chongqing und Zhejiang). Sobald für ein Fahrzeug ein Aktive-Sicherheit-Protokolltyp ausgewählt ist, kann die Plattform ADAS- und DSM-Alarmparameter über das Menü Active Safety Settings an das Gerät senden. Die von der Plattform angezeigten Alarmtypen sind konfigurierbar, und nicht angehakte Typen werden nicht ausgewertet.

Zusätzliche Alarme bei JT/T 808. Basierend auf einem Gruppenstandard aus Sichuan unterstützt die Plattform benutzerdefinierte Erweiterungen, die Kollisions-, Überschlag-, Start-, Stopp-, SOS- und I/O-Alarme melden:

Upload von Videoaufzeichnungen (nur JT/T 1078). Ein Benutzer kann die Plattform auffordern, eine Aufzeichnung per FTP vom Gerät abzurufen. Die Plattform sendet Nachricht 9206, das Gerät antwortet mit einer allgemeinen Antwort und beginnt mit dem Upload, und meldet Nachricht 1206, wenn der Upload abgeschlossen ist. Dies funktioniert nur bei JT/T 1078-Geräten, und der FTP-Server muss aus dem Internet erreichbar sein.

Privates Protokoll: Was ein Gerät implementiert

Für Geräte, die das private Protokoll verwenden, enthält die Dokumentation geräteseitige Codebeispiele für diese Aufgaben:

• Alarm mit Bildern oder Video. Das Gerät meldet zuerst den Alarm und behält die Alarmnummer. Anschließend lädt es jede Datei mit dieser Alarmnummer hoch. Dateitypen sind JPEG-Bilder, Aufzeichnungen und Audio. Eine Video- oder Audiodatei benötigt ihre Länge. Ein Bild hat die Länge 0.
• Videoformat. Das Gerät deklariert seinen Video-Encoder beim Start. Verschiedene Kanäle können unterschiedliche Formate verwenden, zum Beispiel H.264 auf einem Kanal und H.265 auf einem anderen. Bei H.265 muss jedem I-Frame der VPS, SPS und PPS vorangestellt sein.
• Remote-Upgrade. Der Client lädt eine Upgrade-Datei auf den Server hoch, und der Server sendet sie an das Gerät. Nur Online-Geräte können aktualisiert werden. Das Gerät prüft die Version, empfängt und verifiziert die Datei und führt das Upgrade nach einem Neustart durch. Die Dokumentation empfiehlt, dass Geräte auch ohne Speicherkarte aktualisieren können.
• Parametereinstellungen. Die Dokumentation empfiehlt die Verwendung der von der Plattform bereitgestellten Web-Einstellungsseite, die sowohl der PC-Client als auch der Webclient laden.
• Weitere dokumentierte Themen. Audioformat-Integration, Gerätelog-Download, Fahrgastzähldaten, Gerätezeitabgleich und Geräte, die Mediendateien selbstständig hochladen.

Was nicht in der Dokumentation steht. Es gibt keine öffentliche Beschreibung, wie die AlwayCare-Fahrerüberwachungssoftware auf einem kundeneigenen Steuergerät oder SoC ausgeführt wird. Die Dokumentation listet keine unterstützten Chips oder Betriebssysteme, Speicher-, Flash- oder Prozessoranforderungen, Kamerakombinationen oder einen Evaluierungsprozess auf. Wenn Sie die Erkennung in Ihre eigene Hardware integrieren möchten, senden Sie die Fragen Ihrer Ingenieure über das Anfrageformular mit Angabe von SoC, Betriebssystem, Kamerasensoren, Speicher und Flash sowie den benötigten Funktionen. Unsere Ingenieure werden die Anfrage bewerten.

Was Sie vor der Integration klären sollten

1. Prüfen Sie, ob Ihr Gerätemodell und Ihre Firmware sich über JT/T 808 und JT/T 1078 verbinden (siehe Checkliste oben).
2. Finden Sie heraus, ob jede Kamera H.264 oder H.265 sendet, und wählen Sie den Weg, der dies unterstützt.
3. Listen Sie die benötigten Kanäle auf und ob Sie den Hauptstream oder den Substream benötigen.
4. Entscheiden Sie, wo CMSV6 läuft. Die Plattformlizenzierung ist in den Standardkomponenten aufgeführt, aber die Kosten für die Plattformsoftware sind nicht in einem Angebot enthalten. Dedizierte Flotten-Server-Bereitstellung, kundenspezifische API-Integration und selbst gehostete Plattformlizenzen sind nach einer technischen Abstimmung mit unseren Ingenieuren verfügbar.
5. Wenn Sie Ihr eigenes Gerät entwickeln, wählen Sie die Standardprotokolle oder das private Protokoll, legen Sie Serveradresse, Port und Geräte-ID fest und testen Sie den Alarm- und Anhangsablauf mit dem Gateway-Log.
6. Verwenden Sie die Adresse und das Konto Ihrer eigenen Bereitstellung. Die Beispiele in der Dokumentation verwenden Demo-Serveradressen und Beispielkonten.

Wenn Sie zwischen der direkten Anbindung einer Kamera an Ihre Plattform und der Nutzung von CMSV6 abwägen, vergleicht Integrating AI Dashcams with Your Existing Telematics Platform die Integrationswege. Zu übergreifenden Datenverbindungsrisiken lesen Sie Fleet Data Silos.

Wo Sie die vollständige Dokumentation finden

Das CMSV6-Help-Center unter docs.alwaycare.com ist auf Englisch und Chinesisch verfügbar. Beginnen Sie mit den Abschnitten HTTP API, Video protocol integration und Web video integration. Die Plattform selbst wird auf der CMSV6-Plattformseite beschrieben.

Fragen zur CMSV6-Integration

Senden Sie den Namen Ihrer Plattform, die Geräte, die Sie anbinden möchten, und den bevorzugten Integrationsweg über das Anfrageformular, und unsere Ingenieure bestätigen, was zutrifft.

Für Flottenmanagement-, Tracking- und Videoplattform-Optionen an einem Ort siehe die Flottenmanagement-Lösung.