WeChat Plugin Capacitor

Utiliser @capgo/capacitor-wechat

Plugin Capacitor WeChat - Intégration SDK WeChat pour l'authentification, le partage, les paiements et les mini-programmes.

Installer

bun add @capgo/capacitor-wechat
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode	Description
initialize	Initialisez le SDK WeChat avec les identifiants de votre application.
isInstalled	Vérifier si l'application WeChat est installée sur l'appareil.
auth	Authentifier l'utilisateur avec WeChat OAuth.
share	Partager du contenu sur WeChat.
sendPaymentRequest	Envoyer une demande de paiement via WeChat Pay.
openMiniProgram	Ouvrir un mini-programme WeChat.
chooseInvoice	Choisir une facture depuis WeChat.

Exemples

initialize()

Initialisez le SDK WeChat avec les identifiants de votre application.

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

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

isInstalled()

Vérifier si l'application WeChat est installée sur l'appareil.

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

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

auth()

Authentifier l'utilisateur avec l'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()

Partager du contenu sur 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()

Envoyer une demande de paiement via 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()

Ouvrir un mini-programme 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
});

Le tableau ci-dessus liste les 7 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Référence complète

• dépôt GitHub
• Documentation
• Référence API

Continuer avec l'utilisation de @capgo/capacitor-wechat

Si vous utilisez Utilisation de @capgo/capacitor-wechat pour planifier les flux d'authentification et de compte, le connecter à @capgo/capacitor-wechat pour les détails d'implémentation dans @capgo/capacitor-wechat, Prise en main pour les détails d'implémentation dans Getting Started @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, et @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric.