Saltar al contenido principal
@capgo/capacitor-voice-twilio Comunicación Fuente abierta

Twilio Voice plugin de Capacitor

Hacer y recibir llamadas VoIP con Twilio Voice para funcionalidad de llamadas en aplicaciones

Instalar

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

Guía

Cómo usar Twilio Voice en Capacitor

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Vista previa del plugin de voz de Twilio code

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.

FAQ

Preguntas frecuentes del plugin Twilio Voice

¿Cómo instalo el plugin Twilio Voice en una aplicación Capacitor?

Ejecute "bun add @capgo/capacitor-twilio-voice" (o "npm install @capgo/capacitor-twilio-voice"), luego ejecute "bunx cap sync" para que los proyectos iOS y Android capturen el proyecto nativo code. Importe desde "@capgo/capacitor-twilio-voice" en la aplicación code.

¿Funciona @capgo/capacitor-twilio-voice con React, Vue y Angular?

Sí. Twilio Voice es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-twilio-voice?

Capgo plugins siguen la versión mayor de Capacitor: utilice la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-twilio-voice gratuito y de código abierto?

Sí. El código fuente de code está disponible en GitHub en https://github.com/Cap-go/capacitor-twilio-voice/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza Twilio Voice sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia el code nativo, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al plugin pueden enviar instantáneamente con Capgo actualizaciones en vivo.

Envíe cambios de voz de Twilio sin esperar la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Inicia con Capgo