メインコンテンツへスキップ
@capgo/capacitor-sim デバイスAPI オープンソース

SIM Capacitor プラグイン

キャリア名、国 code、電話番号などのSIMカード情報を取得します

インストール

bun add @capgo/capacitor-sim bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-sim
  • pnpm add @capgo/capacitor-sim
  • yarn add @capgo/capacitor-sim

ガイド

Capacitor で SIM を使用する方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

SIMプラグインのプレビュー用QR code

@capgo/capacitor-sim を使用

デバイスのSIMカードから情報を取得するための Capacitor SIM Plugin。

インストール

bun add @capgo/capacitor-sim
bunx cap sync

bunx cap sync プラグインのネイティブ code をネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド 説明
getSimCards デバイスのSIMカードから情報を取得します。
checkPermissions SIMカード情報へのアクセス権限を確認します。
requestPermissions SIMカード情報へのアクセス権限をリクエストします。

実装例

getSimCards()

デバイスのSIMカードから情報を取得します。

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

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

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

リファレンス全文

@capgo/capacitor-sim の使用方法へ進む

以下を使用している場合: @capgo/capacitor-sim の使用方法 ダッシュボードと API の操作を計画するには、以下と連携してください @capgo/capacitor-sim @capgo/capacitor-sim の実装詳細については、 はじめに Getting Started の実装の詳細については、 API の概要 API Overview の実装の詳細については、 はじめに はじめに の実装詳細については、 API キー API Keysの実装詳細についてはこちら。

よくある質問

SIM plugin の FAQ

Capacitor アプリに SIM plugin をインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-sim"(または "npm install @capgo/capacitor-sim")を実行し、続けて "bunx cap sync" を実行すると、iOS と Android プロジェクトにネイティブの code が反映されます。アプリの code で "@capgo/capacitor-sim" からインポートしてください。

@capgo/capacitor-sim は React、Vue、Angular で動作しますか?

はい。SIM は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、プレーンな JavaScript など、Capacitor 内で動作するあらゆる Web フレームワークで使えます。

@capgo/capacitor-sim はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンと一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-sim は無料でオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-sim/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

App Store の審査なしで、SIM を使用している code をアップデートできますか?

このプラグインをインストールまたはアップグレードするとネイティブの code が変わるため、ストア向けの新しいビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo によるライブアップデートで即座に配信できます。

アプリの審査を待たずに SIM の変更をリリース

ストアビルドにプラグインを組み込めば、Capgo のライブアップデートで JavaScript、HTML、CSS の変更を数分でユーザーに配信できます。

Capgo から始める