メインコンテンツへスキップ
@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 の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 API の概要 「API の概要」の実装の詳細については、 はじめに はじめにの実装詳細、および API キー API Keys の実装詳細については、

よくある質問

SIMプラグイン 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 Live Updates で即座に配信できます。

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

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

Capgo から始める