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 valores, ambos de tipo cadena:

• 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 — Un campo secundario que puedes utilizar para agrupar y filtrar señales. La longitud máxima es de 8 kb.

Un cliente también puede enviar una señal sin data o type definida. Esta señal «ping» solo identificará al remitente de la señal. La señal también incluye una propiedad que identifica al cliente que la ha enviado. Puedes enviar una señal a un cliente concreto o a todos los clientes conectados a una sesión.

Envío de señales

En el caso de un cliente conectado a una sesión, el Client SDK genera un evento cuando el cliente recibe una señal. Sin embargo, no existe ningún evento en el cliente emisor que indique que el destinatario o destinatarios hayan recibido la señal. Si tu aplicación lo requiere, puedes utilizar la API de señalización para enviar confirmaciones de recepción 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.