跳过主要内容
@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应用程序,然后扫描code的二维码。

SIM 插件预览二维码 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 来规划仪表板和 API 操作,连接它与 @capgo/capacitor-sim 的实现细节在 @capgo/capacitor-sim 中 开始 实现细节在开始中 API 概览 实现细节在 API 概览中 介绍 实现细节在介绍中 API 键 为API 键的实现细节。

FAQ

SIM插件FAQ

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

运行"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兼容吗?

是的。SIM是一个Capacitor包,因此它与任何运行在Capacitor中的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

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

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格中可以找到维护的版本。

@capgo/capacitor-sim是否免费且开源?

是的。SIM的源code在GitHub上公开可用,地址为https://github.com/Cap-go/capacitor-sim/,并且该包可以从npm免费安装。欢迎bug报告和pull请求。

是否可以在不经过App Store审查的情况下更新使用SIM的code?

安装或升级插件会更改原生code,因此需要一个新的商店构建。之后,JavaScript、HTML和CSS更改可以立即通过Capgo实时更新发布。

不必等待应用程序审查就可以将SIM更改推送到用户

一旦插件在您的商店构建中,Capgo即刻更新将将您的JavaScript、HTML和CSS更改推送给用户

开始使用Capgo