メインコンテンツにジャンプ
@capgo/capacitor-sim デバイスAPI オープンソース

SIM Capacitor プラグイン

Retrieve SIM card information including carrier name, country code, and phone number

インストール

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

ガイド

How to use SIM in Capacitor

デバイスでテスト

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

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

@capgo/capacitor-simを使用

Capacitor SIM プラグインは、デバイスのSIMカードから情報を取得するために使用されます。

インストール

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を継続して使用してください。

Capacitor-Sim を使用している場合 Using @capgo/capacitor-sim @API/__CAPGO_KEEP_1__-sim の実装詳細を参照してください @capgo/capacitor-sim @capgo/capacitorシミュレーション詳細 続けて Getting Started から ドキュメント API まとめ API まとめの実装詳細について 導入 導入の実装詳細について、 API キー API キーの実装詳細について

FAQ

SIM プラグインの FAQ

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

「bun add @capgo/capacitor-sim」 (または「npm install @capgo/capacitor-sim」) を実行し、次に「bunx cap sync」を実行して iOS と Android のプロジェクトがネイティブ code を取得できるようにします。 capgo/capacitor-sim をアプリの code からインポートします。

@capgo/capacitor-sim は React、Vue、Angular とどのように動作しますか?

Yes. SIM is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

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

Capgo プラグインは Capacitor のメジャーバージョンに従います。 Capacitor のメジャーバージョンと一致するプラグインのメジャーバージョンを使用してください (例: プラグイン v8 と Capacitor 8)。 GitHub README には維持されているバージョンの互換性表があります。

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

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-sim/ and the package is free to install from npm. Bug reports and pull requests are welcome.

SIM を使用する code を App Store のレビューなしでアップデートできますか?

プラグインをインストールまたはアップグレードすると、ネイティブ code が変更されるため、新しいストアビルドが必要になります。その後、Capgo のライブアップデートを使用して、プラグインを呼び出す JavaScript、HTML、CSS の変更を即時発送できます。

アプリレビューの待ちなしでSIMの変更を配信できます。

プラグインがストアビルドに含まれると、Capgoライブアップデートは、ユーザーにJavaScript、HTML、CSSの変更を数分でプッシュします。

Capgoから始めましょう。