Langsung ke konten utama
@capgo/capacitor-sim API Perangkat Open source

SIM plugin Capacitor

Ambil informasi kartu SIM termasuk nama operator, negara code, dan nomor telepon

Instal

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

Panduan

Cara menggunakan SIM di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

QR pratinjau plugin SIM code

Menggunakan @capgo/capacitor-sim

Capacitor Plugin SIM untuk mengambil informasi dari kartu SIM perangkat.

Instal

bun add @capgo/capacitor-sim
bunx cap sync

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

Impor

import { Sim } from '@capgo/capacitor-sim';

Sekilas tentang API

Metode Deskripsi
getSimCards Dapatkan informasi dari kartu SIM perangkat.
checkPermissions Periksa izin untuk mengakses informasi kartu SIM.
requestPermissions Minta izin untuk mengakses informasi kartu SIM.

Contoh

getSimCards()

Dapatkan informasi dari kartu SIM perangkat.

import { Sim } from '@capgo/capacitor-sim';

const { simCards } = await Sim.getSimCards();
simCards.forEach((sim, index) => {
  console.log(`SIM ${index + 1}:`);
  console.log(`  Carrier: ${sim.carrierName}`);
  console.log(`  Country: ${sim.isoCountryCode}`);
  console.log(`  MCC: ${sim.mobileCountryCode}`);
  console.log(`  MNC: ${sim.mobileNetworkCode}`);
});

checkPermissions()

Periksa izin untuk mengakses informasi kartu SIM.

import { Sim } from '@capgo/capacitor-sim';

const status = await Sim.checkPermissions();
if (status.readSimCard === 'granted') {
  console.log('Permission granted');
} else {
  console.log('Permission not granted');
}

requestPermissions()

Minta izin untuk mengakses informasi kartu SIM.

import { Sim } from '@capgo/capacitor-sim';

const status = await Sim.requestPermissions();
if (status.readSimCard === 'granted') {
  // Now you can call getSimCards()
  const simCards = await Sim.getSimCards();
}

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-sim

Jika Anda menggunakan Menggunakan @capgo/capacitor-sim untuk merencanakan operasi dashboard dan API, hubungkan dengan @capgo/capacitor-sim untuk detail implementasi di @capgo/capacitor-sim, Panduan Memulai untuk detail implementasi di Getting Started, Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, dan Kunci API untuk detail implementasi di API Keys.

FAQ

FAQ plugin SIM

Bagaimana cara menginstal plugin SIM di aplikasi Capacitor?

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

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

Ya. SIM adalah paket Capacitor, jadi bekerja dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript polos.

Versi Capacitor mana yang didukung @capgo/capacitor-sim?

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-sim gratis dan open source?

Ya. code sumber tersedia di GitHub pada https://github.com/Cap-go/capacitor-sim/ dan paketnya gratis diinstal dari npm. Laporan bug dan pull request disambut baik.

Bisakah saya memperbarui code yang menggunakan SIM 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 SIM 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