Ενσωμάτωση με το Web SDK
Το Web SDK χειρίζεται την απόδοση βίντεο, ήχου και τον κύκλο ζωής της συνεδρίας. Λειτουργεί με React, Vue, Angular, και καθαρή (vanilla) JavaScript.
1. Εγκαταστήστε το SDK
npm install @touchcastllc/napster-companion-api @reduxjs/toolkit
2. Αποκτήστε ένα Token Συνεδρίας (server-side)
Πρώτα δημιουργήστε το Omniagent σας μέσω POST /public/agents, αν δεν το έχετε κάνει ήδη. Στη συνέχεια, καλέστε το POST /public/agents/{agentId}/connections με το αναγνωριστικό του πράκτορά σας για να δημιουργήσετε μια συνεδρία. Η απόκριση περιλαμβάνει ένα token — μεταβιβάστε το με ασφάλεια στον πελάτη (client). Ποτέ μη δημιουργείτε tokens συνεδρίας μέσα στον κώδικα του πελάτη.
3. Αρχικοποίηση στο React
Εισαγάγετε το NapsterCompanionApiSdk, δημιουργήστε ένα ref container, και καλέστε το NapsterCompanionApiSdk.init(token, { mountContainer: containerRef.current, position: "bottom-right" }) μέσα σε ένα useEffect. Καλέστε το instance.destroy() κατά τον καθαρισμό (cleanup).
Σημαντικό: Δημιουργείτε πάντα ένα νέο instance σε κάθε φόρτωση σελίδας — τα tokens είναι μίας χρήσης και βραχύβια. Η επαναχρησιμοποίηση ενός αποθηκευμένου token θα προκαλέσει αποτυχία της σύνδεσης WebSocket κατά την επαναφόρτωση.
Συμβουλή: Παραδείγματα για Vue, Angular, και vanilla JS είναι διαθέσιμα στα Έγγραφα WebRTC. Δημιουργείτε πάντα το token συνεδρίας στο backend σας — ποτέ σε κώδικα πελάτη (client-side).