가이드
Capacitor에서 Twilio Video 사용 방법
@capgo/capacitor-twilio-video 사용하기
네이티브 인앱 통화 UI로 Twilio Video 룸에 참여하기 위한 Capacitor API.
설치
bun add @capgo/capacitor-twilio-video
bunx cap sync
bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.
가져오기
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
API 한눈에 보기
| 메서드 | 설명 |
|---|---|
login |
백엔드에서 생성한 Twilio Video 액세스 토큰을 저장하고 검증합니다. |
logout |
캐시된 액세스 토큰을 삭제하고 활성 룸에서 나갑니다. |
isLoggedIn |
유효한 Twilio 토큰이 현재 디바이스에 캐시되어 있는지 확인합니다. |
joinRoom |
Twilio 룸에 참여하고 플러그인의 네이티브 인앱 통화 오버레이를 표시합니다. |
leaveRoom |
연결된 경우 현재 룸에서 나갑니다. |
setMicrophoneEnabled |
로컬 마이크 퍼블리싱을 활성화/비활성화합니다. |
setCameraEnabled |
로컬 카메라 퍼블리싱을 활성화/비활성화합니다. |
getCallStatus |
현재 룸 이름, 미디어 상태 및 참여자 수를 반환합니다. |
checkMicrophonePermission |
마이크 권한 상태를 확인합니다. |
requestMicrophonePermission |
마이크 권한을 요청합니다. |
checkCameraPermission |
카메라 권한 상태를 확인합니다. |
requestCameraPermission |
카메라 권한을 요청합니다. |
예시
login()
백엔드에서 생성한 Twilio Video 액세스 토큰을 저장하고 검증합니다.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.login({ accessToken: 'access-token-123' });
console.log(result);
logout()
캐시된 액세스 토큰을 삭제하고 활성 룸에서 나갑니다.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.logout();
console.log(result);
isLoggedIn()
유효한 Twilio 토큰이 기기에 캐시되어 있는지 확인합니다.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.isLoggedIn();
// The result holds sensitive values: use it without logging it.
joinRoom()
Twilio 룸에 참여하고 플러그인의 네이티브 인앱 통화 오버레이를 표시합니다.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.joinRoom({ roomName: 'room' });
console.log(result);
leaveRoom()
연결된 경우 현재 룸에서 나갑니다.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.leaveRoom();
console.log(result);
setMicrophoneEnabled()
로컬 마이크 퍼블리싱을 활성화/비활성화합니다.
import { CapacitorTwilioVideo } from '@capgo/capacitor-twilio-video';
const result = await CapacitorTwilioVideo.setMicrophoneEnabled({ enabled: true });
console.log(result);
위 표에는 12개의 핵심 메서드가 나열되어 있습니다. Listener와 version 헬퍼, 각 메서드의 전체 계약은 다음 문서에 설명되어 있습니다: GitHub 리포지토리.
이벤트 수신
addListener 핸들을 반환합니다. 호출하세요 handle.remove() 화면이 언마운트될 때, 또는 CapacitorTwilioVideo.removeAllListeners() 모든 리스너를 해제하려면.
전체 레퍼런스
@capgo/capacitor-twilio-video 사용하기 다음 단계
사용 중이라면 @capgo/capacitor-twilio-video 사용하기 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-twilio-video @capgo/capacitor-twilio-video의 구현 세부 사항은 다음과 같습니다, 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항은, 그리고 @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player. 사용하기에서의 네이티브 기능은