Saltar al contenido principal
@capgo/capacitor-sim API de dispositivos Código abierto

SIM plugin Capacitor

Obtén información de la tarjeta SIM, incluyendo el operador, el país code y el número de teléfono

Instalar

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

Guía

Cómo usar SIM en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

QR de vista previa del plugin SIM code

Uso de @capgo/capacitor-sim

Plugin SIM de Capacitor para obtener información de las tarjetas SIM del dispositivo.

Instalar

bun add @capgo/capacitor-sim
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método Descripción
getSimCards Obtén información de las tarjetas SIM del dispositivo.
checkPermissions Comprueba el permiso para acceder a la información de la tarjeta SIM.
requestPermissions Solicita permiso para acceder a la información de la tarjeta SIM.

Ejemplos

getSimCards()

Obtén información de las tarjetas SIM del dispositivo.

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

Comprueba el permiso para acceder a la información de la tarjeta 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()

Solicita permiso para acceder a la información de la tarjeta 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();
}

Referencia completa

Continúa desde Uso de @capgo/capacitor-sim

Si estás usando Uso de @capgo/capacitor-sim para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-sim para los detalles de implementación en @capgo/capacitor-sim, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.

FAQ

Preguntas frecuentes del plugin SIM

¿Cómo instalo el plugin SIM en una app de Capacitor?

Ejecuta "bun add @capgo/capacitor-sim" (o "npm install @capgo/capacitor-sim") y luego "bunx cap sync" para que los proyectos de iOS y Android incorporen el código nativo code. Impórtalo desde "@capgo/capacitor-sim" en el code de tu app.

¿Funciona @capgo/capacitor-sim con React, Vue y Angular?

Sí. SIM es un paquete de Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluido Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-sim?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-sim gratuito y de código abierto?

Sí. El code está publicado en GitHub en https://github.com/Cap-go/capacitor-sim/ y el paquete se instala gratis desde npm. Se aceptan informes de errores y pull requests.

¿Puedo actualizar code que usa SIM sin una revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Publica cambios de SIM sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo