WeChat plugin Capacitor

Uso de @capgo/capacitor-wechat

Plugin de Capacitor WeChat - Integración de WeChat SDK para autenticación, compartir, pagos y mini-programas.

Instalar

bun add @capgo/capacitor-wechat
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 { CapacitorWechat } from '@capgo/capacitor-wechat';

API de un vistazo

Método	Descripción
initialize	Inicializa el SDK de WeChat con las credenciales de tu app.
isInstalled	Comprueba si la app de WeChat está instalada en el dispositivo.
auth	Autentica al usuario mediante WeChat OAuth.
share	Comparte contenido en WeChat.
sendPaymentRequest	Envía una solicitud de pago a WeChat Pay.
openMiniProgram	Abre un mini-program de WeChat.
chooseInvoice	Selecciona una factura de WeChat.

Ejemplos

initialize()

Inicializa el SDK de WeChat con las credenciales de tu app.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

await CapacitorWechat.initialize({
  appId: 'wx1234567890',
  universalLink: 'https://example.com/app/'
});

isInstalled()

Comprueba si la app de WeChat está instalada en el dispositivo.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

const { installed } = await CapacitorWechat.isInstalled();
if (installed) {
  console.log('WeChat is installed');
}

auth()

Autentica al usuario con WeChat OAuth.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

const { code, state } = await CapacitorWechat.auth({
  scope: 'snsapi_userinfo',
  state: 'my_state'
});
// Use code to get access token from your server

share()

Comparte contenido en WeChat.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

// Share text
await CapacitorWechat.share({
  scene: 0, // 0 = Session, 1 = Timeline, 2 = Favorite
  type: 'text',
  text: 'Hello WeChat!'
});

// Share link
await CapacitorWechat.share({
  scene: 1,
  type: 'link',
  title: 'My Website',
  description: 'Check out my website',
  link: 'https://example.com',
  imageUrl: 'https://example.com/image.jpg'
});

sendPaymentRequest()

Envía una solicitud de pago a WeChat Pay.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

// Get payment params from your server first
const paymentParams = await fetchPaymentParamsFromServer();

await CapacitorWechat.sendPaymentRequest({
  partnerId: paymentParams.partnerId,
  prepayId: paymentParams.prepayId,
  nonceStr: paymentParams.nonceStr,
  timeStamp: paymentParams.timeStamp,
  package: paymentParams.package,
  sign: paymentParams.sign
});

openMiniProgram()

Abre un miniprograma de WeChat.

import { CapacitorWechat } from '@capgo/capacitor-wechat';

const { extMsg } = await CapacitorWechat.openMiniProgram({
  username: 'gh_xxxxxxxxxxxxx',
  path: 'pages/index/index',
  type: 0 // 0 = Release, 1 = Test, 2 = Preview
});

La tabla anterior enumera los 7 métodos principales. Los helpers de versión y listeners, así como el contrato completo de cada método, están documentados en la repositorio GitHub.

Referencia completa

• repositorio GitHub
• Documentación
• Referencia de API

Continúa desde Using @capgo/capacitor-wechat

Si estás usando Uso de @capgo/capacitor-wechat para planificar los flujos de autenticación y de cuenta, conéctalo con @capgo/capacitor-wechat para los detalles de implementación en @capgo/capacitor-wechat, Primeros pasos para los detalles de implementación en Primeros pasos, @capgo/capacitor-social-login para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-passkey para los detalles de implementación en @capgo/capacitor-passkey, y @capgo/capacitor-native-biometric para los detalles de implementación en @capgo/capacitor-native-biometric.