Langsung ke konten utama
@capgo/capacitor-twilio-video Komunikasi Open source

Twilio Video plugin Capacitor

Bergabung ke room Twilio Video dari Capacitor dengan audio native, kamera, dan event lifecycle room

Instal

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

Panduan

Cara menggunakan Twilio Video di Capacitor

Menggunakan @capgo/capacitor-twilio-video

Capacitor API untuk bergabung ke room Twilio Video dengan antarmuka panggilan native dalam aplikasi.

Instal

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

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

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

Sekilas tentang API

Metode Deskripsi
login Simpan dan validasi access token Twilio Video yang dibuat oleh backend Anda.
logout Hapus access token yang di-cache dan keluar dari room aktif.
isLoggedIn Cek apakah token Twilio yang valid sedang tersimpan di cache perangkat.
joinRoom Gabung ke room Twilio dan tampilkan overlay panggilan native in-app plugin.
leaveRoom Keluar dari room saat ini jika sedang terhubung.
setMicrophoneEnabled Aktifkan/nonaktifkan publikasi mikrofon lokal.
setCameraEnabled Aktifkan/nonaktifkan publikasi kamera lokal.
getCallStatus Kembalikan nama room, status media, dan jumlah partisipan saat ini.
checkMicrophonePermission Cek status izin mikrofon.
requestMicrophonePermission Minta izin akses mikrofon.
checkCameraPermission Periksa status izin kamera.
requestCameraPermission Request camera permission.

Contoh

login()

Simpan dan validasi access token Twilio Video yang dibuat oleh backend Anda.

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

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

logout()

Hapus access token yang di-cache dan keluar dari room aktif.

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

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

isLoggedIn()

Cek apakah token Twilio yang valid sedang tersimpan di cache perangkat.

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

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

joinRoom()

Gabung ke room Twilio dan tampilkan overlay panggilan native in-app plugin.

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

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

leaveRoom()

Keluar dari room saat ini jika sedang terhubung.

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

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

setMicrophoneEnabled()

Aktifkan/nonaktifkan publikasi mikrofon lokal.

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

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

Tabel di atas mencantumkan 12 metode inti. Dokumentasi mengenai helper Listener, version, serta kontrak lengkap dari setiap metode tersedia di repositori GitHub.

Mendengarkan event

addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau CapacitorTwilioVideo.removeAllListeners() untuk menghapus semua listener.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-twilio-video

Jika Anda menggunakan Menggunakan @capgo/capacitor-twilio-video untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan @capgo/capacitor-twilio-video untuk detail implementasi di @capgo/capacitor-twilio-video, Panduan Memulai untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, dan Menggunakan @capgo/capacitor-video-player untuk kapabilitas native saat menggunakan @capgo/capacitor-video-player.

FAQ

FAQ plugin Twilio Video

Bagaimana cara menginstal plugin Twilio Video di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-twilio-video" (atau "npm install @capgo/capacitor-twilio-video"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mengambil code native. Impor dari "@capgo/capacitor-twilio-video" di code aplikasi Anda.

Apakah @capgo/capacitor-twilio-video bekerja dengan React, Vue, dan Angular?

Ya. Twilio Video adalah paket Capacitor, jadi berfungsi dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung @capgo/capacitor-twilio-video?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-twilio-video gratis dan open source?

Ya. Kode sumber code publik di GitHub pada https://github.com/Cap-go/capacitor-twilio-video/ dan paketnya gratis diinstal dari npm. Laporan bug dan pull request diterima.

Bisakah saya memperbarui code yang menggunakan Twilio Video tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Twilio Video tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo