Aller au contenu principal
@capgo/capacitor-twilio-video Communication Open source

Twilio Video Plugin Capacitor

Rejoignez des salons Twilio Video depuis Capacitor avec audio natif, caméra et événements de cycle de vie

Installer

bun add @capgo/capacitor-twilio-video bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-twilio-video
  • pnpm add @capgo/capacitor-twilio-video
  • yarn add @capgo/capacitor-twilio-video

Guide

Comment utiliser Twilio Video dans Capacitor

Utiliser @capgo/capacitor-twilio-video

Capacitor API pour rejoindre des rooms Twilio Video avec une interface d'appel native dans l'app.

Installer

bun add @capgo/capacitor-twilio-video
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';

Aperçu de API

Méthode Description
login Stockez et validez un token d'accès Twilio Video généré par votre backend.
logout Effacez le token d'accès en cache et quittez la room active.
isLoggedIn Vérifiez si un token Twilio valide est actuellement en cache sur l'appareil.
joinRoom Rejoignez une room Twilio et affichez l'overlay d'appel natif du plugin.
leaveRoom Quittez la room actuelle si vous êtes connecté.
setMicrophoneEnabled Activer/désactiver la diffusion du micro local.
setCameraEnabled Activer/désactiver la diffusion de la caméra locale.
getCallStatus Récupérez le nom de la room, l'état des médias et le nombre de participants.
checkMicrophonePermission Vérifiez l'état des permissions du micro.
requestMicrophonePermission Demander la permission d'utiliser le microphone.
checkCameraPermission Vérifier l'état de l'autorisation de la caméra.
requestCameraPermission Demander la permission d'utiliser la caméra.

Exemples

login()

Stockez et validez un token d'accès Twilio Video généré par votre backend.

import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';

const result = await CapacitorTwilioVideo.login({ accessToken: 'access-token-123' });
console.log(result);

logout()

Effacez le token d'accès en cache et quittez la room active.

import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';

const result = await CapacitorTwilioVideo.logout();
console.log(result);

isLoggedIn()

Vérifiez si un token Twilio valide est actuellement en cache sur l'appareil.

import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';

const result = await CapacitorTwilioVideo.isLoggedIn();
// The result holds sensitive values: use it without logging it.

joinRoom()

Rejoignez une room Twilio et affichez l'overlay d'appel natif du plugin.

import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';

const result = await CapacitorTwilioVideo.joinRoom({ roomName: 'room' });
console.log(result);

leaveRoom()

Quittez la room actuelle si vous êtes connecté.

import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';

const result = await CapacitorTwilioVideo.leaveRoom();
console.log(result);

setMicrophoneEnabled()

Activer/désactiver la diffusion du micro local.

import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';

const result = await CapacitorTwilioVideo.setMicrophoneEnabled({ enabled: true });
console.log(result);

Le tableau ci-dessus liste les 12 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou CapacitorTwilioVideo.removeAllListeners() pour supprimer tous les listeners.

Référence complète

Continuer à partir de « Utiliser @capgo/capacitor-twilio-video »

Si vous utilisez Utiliser @capgo/capacitor-twilio-video pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-twilio-video pour le détail d’implémentation dans @capgo/capacitor-twilio-video, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.

FAQ

FAQ du plugin Twilio Video

Comment installer le plugin Twilio Video dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-twilio-video » (ou « npm install @capgo/capacitor-twilio-video »), puis « bunx cap sync » pour que les projets iOS et Android récupèrent le code natif code. Importez-le depuis « @capgo/capacitor-twilio-video » dans votre code code.

Est-ce que @capgo/capacitor-twilio-video fonctionne avec React, Vue et Angular ?

Oui. Twilio Video est un package Capacitor, il fonctionne donc avec n’importe quel framework web exécuté dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor @capgo/capacitor-twilio-video prend-il en charge ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

@capgo/capacitor-twilio-video est-il gratuit et open source ?

Oui. Le code source code est public sur GitHub à l’adresse https://github.com/Cap-go/capacitor-twilio-video/ et le package est gratuit à installer depuis npm. Les signalements de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code qui utilise Twilio Video sans passer par une revue de l’App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Publiez les modifications Twilio Video sans attendre la revue de l'application

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo