Référence SDK

Vue d'ensemble SDK

Présentation de tous les modules disponibles dans le SDK OndesBridge.

Le SDK OndesBridge permet à votre code JavaScript de communiquer avec les fonctionnalités natives de l'appareil. Il est injecté automatiquement dans l'objet global window.Ondes.

Initialisation

Important

L'objet Ondes n'est pas disponible immédiatement au chargement de la page. Vous devez écouter l'événement OndesReady.

class=class="code-string">"code-comment">// ✅ RECOMMANDÉ
document.addEventListener(class=class="code-string">"code-string">'OndesReady', () => {
    console.log(class="code-string">"SDK chargé et prêt à lclass="code-stringclass="code-string">">'emploi");
    initApp();
});

class=class="code-string">"code-comment">// ❌ À ÉVITER — peut échouer si le bridge n'est pas encore injecté
console.log(Ondes.User.getProfile());

Modules disponibles

Module	Description
`Ondes.UI`	Gestion de l'interface (Toasts, Modales, Navigation).
`Ondes.User`	Informations sur l'utilisateur connecté.
`Ondes.Device`	Accès matériel (Vibration, GPS, Caméra).
`Ondes.Storage`	Stockage de données persistant et isolé.
`Ondes.App`	Infos sur l'application et cycle de vie.
`Ondes.Friends`	Gestion des amis et du graphe social.
`Ondes.Social`	Réseau social (Feed, Posts, Stories, Follow).
`Ondes.Chat`	Messagerie instantanée avec chiffrement E2EE automatique.
`Ondes.Websocket`	Connexions WebSocket temps réel.
`Ondes.UDP`	Sockets UDP pour découverte réseau et communication.

Gestion des erreurs

Toutes les méthodes du SDK sont asynchrones et retournent des Promise. Utilisez try/catch pour gérer les erreurs proprement.

Code	Description
`PERMISSION_DENIED`	L'utilisateur a refusé la permission demandée.
`NOT_SUPPORTED`	La fonctionnalité n'est pas disponible sur cet appareil.
`CANCELLED`	L'utilisateur a annulé l'action (ex: scan QR code).
`NETWORK_ERROR`	Problème de connexion internet.
`AUTH_REQUIRED`	L'utilisateur doit être connecté.
`NOT_FOUND`	La ressource demandée n'existe pas.

async function safeAction() {
    try {
        const result = await Ondes.Device.scanQRCode();
        console.log(class="code-string">"Résultat:", result);
    } catch (error) {
        if (error.code === class=class="code-string">"code-string">'PERMISSION_DENIED') {
            Ondes.UI.showToast({
                message: class="code-string">"Accès caméra refusé",
                type: class="code-string">"error"
            });
        }
    }
}

PrécédentPermissions Suivant Ondes.UI