Passer à la navigation principale
@capgo/capacitor-sim APIs de dispositifs Open source

SIM plugin Capacitor

Récupérer les informations de la carte SIM, y compris le nom du fournisseur, le pays code et le numéro de téléphone

Installer

bun add @capgo/capacitor-sim bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-sim
  • pnpm add @capgo/capacitor-sim
  • yarn add @capgo/capacitor-sim

Guide

Comment utiliser SIM dans Capacitor

Tester sur appareil

Télécharger l'application Capgo, puis scannez le code QR code.

Lien QR de prévisualisation du plugin SIM code

Utilisation de @capgo/capacitor-sim

Plugin SIM Capacitor pour récupérer des informations des cartes SIM du dispositif.

Installer

bun add @capgo/capacitor-sim
bunx cap sync

bunx cap sync copie le code natif du plugin code dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.

Importer

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

API en un coup d'œil

Méthode Description
getSimCards Obtenir des informations des cartes SIM du dispositif.
checkPermissions Vérifier la permission d'accès aux informations de la carte SIM.
requestPermissions Demander la permission d'accès aux informations de la carte SIM.

Exemples

getSimCards()

Obtenir des informations des cartes SIM du dispositif.

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

Vérifier la permission d'accès aux informations de la carte 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()

Demander la permission d'accès aux informations de la carte 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();
}

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-sim

Si vous utilisez Utilisation de @capgo/capacitor-sim pour planifier le tableau de bord et les opérations de API, connectez-l’à @capgo/capacitor-sim pour les détails d'implémentation dans @capgo/capacitor-sim, Prise en main pour les détails d'implémentation dans Prise en main, Vue d'ensemble de API pour les détails d'implémentation dans Vue d'ensemble de API, Introduction pour les détails d'implémentation dans Introduction, et Clés API pour le détail d'implémentation des Clés API

FAQ

FAQ du plugin SIM

Comment installer le plugin SIM dans une application Capacitor?

Exécutez la commande « bun add @capgo/capacitor-sim » (ou « npm install @capgo/capacitor-sim »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-sim » dans votre application code.

Le plugin @capgo/capacitor-sim fonctionne-t-il avec React, Vue et Angular?

Oui. Le plugin SIM est un package Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-sim?

Capgo plugins suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Le plugin @capgo/capacitor-sim est-il gratuit et open source?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-sim/ et le package est gratuit à installer depuis npm. Les rapports de bugs et les demandes de mise à jour sont les bienvenus.

Puis-je mettre à jour code qui utilise SIM sans passer par une revue de l'App Store?

L'installation ou la mise à niveau du plugin modifie les natives code, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Ship SIM changes without waiting for app review

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel déclenchent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrer avec Capgo