API de la cámara corporal
La API de la cámara corporal Shelleyes 4G (S7P/S4) ofrece una interfaz de integración abierta que permite que plataformas, sistemas de software y aplicaciones de terceros se comuniquen con las cámaras corporales Shelleyes 4G.
La API de Body Camera ofrece una interfaz de comunicación segura entre las cámaras corporales 4G y las plataformas de terceros.
A través de esta API, los desarrolladores pueden integrar las cámaras corporales en sus propias plataformas, entre las que se incluyen:
- Sistemas de gestión de vídeo (VMS)
- Sistemas de gestión de pruebas digitales (DEMS)
- Plataformas de mando para la seguridad pública
- Aplicaciones de monitorización personalizadas
La API admite:
- Registro y gestión de dispositivos
- Control remoto de la cámara
- Seguimiento por GPS en tiempo real
- Transmisión en directo de vídeo y audio
La arquitectura de comunicaciones consta de tres canales de datos independientes:
| Canal de datos | Descripción |
|---|---|
| Datos de control | Registro de dispositivos, señal de actividad, supervisión del estado y comandos remotos |
| Datos GPS | Información de ubicación en tiempo real enviada desde el dispositivo |
| Datos de VÍDEO/AUDIO (RTMPS) | Transmisión de vídeo y audio en tiempo real |
Todos los canales de comunicación utilizan una transmisión segura con cifrado TLS.
Arquitectura de comunicación de la API
La cámara corporal se comunica con el servidor a través de canales de comunicación específicos.
| Canal de datos | Puerto del servidor | Protocolo |
|---|---|---|
| Datos de control | 1901 | TCP sobre TLS |
| Datos GPS | 7095 | TCP sobre TLS |
| Datos de VÍDEO/AUDIO (RTMPS) | 1935 | RTMPS |
El canal de transmisión de vídeo y audio utiliza RTMPS (RTMP sobre TLS), lo que permite una transmisión cifrada de contenidos multimedia en tiempo real entre la cámara corporal y el servidor.
1. Datos de control
Visión general
Los datos de control constituyen el principal canal de comunicación entre la cámara corporal y el servidor.
Se encarga de:
- Registro de dispositivos
- Comunicación por latidos cardíacos
- Ejecución remota de comandos
- Consulta del estado del dispositivo
- Respuesta al comando
La comunicación de control utiliza un protocolo ligero basado en JSON y requiere un ancho de banda mínimo.
Configuración de puertos
| Canal | Puerto del servidor | Puerto para cámara corporal |
|---|---|---|
| Datos de control | 1901 | 1902 |
Registro de dispositivos
Cuando la cámara corporal se conecta a la red, envía una solicitud de registro al servidor.
La información sobre la inscripción incluye:
| Campo | Descripción |
|---|---|
| IMEI | Número de identificación del dispositivo |
| DEVID | ID de dispositivo definido por el usuario |
| SW_VER | Versión del firmware |
| PROTO_VER | Versión del protocolo de comunicación |
| MARCA DE FECHA Y HORA | marca de tiempo UTC |
| AGENTID | Identificador de usuario/operador del dispositivo |
Una vez completado con éxito el registro, el servidor proporciona una clave de sesión que se utiliza para la autenticación de mensajes.
Latido
Tras el registro, el dispositivo envía periódicamente mensajes de «heartbeat» para mantener el estado de conexión.
La información sobre el latido cardíaco puede incluir:
- Nivel de batería
- Espacio de almacenamiento restante
- Intensidad de la señal de red
- Estado de la grabación
- Estado del GPS
Intervalo predeterminado del pulso de comprobación:
- Cada 3 segundos
Si el servidor no recibe mensajes de «heartbeat» durante 60 segundos, se puede considerar que el dispositivo está desconectado.
Comandos del mando a distancia
El servidor puede enviar comandos para controlar de forma remota la cámara corporal.
Entre los comandos compatibles se incluyen:
| Comando | Función |
|---|---|
| Iniciar la transmisión de vídeo | Iniciar la retransmisión de vídeo en directo |
| Detener la reproducción de vídeo | Detener la retransmisión en directo |
| Iniciar la grabación de vídeo | Iniciar grabación local |
| Detener la grabación de vídeo | Detener la grabación |
| Iniciar la carga de datos del GPS | Activar la subida de datos del GPS |
| Detener la carga de datos del GPS | Desactivar la transmisión de datos GPS |
| Hacer una foto | Capturar una imagen de forma remota |
| Vibrar | Activación de la vibración del dispositivo |
| Consultar el estado de la batería | Obtener información sobre la batería |
| Consultar el estado del dispositivo | Obtener el estado actual del dispositivo |
El dispositivo devuelve los resultados de la ejecución de los comandos a través del campo CTRLFB.
2. Datos GPS
Visión general
Los datos GPS proporcionan información de localización en tiempo real desde la cámara corporal al servidor.
El modo de comunicación del GPS es:
Cámara corporal → Servidor
La información del GPS se transmite a través de un canal de GPS independiente.
Configuración de puertos
| Canal | Puerto del servidor |
|---|---|
| Datos GPS | 7095 |
Frecuencia de envío de datos GPS
Cuando el GPS está activado:
- El dispositivo envía datos de GPS cada 2 segundos.
Los mensajes GPS se utilizan para:
MSGTYPE = 3y se transmiten únicamente a través del canal GPS.
Campos de datos GPS
El mensaje del GPS incluye:
| Campo | Descripción |
|---|---|
| LAT | Latitud |
| LON | Longitud |
| VELOCIDAD | Velocidad actual |
| ALTITUD | Altitud |
| TÍTULO | Dirección del movimiento |
| HDOP | Indicador de precisión del GPS |
| SAT_COUNT | Número de satélites |
| GPS_VÁLIDO | Estado de validez del GPS |
| MARCA DE FECHA Y HORA | marca de tiempo UTC |
3. Datos de VÍDEO/AUDIO (RTMPS)
Visión general
La API de VÍDEO/AUDIO permite la transmisión en tiempo real de vídeo y audio entre la cámara corporal y plataformas externas.
El protocolo de transmisión es:
RTMPS (RTMP sobre TLS)
Permite la transmisión segura de vídeo en directo para su integración con:
- Plataformas VMS
- Centros de mando
- Sistemas de supervisión
- Aplicaciones a medida
Configuración de puertos
| Canal | Puerto del servidor |
|---|---|
| Datos de VÍDEO/AUDIO (RTMPS) | 1935 |
Flujo de trabajo de la retransmisión en directo
El proceso de retransmisión en directo:
1. El servidor envía el comando «Iniciar transmisión de vídeo»
↓
2. La cámara corporal recibe CTRLMSG = 0
↓
3. La cámara inicia la transmisión RTMPS
↓
4. El servidor recibe la transmisión de vídeo y audio en directoFormato de flujo RTMPS
URL de la retransmisión:
rtmps://server_ip:1935/live/DEVID
La conexión de la transmisión está protegida mediante un control de acceso del lado del servidor, que solo permite las conexiones de dispositivos registrados.
Codificación de vídeo y audio
Vídeo
Códecs compatibles:
- H.264
- H.265
Audio
Códecs compatibles:
- AAC
Servidor multimedia recomendado:
SRS (Servidor sencillo en tiempo real)
SRS puede convertir flujos RTMPS a formatos compatibles con la web, tales como:
- HLS
- WebRTC
para la reproducción en el navegador.
Seguridad
Cifrado TLS
Todos los canales de comunicación son compatibles con TLS 1.2 o superior:
| Canal | Seguridad |
|---|---|
| Datos de control | TCP sobre TLS |
| Datos GPS | TCP sobre TLS |
| Datos de VÍDEO/AUDIO | RTMPS |
Control de acceso a flujos
El servicio de streaming utiliza un control de acceso basado en direcciones IP.
Mecanismo de seguridad:
- El servidor registra la dirección IP del dispositivo durante el registro.
- Solo las direcciones IP de los dispositivos registrados pueden establecer conexiones de transmisión
- El servidor verifica la identidad del dispositivo antes de aceptar las transmisiones
No se necesita ningún token de transmisión adicional.
Autenticación de mensajes
Uso de los mensajes de control y GPS:
HMAC-SHA256
Características de seguridad:
- Autenticación mediante clave de sesión
- Rotación de llaves cada 24 horas
- Protección contra la reproducción de SERIALNO
Flujo de trabajo de integración
Proceso de integración típico:
La cámara corporal se conecta a la red
↓
Registro del dispositivo
↓
Autenticación del servidor
↓
Comunicación de «heartbeat»
↓
Control remoto de comandos
↓
Carga de datos GPS / Transmisión en directo RTMPS
↓
Integración con plataformas de tercerosAplicaciones de integración compatibles
La API de Body Camera se puede integrar en:
Soluciones de software a medida
Plataformas VMS
Plataformas de seguridad pública
Sistemas de vigilancia de seguridad