Señalización

Utiliza la API de señalización para enviar texto y datos entre clientes conectados a una sesión.

Estos mensajes permiten a los desarrolladores construir un chat de texto básico, enviar instrucciones de un cliente a otro y crear otras experiencias valiosas.

Los SDK de cliente incluyen métodos para enviar señales a los clientes conectados a una sesión. También incluyen eventos que se envían cuando se recibe una señal.

Véase el tutoriales de señalización para aprender a enviar y recibir señales. También puedes utilizar el API REST para enviar señales del servidor a los clientes.

Carga útil de las señales

Cada señal contiene data y type que son cadenas:

• data - Contiene la información principal que se enviará en la señal. Una cadena. La longitud máxima es de 128 bytes y sólo debe contener letras (A-Z y a-z), números (0-9), '-', '_' y '~'.
• type - Campo secundario que puede utilizar para agrupar y filtrar señales. La longitud máxima es de 8kb.

Un cliente también puede enviar una señal sin data o type definida. Esta señal ping sólo identificará al emisor de la señal. La señal también incluye una propiedad que identifica al cliente que envió la señal. Puede enviar una señal a un cliente específico o a todos los clientes conectados a una sesión.

Envío de señales

Para un cliente conectado a una sesión, el Client SDK envía un evento cuando el cliente recibe una señal. Sin embargo, no hay ningún evento en el cliente emisor que indique que el destinatario ha recibido una señal. Si su aplicación lo requiere, puede utilizar la API de señalización para enviar acuses de recibo al cliente emisor.

El servidor de video de Vonage retransmite las señales del cliente emisor a los clientes receptores. La señal se envía mediante conexiones WebSocket basadas en TCP entre los clientes y el servidor de video de Vonage. La entrega de la señal no está estrictamente garantizada, pero la señalización utiliza las capacidades de retransmisión de paquetes inherentes a TCP.

El orden de los eventos de señal se conserva para las señales enviadas desde un cliente de señal, pero no en todos los clientes. Por ejemplo, considere una sesión en la que cliente A envía las señales 1 y 2 a todos los clientes de la sesión, y cliente B envía las señales 3 y 4 a todos los clientes de la sesión. La señal 1 se recibirá antes que la señal 2, y la señal 3 se recibirá antes que la señal 4. Pero no hay garantía de que del cliente A señales se recibirán antes de del cliente B señales.

Véase el tutoriales de señalización para aprender a enviar y recibir señales.