Mulai

Salin prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-sim`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/sim/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Pasang

bun add @capgo/capacitor-sim
bunx cap sync

Impor

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

API Ringkasan

`getSimCards`

Mengambil informasi dari kartu SIM perangkat.

Mengambil detail tentang semua kartu SIM yang terpasang di perangkat. Pada perangkat dual-SIM, mengembalikan informasi untuk kedua kartu SIM. Memerlukan izin READ_PHONE_STATE pada Android.

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

const { simCards } = await SimPlugin.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.

Mengatur apakah aplikasi memiliki izin untuk membaca data kartu SIM. Di Android, memeriksa izin READ_PHONE_STATE. Di iOS, status selalu diberikan. Di Web, status selalu ditolak.

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

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

`requestPermissions`

Minta izin untuk mengakses informasi kartu SIM.

Mengajak pengguna untuk memberikan izin membaca data kartu SIM. Di Android, meminta izin READ_PHONE_STATE. Di iOS, status selalu diberikan tanpa mengajak. Di Web, status tetap ditolak.

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

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

Referensi Tipe

`GetSimCardsResult`

Hasil yang dikembalikan oleh .

export interface GetSimCardsResult {
  simCards: SimCard[];
}

`PermissionStatus`

Hasil dari pengecekan atau permintaan izin.

export interface PermissionStatus {
  readSimCard: PermissionState;
}

`SimCard`

Deskripsi kartu SIM.

export interface SimCard {
  /**
   * Android only: Phone number for this SIM slot, when available.
   *
   * @since 1.0.0
   */
  number?: string;

  /**
   * Android only: Unique subscription identifier.
   *
   * @since 1.1.0
   */
  subscriptionId?: string;

  /**
   * Android only: Physical SIM slot index for this subscription.
   *
   * @since 1.1.0
   */
  simSlotIndex?: number;

  /**
   * iOS only: Indicates whether the carrier supports VoIP.
   *
   * @since 1.0.0
   */
  allowsVOIP?: boolean;

  /**
   * Display name of the cellular service provider.
   *
   * On iOS 16.4+ the system may return placeholder values such as `--`.
   * See https://github.com/jonz94/capacitor-sim/issues/8 for details.
   *
   * @since 1.0.0
   */
  carrierName: string;

  /**
   * ISO 3166-1 alpha-2 country code of the service provider.
   *
   * On iOS 16.4+ the system may return an empty string or `--`.
   * See https://github.com/jonz94/capacitor-sim/issues/8 for details.
   *
   * @since 1.0.0
   */
  isoCountryCode: string;

  /**
   * Mobile Country Code (MCC) of the service provider.
   *
   * On iOS 16.4+ the system may return placeholder values such as `65535`.
   * See https://github.com/jonz94/capacitor-sim/issues/8 for details.
   *
   * @since 1.0.0
   */
  mobileCountryCode: string;

  /**
   * Mobile Network Code (MNC) of the service provider.
   *
   * On iOS 16.4+ the system may return placeholder values such as `65535`.
   * See https://github.com/jonz94/capacitor-sim/issues/8 for details.
   *
   * @since 1.0.0
   */
  mobileNetworkCode: string;
}

Sumber Kebenaran

Halaman ini dihasilkan dari plugin’s. src/definitions.ts. Re-run sync ketika publik API berubah di atas.

Teruskan dari Getting Started

Jika Anda menggunakan Mulai untuk merencanakan dashboard dan API operasi, hubungkannya dengan Menggunakan @capgo/capacitor-sim untuk kemampuan asli dalam Menggunakan @capgo/capacitor-sim, API Ringkasan untuk detail implementasi dalam API Ringkasan, Pendahuluan untuk detail implementasi dalam Pendahuluan, API Kunci untuk detail implementasi dalam API Kunci, dan Perangkat untuk detail implementasi di Perangkat.