Guía
Cómo usar Twilio Voice en Capacitor
Usando @capgo/capacitor-twilio-voice
Integra el SDK de voz de Twilio en Capacitor.
Instalar
bun add @capgo/capacitor-twilio-voice
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Correlo de nuevo después de cada actualización del plugin.
Importar
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
Vista general de API
| Metodo | Descripción |
|---|---|
login |
Autenticar al usuario con Twilio Voice utilizando un token de acceso. |
logout |
Desconectar al usuario actual y desregistrarse de Twilio Voice. |
isLoggedIn |
Comprobar si el usuario está actualmente conectado y tiene un token de acceso válido. |
makeCall |
Iniciar una llamada saliente a un número de teléfono o cliente. |
acceptCall |
Aceptar una llamada entrante. |
rejectCall |
Rechazar una llamada entrante. |
endCall |
Finalizar una llamada activa. |
muteCall |
Activar o desactivar el micrófono durante una llamada activa. |
setSpeaker |
Habilitar o deshabilitar el modo altavoz. |
getCallStatus |
Obtener el estado actual de la llamada activa. |
checkMicrophonePermission |
Comprobar si se ha concedido permiso para el micrófono. |
requestMicrophonePermission |
Pida permiso para utilizar el micrófono al usuario. |
Ejemplos
login()
Autentique al usuario con Twilio Voice utilizando un token de acceso.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const result = await CapacitorTwilioVoice.login({
accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
});
console.log('Login successful:', result.success);
logout()
Cerrar sesión del usuario actual y desregistrarse de Twilio Voice.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const result = await CapacitorTwilioVoice.logout();
console.log('Logout successful:', result.success);
isLoggedIn()
Verificar si el usuario está actualmente conectado y tiene un token de acceso válido.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
const status = await CapacitorTwilioVoice.isLoggedIn();
if (status.isLoggedIn && status.hasValidToken) {
console.log('User identity:', status.identity);
} else {
// Re-authenticate the user
}
makeCall()
Iniciar una llamada saliente a un número de teléfono o cliente.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
// Call a phone number
const result = await CapacitorTwilioVoice.makeCall({
to: '+1234567890'
});
console.log('Call SID:', result.callSid);
// Call another Twilio client with a readable name for CallKit Recents
await CapacitorTwilioVoice.makeCall({
to: 'client:alice',
displayName: 'Alice Smith'
});
// Call a PSTN number using a specific caller ID
await CapacitorTwilioVoice.makeCall({
to: '+1234567890',
callerId: '+10987654321'
});
acceptCall()
Aceptar una llamada entrante.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
CapacitorTwilioVoice.addListener('callInviteReceived', async (data) => {
console.log('Incoming call from:', data.from);
const result = await CapacitorTwilioVoice.acceptCall({
callSid: data.callSid
});
console.log('Call accepted:', result.success);
});
rejectCall()
Rechazar una llamada entrante.
import { CapacitorTwilioVoice } from '@capgo/capacitor-twilio-voice';
CapacitorTwilioVoice.addListener('callInviteReceived', async (data) => {
if (shouldRejectCall(data.from)) {
await CapacitorTwilioVoice.rejectCall({
callSid: data.callSid
});
}
});
La tabla anterior muestra los 12 métodos básicos. Los ayudantes de escucha y versión, y el contrato completo de cada método, se documentan en el repositorio de GitHub.
Escuchar eventos
addListener devuelve un manejador. Llame handle.remove() cuando la pantalla se desmonta, o CapacitorTwilioVoice.removeAllListeners() para eliminar todos los oyentes.
Referencia completa
Sigue adelante desde Usando @capgo/capacitor-twilio-voice
Si estás utilizando Usando @capgo/capacitor-twilio-voice para planificar el trabajo de plugin nativo, conectarlo con @capgo/capacitor-voz-twilio para los detalles de implementación en @capgo/capacitor-twilio-voice Configuración Inicial para los detalles de implementación en Configuración Inicial, Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para los detalles de implementación en Capacitor Plugins por Capgo, y Agregar o Actualizar Plugins para los detalles de implementación en Agregar o Actualizar Plugins.