@capgo/capacitor-twilio-voice

개요

Capacitor Twilio 음성 플러그인은 Twilio의 음성 API을 사용하여 iOS 및 Android 애플리케이션에서 고품질 VoIP 통화 기능을 활성화합니다. 이 플러그인은 전문적인 통화 경험을 만들기 위한 포괄적인 통화 관리, 인증 및 오디오 제어 기능을 제공합니다.

VoIP 통화

Twilio 음성 API을 사용하여 인터넷을 통한 고품질 음성 통화 📞

통화 관리

전체 수명 주기 제어를 통해 전화 걸기, 수락, 거부 및 종료 🎛️

오디오 컨트롤

음소거, 스피커 전환 및 오디오 라우팅 옵션 🎤

플랫폼 지원

푸시 알림을 사용한 기본 iOS 및 Android 구현 📱

설치

npm install @capgo/capacitor-twilio-voice
npx cap sync

핵심 API 메서드

인증

• login(options: { accessToken: string }) - 액세스 토큰을 사용하여 Twilio로 인증합니다.
• logout() - 사용자 세션 종료 및 통화 상태 지우기
• isLoggedIn() - 현재 인증 상태 확인

통화 관리

• makeCall(options: { to: string }) - 지정된 번호로 발신 통화 시작
• acceptCall(options: { callSid: string }) - 수신 전화 수락
• rejectCall(options: { callSid: string }) - 수신 전화 거부
• endCall(options?: { callSid?: string }) - 활성 통화 종료
• muteCall(options: { muted: boolean, callSid?: string }) - 통화 오디오 음소거/음소거 해제
• setSpeaker(options: { enabled: boolean }) - 스피커 출력 전환

이벤트 리스너

플러그인은 다음에 대한 포괄적인 이벤트 처리를 제공합니다.

• 연결 상태 등록 이벤트
• 통화 상태 변경(연결됨, 연결 끊김, 벨 울림)
• 품질 경고 및 연결 문제
• 수신 전화 알림

플랫폼 구성

iOS 설정

• 수신 전화에 대해 PushKit 통합이 필요합니다.
• 프로덕션용 인증서 구성
• Info.plist의 마이크 권한

Android 설정

• 푸시 알림을 위한 Firebase 설정
• AndroidManifest.xml의 마이크 권한
• 백그라운드 서비스 구성

빠른 시작 예

import { TwilioVoice } from '@capgo/capacitor-twilio-voice';

// Authenticate with Twilio
await TwilioVoice.login({ accessToken: 'your-twilio-access-token' });

// Make a call
await TwilioVoice.makeCall({ to: '+1234567890' });

// Listen for call events
TwilioVoice.addListener('callConnected', (data) => {
  console.log('Call connected:', data);
});

문서

자세한 설정 지침, 고급 구성 및 통합 예시는 전체 문서를 확인하세요.