Aperçu de la signalisation

• Vue d'ensemble
• Web
• iOS
• iOS (Swift)
• Android
• Fenêtres
• macOS
• Linux
• React Native
• REST

Utilisez l'API de signalisation OpenTok pour échanger du texte et des données entre les clients connectés à une session OpenTok.

Ces messages permettent aux développeurs de mettre en place un chat textuel basique, d'envoyer des instructions d'un client à un autre et de créer d'autres expériences utiles.

Les SDK client OpenTok comprennent des méthodes permettant d'envoyer des signaux aux clients connectés à une session OpenTok . Ils incluent également des événements déclenchés lorsqu'un signal est reçu. Pour plus de détails, consultez le guide de développement sur la signalisation pour OpenTok.js, iOS, Androidet Fenêtres, macOS, et Linux. Vous pouvez également utiliser le API REST OpenTok pour envoyer des signaux du serveur aux clients.

Charges utiles des signaux

Chaque signal contient data et type qui sont toutes deux des chaînes de caractères :

• data — Contient les informations principales à transmettre dans le signal

• type — Un champ secondaire que vous pouvez utiliser pour regrouper et filtrer les signaux.

Un client peut également envoyer un signal sans data ou type défini. Ce signal « ping » permettra uniquement d'identifier l'expéditeur du signal.

Le signal comporte également une propriété qui identifie le client à l'origine de l'envoi du signal.

Vous pouvez envoyer un signal à un client spécifique ou à tous les clients connectés à une session.

Distribution du signal

Pour un client connecté à une session OpenTok, le Client SDK OpenTok déclenche un événement lorsque le client reçoit un signal. Cependant, il n'existe aucun événement sur le client émetteur indiquant que le ou les destinataires ont bien reçu un signal. Si votre application l'exige, vous pouvez utiliser l' API de signalisation pour renvoyer des accusés de réception au client émetteur.

Le serveur OpenTok relaie les signaux émis par le client émetteur vers les clients récepteurs. Le signal est transmis via des connexions WebSocket basées sur le protocole TCP entre les clients et le serveur OpenTok. La transmission du signal n’est pas strictement garantie, mais la signalisation exploite les capacités de retransmission de paquets inhérentes au protocole TCP.

L'ordre des événements de signal est préservé pour les signaux envoyés par un client émetteur, mais pas entre tous les clients. Prenons par exemple une session dans laquelle le client A envoie les signaux 1 et 2 à tous les clients de la session, et le client B envoie les signaux 3 et 4 à tous les clients de la session. Le signal 1 sera reçu avant le signal 2, et le signal 3 sera reçu avant le signal 4. Mais rien ne garantit que les signaux du client A seront reçus avant ceux du client B.

La fonctionnalité de signalisation est disponible pour tous les clients OpenTok. La signalisation permet pas exiger que le Routeur multimédia OpenTok — il est disponible dans toutes les sessions (acheminées ou relayées).