跳转至正文
@capgo/capacitor-sim 设备 API 开源

SIM 卡 Capacitor 插件

获取 SIM 卡信息,包括运营商名称、国家/地区 code 和电话号码

安装

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 App,然后扫描二维码 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

如果你正在使用 使用 @capgo/capacitor-sim 要规划 dashboard 和 API 操作,请将其连接到 @capgo/capacitor-sim 了解 @capgo/capacitor-sim 中的实现细节, 快速入门 有关“入门指南”中的实现细节, API 概览 关于 API Overview 中的实现细节, 简介 关于简介中的实现细节,以及 API 密钥 关于 API Keys 中的实现细节。

常见问题

SIM 插件常见问题

如何在 Capacitor 应用中安装 SIM 插件?

运行 "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 包,因此可与任何运行在 Capacitor 中的 Web 框架配合使用,包括 Ionic、React、Vue、Angular、Svelte 以及纯 JavaScript。

@capgo/capacitor-sim 支持哪个 Capacitor 版本?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-sim 是免费开源的吗?

是的。code 源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-sim/,该包可从 npm 免费安装。欢迎提交 Bug 报告和 Pull Request。

我可以在不经过 App Store 审核的情况下,更新使用了 SIM 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App 审核即可发布 SIM 变更

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo