Guía
¿Cómo usar WeChat en Capacitor
Usando @capgo/capacitor-wechat
Capacitor WeChat Plugin - Integración de WeChat SDK para autenticación, compartición, pagos y mini-aplicaciones.
Instalar
bun add @capgo/capacitor-wechat
bunx cap sync
bunx cap sync Copia el plugin nativo code en tus proyectos nativos. Correlo nuevamente después de cada actualización del plugin.
Importar
import { CapacitorWechat } from '@capgo/capacitor-wechat';
API en resumen
| Método | Descripción |
|---|---|
initialize |
Inicializa el WeChat SDK con tus credenciales de aplicación. |
isInstalled |
Verifica si la aplicación WeChat está instalada en el dispositivo. |
auth |
Autentica al usuario con OAuth de WeChat. |
share |
Compartir contenido en WeChat. |
sendPaymentRequest |
Enviar solicitud de pago a WeChat Pay. |
openMiniProgram |
Abrir programa mini de WeChat. |
chooseInvoice |
Elegir factura de WeChat. |
Ejemplos
initialize()
Configurar el programa WeChat SDK con tus credenciales de aplicación.
import { CapacitorWechat } from '@capgo/capacitor-wechat';
await CapacitorWechat.initialize({
appId: 'wx1234567890',
universalLink: 'https://example.com/app/'
});
isInstalled()
Verificar si el programa WeChat está instalado en el dispositivo.
import { CapacitorWechat } from '@capgo/capacitor-wechat';
const { installed } = await CapacitorWechat.isInstalled();
if (installed) {
console.log('WeChat is installed');
}
auth()
Autenticar al usuario con OAuth de WeChat.
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()
Compartir 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()
Enviar 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()
Abrir programa mini 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 muestra los 7 métodos básicos. Los ayudantes de escucha y versión, y la completa contratación de cada método, se documentan en el GitHub repositorio.
Referencia completa
Sigue adelante desde Usando @capgo/capacitor-wechat
Si estás utilizando Usando @capgo/capacitor-wechat para planificar la autenticación y los flujos de cuenta, conecta con @capgo/capacitor-wechat para los detalles de implementación en @capgo/capacitor-wechat Inicio rápido Para los detalles de implementación en Getting Started, @capgo/capacitor-login-social Para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-clave-llave Para los detalles de implementación en @capgo/capacitor-passkey, y @capgo/capacitor-biometría-nativa Para los detalles de implementación en @capgo/capacitor-native-biometric.