Lebih lanjut ke konten utama
@capgo/capacitor-suara-twilio Komunikasi Sumber Terbuka

Suara Twilio Plugin Capacitor

Membuat dan menerima panggilan VoIP dengan Twilio Voice untuk fungsi panggilan dalam aplikasi

Install

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

Panduan

Cara menggunakan Suara Twilio di Capacitor

Uji di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Tautan QR pratinjau plugin Suara Twilio code

Menggunakan @capgo/capacitor-twilio-voice

Integrasikan plugin Suara Twilio SDK ke dalam Capacitor.

Pasang

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

bunx cap sync Menggandakan plugin asli code ke proyek-proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Import

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

Ringkasan API

Metode Deskripsi
login Autentikasi pengguna dengan Twilio Voice menggunakan token akses.
logout Keluar dari akun pengguna saat ini dan me-rekam dari Twilio Voice.
isLoggedIn Periksa apakah pengguna saat ini sudah masuk dan memiliki token akses yang valid.
makeCall Mulai panggilan keluar ke nomor telepon atau klien.
acceptCall Terima panggilan masuk.
rejectCall Tolak panggilan masuk.
endCall Selesai panggilan aktif.
muteCall Mute atau aktifkan mikrofon selama panggilan aktif.
setSpeaker Aktifkan atau nonaktifkan mode speakerphone.
getCallStatus Periksa status panggilan aktif saat ini.
checkMicrophonePermission Periksa apakah izin mikrofon sudah diberikan.
requestMicrophonePermission Meminta izin mikrofon dari pengguna.

Contoh

login()

Mengautentikasi pengguna dengan Twilio Voice menggunakan token akses.

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

const result = await CapacitorTwilioVoice.login({
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
});
console.log('Login successful:', result.success);

logout()

Keluar dari akun pengguna saat ini dan me-regristrasi dari Twilio Voice.

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

const result = await CapacitorTwilioVoice.logout();
console.log('Logout successful:', result.success);

isLoggedIn()

Mengecek apakah pengguna saat ini sudah masuk dan memiliki token akses yang valid.

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()

Menginisiasi panggilan keluar ke nomor telepon atau klien.

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()

Menerima panggilan masuk.

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()

Mengabaikan panggilan masuk.

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

CapacitorTwilioVoice.addListener('callInviteReceived', async (data) => {
  if (shouldRejectCall(data.from)) {
    await CapacitorTwilioVoice.rejectCall({
      callSid: data.callSid
    });
  }
});

Daftar metode di atas adalah 12 metode inti. Pembantu pemanggil dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat di repository GitHub.

Mendengarkan event

addListener mengembalikan handle. Panggil handle.remove() ketika layar dihapus, atau CapacitorTwilioVoice.removeAllListeners() untuk menghapus setiap pendengar.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-twilio-voice

Jika Anda menggunakan Menggunakan @capgo/capacitor-twilio-voice untuk merencanakan pekerjaan plugin native, hubungkannya dengan @capgo/capacitor-twilio-voice untuk detail implementasi di @capgo/capacitor-twilio-voice, Mulai Menggunakan Untuk detail implementasi di Getting Started, Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, dan Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin.

FAQ

FAQ Plugin Suara Twilio

Bagaimana cara saya menginstal plugin Suara Twilio di aplikasi Capacitor?

Run "bun add @capgo/capacitor-twilio-voice" (or "npm install @capgo/capacitor-twilio-voice"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-twilio-voice" in your app code.

Apakah @capgo/capacitor-twilio-voice dapat digunakan dengan React, Vue, dan Angular?

Yes. Twilio Voice is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

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

Capgo plugin mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang dipelihara.

Apakah @capgo/capacitor-twilio-suara gratis dan terbuka sumber?

Ya. Sumber code yang terbuka di GitHub di https://github.com/Cap-go/capacitor-twilio-suara/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan permintaan pull diterima.

Dapatkah saya memperbarui code yang menggunakan Twilio Voice tanpa tinjauan App Store?

Menginstal atau mengupgrade plugin mengubah code native, sehingga memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat berlayar segera dengan Capgo live updates.

Kirim perubahan Voice Twilio tanpa menunggu tinjauan aplikasi

Setelah plugin masuk ke toko Anda, Capgo live updates meneruskan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit.

Mulai dengan Capgo