Lompat 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

Unduh aplikasi Capgo, lalu pindai QR code.

QR pratinjau plugin SIM code

Menggunakan @capgo/capacitor-sim

Capacitor SIM Plugin 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 lagi setelah setiap upgrade plugin.

Impor

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

Sekilas tentang API

Metode Deskripsi
getSimCards Dapatkan informasi dari kartu SIM perangkat.
checkPermissions Cek 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()

Cek 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, Ikhtisar API untuk detail implementasi di Ringkasan API, Pendahuluan untuk detail implementasi di Introduction, dan Kunci API untuk detail implementasi di API Keys.

FAQ

FAQ plugin SIM

Bagaimana cara install 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 mendeteksi code native. Import dari "@capgo/capacitor-sim" di code aplikasi Anda.

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

Ya. SIM adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

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

Plugin Capgo mengikuti versi major Capacitor: gunakan versi major plugin yang cocok dengan versi major Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang di-maintain.

Apakah @capgo/capacitor-sim gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-sim/ dan package ini gratis diinstall via npm. Bug report dan pull request sangat kami terima.

Bisakah saya update code yang menggunakan SIM tanpa review App Store?

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

Rilis perubahan SIM tanpa perlu menunggu proses review aplikasi

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

Mulai dengan Capgo