Aller au contenu principal
OndesOndes Core/ Docs

Référence SDK

Ondes.Websocket

Connexions WebSocket bidirectionnelles temps réel.

Le module Ondes.Websocket permet de créer et gérer des connexions WebSocket bidirectionnelles depuis vos mini-apps.

  • Connexions multiples simultanées
  • Auto-reconnexion optionnelle
  • Support texte et JSON
  • Timeout configurable

connect(url, options)

ParamètreTypeDescription
urlstringURL WebSocket (ws:// ou wss://)
options.reconnectbooleanAuto-reconnexion (défaut: false)
options.timeoutnumberTimeout en ms (défaut: 10000)
JS
const conn = await Ondes.Websocket.connect(class=class="code-string">"code-string">'wss:class=class="code-string">"code-comment">//mon-serveur.com/ws', {
    reconnect: true,
    timeout: 5000
});
class=class="code-string">"code-comment">// { id: class=class="code-string">"code-string">'ws_1234_1', url: class=class="code-string">"code-string">'wss://...', status: class=class="code-string">"code-string">'connected' }

send(connectionId, data)

JS
class=class="code-string">"code-comment">// Envoyer une chaîne
await Ondes.Websocket.send(conn.id, class=class="code-string">"code-string">'hello');

class=class="code-string">"code-comment">// Envoyer un objet JSON (automatiquement stringifié)
await Ondes.Websocket.send(conn.id, {
    type: class=class="code-string">"code-string">'command',
    action: class=class="code-string">"code-string">'move',
    speed: 50
});

onMessage(connectionId, callback)

JS
const unsubscribe = Ondes.Websocket.onMessage(conn.id, (message) => {
    console.log(class=class="code-string">"code-string">'Message reçu:', message);
});

class=class="code-string">"code-comment">// Se désabonner plus tard
unsubscribe();

disconnect(connectionId)

JS
await Ondes.Websocket.disconnect(conn.id);