API y vídeo de CMSV6: qué puede usar una plataforma de terceros

Guía de integración

Una plataforma de terceros puede usar CMSV6 de cuatro maneras: la API HTTP para datos y alarmas, direcciones de transmisión para el vídeo en directo, un plugin de reproductor web para navegadores y SDK para iOS y Android para aplicaciones. Hay un límite que conviene conocer pronto: las transmisiones en directo RTSP, HTTP-FLV, HLS y RTMP admiten solo H.264. El vídeo H.265 necesita el plugin de reproductor web.

Cómo llegan los dispositivos a CMSV6

Los dispositivos del vehículo se conectan a CMSV6 mediante JT/T 808 y JT/T 1078. JT/T 808 transporta los datos de posición y de alarmas. JT/T 1078 transporta el vídeo. Su plataforma no habla con el dispositivo: habla con CMSV6, que expone los datos. La lista de comprobación de Qué dispositivos se pueden conectar a CMSV6 explica cómo confirmar que un modelo de dispositivo puede conectarse. Las interfaces de cada modelo están en la página del producto y en su cotización.

Qué cubre la API HTTP

Se inicia sesión con una cuenta de CMSV6 y se recibe un número de sesión. Todas las demás llamadas lo usan. La sesión es válida durante 4 horas y se mantiene mientras sigan las llamadas. Un segundo inicio de sesión con la misma cuenta no cierra la primera sesión. La sesión lleva el rol y los permisos de vehículos de la cuenta, de modo que un usuario de la API solo ve los dispositivos que esa cuenta puede ver.

Las consultas de alarmas pueden devolver las coordenadas en formato WGS84 (el predeterminado), Google (GCJ-02) o Baidu (BD09), según un parámetro de la solicitud. Las búsquedas de alarmas toman una hora de inicio y de fin y cubren hasta 90 días por solicitud. La referencia completa está en la sección HTTP API del centro de ayuda.

Vídeo en directo: direcciones de transmisión

CMSV6 devuelve una dirección de vídeo en directo que otro reproductor o plataforma puede abrir. La dirección se forma con el número de sesión, el número de dispositivo, el canal (que se cuenta desde 0) y el tipo de transmisión (0 para la principal y 1 para la secundaria).

Si sus cámaras envían H.265, use el plugin de reproductor web que se describe más abajo para el vídeo en directo en un navegador. Las direcciones de transmisión anteriores admiten solo H.264. Los detalles están en la sección Video protocol integration.

Cómo integrar vídeo y mapas en su propia aplicación web o móvil

• Plugin de reproductor web. Un archivo JavaScript y un decodificador WebAssembly añaden vídeo en directo, reproducción, intercomunicación bidireccional y difusión a navegadores de PC y móviles. Admite H.264 y H.265. El archivo del decodificador debe estar en la raíz web de la página; de lo contrario, el vídeo puede quedarse en negro. Se incluye una guía de integración con Vue. Consulte Web video integration.
• Páginas web listas para usar. El servidor ofrece páginas de vídeo en directo y de reproducción remota de un solo vehículo. Se pasan parámetros en la dirección de la página, que es la vía más rápida cuando solo necesita un vehículo en pantalla.
• Integración de páginas web. El inicio de sesión sin contraseña, una página de posición en tiempo real y una de reproducción de recorridos se pueden abrir desde su propio sistema. Consulte Web page integration.
• SDK móvil. Los SDK nativos para iOS y Android cubren audio y vídeo en tiempo real, intercomunicación bidireccional, reproducción remota y búsqueda de dispositivos locales. Consulte Mobile SDK.

Qué vía usar

Para ver qué hace la plataforma en pantalla cuando llegan los datos, consulte la monitorización de vídeo en directo, la reproducción de recorridos y de vídeo y las reglas y la gestión de alarmas.

Si fabrica su propio dispositivo o ECU

La documentación de CMSV6 explica cómo informa un dispositivo a la plataforma. No describe cómo ejecutar el software de monitoreo del conductor de AlwayCare en el chip propio de un cliente. Ese límite se trata al final de esta sección.

Dos formas de conectar. Un dispositivo puede conectarse mediante los protocolos estándar JT/T 808 y JT/T 1078, o mediante el protocolo privado de CMSV6, que tiene su propia biblioteca de red para el dispositivo y su propia documentación.

Qué necesita un dispositivo para conectarse

• Tres ajustes en el dispositivo: la dirección IP pública o el dominio del servidor, el puerto de envío y el ID del dispositivo. El operador de la plataforma proporciona la dirección y el puerto. En los menús de dispositivos con protocolo privado que describe la documentación, el puerto predeterminado es 6608; use el puerto de su propia instalación.
• El ID del dispositivo debe coincidir con el de la plataforma. Los dispositivos JT/T suelen usar un número de dispositivo de 12 dígitos. Si es más corto, la plataforma añade ceros a la izquierda hasta completar 12 dígitos. El ID del dispositivo es lo único que usa la plataforma para reconocerlo.
• En la plataforma, añada el vehículo. Use Quick Add Vehicle (alta rápida de vehículo) e indique el ID del dispositivo, la matrícula, el tipo de terminal y la empresa. También puede abrir Unregistered Devices (dispositivos no registrados). Un dispositivo que aparece allí ya se ha conectado a la plataforma y puede añadirlo a un vehículo desde esa lista.
• Compruebe la red. Un dispositivo en una red restringida o dirigida solo puede enviar a un servidor fijo. Confirme que la red permite que el dispositivo llegue a su plataforma.

Envío de alarmas de monitoreo del conductor y ADAS con JT/T 808 y JT/T 1078

Cuando un dispositivo genera una alarma de seguridad activa (por ejemplo, una alerta de fatiga del conductor o de colisión frontal), puede adjuntar imágenes o vídeo. La plataforma solicita los adjuntos y el dispositivo los sube a un servidor de adjuntos. El orden es:

1. El dispositivo envía datos de posición (mensaje 0200) que contienen la alarma de seguridad activa y el número de adjuntos.
2. La puerta de enlace de la plataforma responde con una respuesta general y envía el mensaje 9208, que lleva la dirección y el puerto del servidor de adjuntos. El dispositivo responde con una respuesta general. El puerto del servidor de adjuntos debe ser accesible desde el dispositivo.
3. El dispositivo se conecta al servidor de adjuntos y envía el mensaje 1210. El servidor envía una respuesta general.
4. El dispositivo envía el mensaje 1211 junto con el flujo de datos del adjunto. El servidor no responde a este mensaje.
5. Cuando el archivo está completo, el dispositivo envía el mensaje 1212 y el servidor responde con 9212.
6. El dispositivo sube entonces el siguiente adjunto, empezando de nuevo desde el paso de conexión.

Si las alarmas llegan sin imágenes o vídeo, la documentación sugiere revisar en el registro de la puerta de enlace la secuencia 0200 del dispositivo, 8001 de la plataforma, 9208 de la plataforma y 0001 del dispositivo, y comprobar después que el archivo llegó al servidor de almacenamiento. Se ofrece una herramienta para analizar registros de mensajes 808 y 1078.

Tipos de alarma y variantes de protocolo. La plataforma enumera los tipos de protocolo de seguridad activa que admite en el formulario de información del dispositivo, en Operations, Device information, Add, Protocol type. La documentación incluye listas de ID de alarma de varios estándares provinciales y locales de China sobre seguridad activa (Jiangsu, Sichuan, Guangxi, Jilin, Jiangxi, Shaanxi, Shanghai, Yingkou, Chongqing y Zhejiang). Cuando se selecciona un tipo de protocolo de seguridad activa para un vehículo, la plataforma puede enviar al dispositivo los parámetros de alarmas ADAS y DSM desde el menú Active Safety Settings. Los tipos de alarma que muestra la plataforma son configurables, y los tipos que no están marcados no se analizan.

Alarmas adicionales en JT/T 808. Con base en un estándar de grupo de Sichuan, la plataforma admite extensiones definidas por el usuario que informan alarmas de colisión, vuelco, arranque, parada, SOS y E/S:

Subida de grabaciones de vídeo (solo JT/T 1078). Un usuario puede pedir a la plataforma que obtenga una grabación del dispositivo por FTP. La plataforma envía el mensaje 9206, el dispositivo responde con una respuesta general y empieza a subir, y notifica con el mensaje 1206 cuando termina la subida. Solo funciona con dispositivos JT/T 1078, y el servidor FTP debe ser accesible desde internet.

Protocolo privado: qué implementa un dispositivo

Para los dispositivos que usan el protocolo privado, la documentación ofrece ejemplos de código del lado del dispositivo para estas tareas:

• Alarma con imágenes o vídeo. El dispositivo informa primero de la alarma y conserva el número de alarma. Después sube cada archivo con ese número de alarma. Los tipos de archivo son imágenes JPEG, grabaciones y audio. Un archivo de vídeo o de audio necesita su duración. Una imagen tiene duración 0.
• Formato de vídeo. El dispositivo declara su codificador de vídeo al iniciarse. Distintos canales pueden usar formatos distintos, por ejemplo H.264 en un canal y H.265 en otro. Para H.265, cada fotograma I debe ir precedido de VPS, SPS y PPS.
• Actualización remota. El cliente sube un archivo de actualización al servidor y el servidor lo envía al dispositivo. Solo se pueden actualizar dispositivos en línea. El dispositivo comprueba la versión, recibe y verifica el archivo y actualiza después de reiniciarse. La documentación recomienda que los dispositivos también puedan actualizarse sin tarjeta de almacenamiento.
• Ajuste de parámetros. La documentación recomienda usar la página web de ajustes que ofrece la plataforma, que cargan tanto el cliente de PC como el cliente web.
• Otros temas documentados. Integración de formatos de audio, descarga de registros del dispositivo, datos de conteo de pasajeros, sincronización horaria del dispositivo y dispositivos que suben archivos multimedia por su cuenta.

Qué no está en la documentación. No hay una descripción pública de cómo ejecutar el software de monitoreo del conductor de AlwayCare en el ECU o el SoC propio de un cliente. La documentación no enumera chips ni sistemas operativos compatibles, requisitos de memoria, flash o procesador, combinaciones de cámaras ni un proceso de evaluación. Si piensa integrar la detección en su propio hardware, envíe las preguntas de sus ingenieros a través del formulario de consulta con el SoC, el sistema operativo, los sensores de cámara, la memoria y el flash, y las funciones que necesita. Nuestros ingenieros evaluarán la solicitud.

Qué confirmar antes de integrar

1. Compruebe que el modelo y el firmware de su dispositivo se conectan mediante JT/T 808 y JT/T 1078 (vea la lista de comprobación indicada arriba).
2. Averigüe si cada cámara envía H.264 o H.265 y elija la vía que lo admita.
3. Indique los canales que necesita y si necesita la transmisión principal o la secundaria.
4. Decida dónde se ejecuta CMSV6. La autorización de la plataforma figura entre los componentes estándar, pero el coste del software de la plataforma no está incluido en una cotización. La implementación de un servidor dedicado para la flota, la integración personalizada de la API y las licencias de plataforma autoalojada están disponibles tras una conversación técnica con nuestros ingenieros.
5. Si fabrica su propio dispositivo, elija entre los protocolos estándar y el protocolo privado, configure la dirección del servidor, el puerto y el ID del dispositivo, y pruebe el flujo de alarmas y adjuntos con el registro de la puerta de enlace.
6. Use la dirección y la cuenta de su propia instalación. Los ejemplos de la documentación usan direcciones de servidor de demostración y cuentas de ejemplo.

Si duda entre conectar una cámara directamente a su plataforma y usar CMSV6, Integración de dashcams con IA con su plataforma de telemática existente compara las vías de integración. Para conocer los riesgos más amplios de conectar datos, lea Silos de datos de la flota.

Dónde leer la documentación completa

El centro de ayuda de CMSV6 en docs.alwaycare.com está disponible en inglés y en chino. Empiece por las secciones HTTP API, Video protocol integration y Web video integration. La propia plataforma se describe en la página de la plataforma CMSV6.

Preguntas sobre la integración con CMSV6

Envíe el nombre de su plataforma, los dispositivos que piensa conectar y la vía de integración que prefiere a través del formulario de consulta, y nuestros ingenieros confirmarán lo que corresponde.

Para ver en un solo lugar el hardware de seguimiento, vídeo y seguridad del conductor, además de la plataforma CMS, consulte la solución de gestión de flotas.