Guida
Come usare Twilio Video in Capacitor
Utilizzo di @capgo/capacitor-twilio-video
Capacitor API per partecipare alle stanze di Twilio Video con un'interfaccia di chiamata nativa in-app.
Installa
bun add @capgo/capacitor-twilio-video
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
API in breve
| Metodo | Descrizione |
|---|---|
login |
Memorizza e valida un access token di Twilio Video generato dal tuo backend. |
logout |
Cancella l'access token in cache ed esci dalla room attiva. |
isLoggedIn |
Verifica se un token Twilio valido è attualmente in cache sul dispositivo. |
joinRoom |
Entra in una stanza Twilio e mostra l'overlay nativo per le chiamate in-app del plugin. |
leaveRoom |
Esci dalla room corrente se connesso. |
setMicrophoneEnabled |
Abilita/disabilita la pubblicazione del microfono locale. |
setCameraEnabled |
Abilita/disabilita la pubblicazione della camera locale. |
getCallStatus |
Restituisce il nome della room, lo stato dei media e il numero di partecipanti. |
checkMicrophonePermission |
Controlla lo stato dei permessi del microfono. |
requestMicrophonePermission |
Richiedi il permesso per il microfono. |
checkCameraPermission |
Controlla lo stato del permesso della fotocamera. |
requestCameraPermission |
Richiedi il permesso per la fotocamera. |
Esempi
login()
Memorizza e valida un access token di Twilio Video generato dal tuo backend.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.login({ accessToken: 'access-token-123' });
console.log(result);
logout()
Cancella l'access token in cache ed esci dalla room attiva.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.logout();
console.log(result);
isLoggedIn()
Verifica se un token Twilio valido è attualmente in cache sul dispositivo.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.isLoggedIn();
// The result holds sensitive values: use it without logging it.
joinRoom()
Entra in una room di Twilio e mostra l'overlay nativo della chiamata del plugin.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.joinRoom({ roomName: 'room' });
console.log(result);
leaveRoom()
Esci dalla room corrente se connesso.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.leaveRoom();
console.log(result);
setMicrophoneEnabled()
Abilita/disabilita la pubblicazione del microfono locale.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.setMicrophoneEnabled({ enabled: true });
console.log(result);
La tabella sopra elenca i 12 metodi principali. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o CapacitorTwilioVideo.removeAllListeners() per rimuovere tutti i listener.
Riferimento completo
Torna a Usare @capgo/capacitor-twilio-video
Se stai usando Usare @capgo/capacitor-twilio-video per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-twilio-video per i dettagli di implementazione in @capgo/capacitor-twilio-video, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.