Guida
Come usare WeChat in Capacitor
Utilizzo di @capgo/capacitor-wechat
Plugin WeChat di Capacitor - Integrazione SDK di WeChat per autenticazione, condivisione, pagamenti e mini-programmi.
Installa
bun add @capgo/capacitor-wechat
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapacitorWechat } from '@capgo/capacitor-wechat';
API in breve
| Metodo | Descrizione |
|---|---|
initialize |
Inizializza il SDK di WeChat con le credenziali della tua app. |
isInstalled |
Verifica se l'app WeChat è installata sul dispositivo. |
auth |
Autentica l'utente tramite WeChat OAuth. |
share |
Condividi contenuti su WeChat. |
sendPaymentRequest |
Invia una richiesta di pagamento a WeChat Pay. |
openMiniProgram |
Apri un mini-program di WeChat. |
chooseInvoice |
Seleziona la fattura da WeChat. |
Esempi
initialize()
Inizializza il SDK di WeChat con le credenziali della tua app.
import { CapacitorWechat } from '@capgo/capacitor-wechat';
await CapacitorWechat.initialize({
appId: 'wx1234567890',
universalLink: 'https://example.com/app/'
});
isInstalled()
Verifica se l'app WeChat è installata sul dispositivo.
import { CapacitorWechat } from '@capgo/capacitor-wechat';
const { installed } = await CapacitorWechat.isInstalled();
if (installed) {
console.log('WeChat is installed');
}
auth()
Autentica l'utente tramite 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()
Condividi contenuti su 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()
Invia una richiesta di pagamento 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()
Apri un mini-program di 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 tabella sopra elenca i 7 metodi core. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Riferimento completo
Torna a Usare @capgo/capacitor-wechat
Se stai usando Usare @capgo/capacitor-wechat per pianificare i flussi di autenticazione e account, collegandolo a @capgo/capacitor-wechat per i dettagli di implementazione in @capgo/capacitor-wechat, Per iniziare per i dettagli di implementazione nella guida introduttiva, @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, e @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric.