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 los permisos para acceder a la información de la SIM.
requestPermissions Solicita permiso para acceder a la información de la 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 los permisos para acceder a la información de la 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 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 Capacitor?

Ejecuta "bun add @capgo/capacitor-sim" (o "npm install @capgo/capacitor-sim"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. 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 Capacitor, por lo que funciona con cualquier framework web que corra dentro de Capacitor, incluyendo 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 open source?

Sí. El code fuente es público en GitHub en https://github.com/Cap-go/capacitor-sim/ y el paquete es gratuito para instalar desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa SIM sin pasar por la 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