Prise en main du Web SDK
Le Web SDK gère le rendu vidéo, l'audio et le cycle de vie de la session. Il fonctionne avec React, Vue, Angular et le JavaScript natif (vanilla JS).
1. Installez le SDK
npm install @touchcastllc/napster-companion-api @reduxjs/toolkit
2. Obtenez un jeton de session (côté serveur)
Commencez par créer votre Omniagent via POST /public/agents, si ce n'est pas déjà fait. Appelez ensuite POST /public/agents/{agentId}/connections avec l'identifiant de votre agent pour créer une session. La réponse contient un token : transmettez-le en toute sécurité au client. Ne générez jamais de jetons de session dans le code côté client.
3. Initialisation dans React
Importez NapsterCompanionApiSdk, créez une ref de conteneur, puis appelez NapsterCompanionApiSdk.init(token, { mountContainer: containerRef.current, position: "bottom-right" }) dans un useEffect. Appelez instance.destroy() pour le nettoyage.
Important :Générez toujours un nouveau jeton à chaque chargement de page — les jetons sont à usage unique et de courte durée. La réutilisation d'un jeton sauvegardé provoquera des échecs de connexion WebSocket lors du rechargement.
Astuce :Vous trouverez des exemples pour Vue, Angular et JavaScript natif dans la documentation WebRTC. Générez toujours le jeton de session sur votre backend — jamais dans le code côté client.