はじめに

インストール

AIアシストセットアップを使ってプラグインをインストールできます。以下のコマンドで、お使いのAIツールに Capgo スキルを追加してください：

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次に、以下のプロンプトを使用します：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-wechat` plugin in my project.

手動セットアップを希望する場合は、以下のコマンドでプラグインをインストールし、下記のプラットフォーム別の手順に従ってください：

bun add @capgo/capacitor-wechat
bunx cap sync

インポート

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

クイックスタート

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

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

例: isInstalled

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

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

例: auth

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

よくある落とし穴

• 一度だけ初期化: アプリのブートストラップ時にセットアップを実行します。
• ネイティブ同期: 実行 bunx cap sync プラグインのアップグレード後。
• 信頼できる情報源: 信頼する src/definitions.ts GitHub リポジトリ内に

API の概要

initialize

アプリの認証情報で WeChat SDK を初期化します。

これらの値は以下でも設定できます。 capacitor.config.ts の下にある CapacitorWechat プラグイン設定。このメソッドを呼び出すと、実行時にバンドルされた設定を上書きします。

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

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

isInstalled

デバイスにWeChatアプリがインストールされているか確認します。

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

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

auth

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

コンテンツを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

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

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
});

chooseInvoice

WeChatから請求書を選択します。

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

const { cards } = await CapacitorWechat.chooseInvoice({
  appId: 'your_app_id',
  signType: 'SHA1',
  cardSign: 'signature',
  timeStamp: '1234567890',
  nonceStr: 'random_string'
});
console.log('Selected cards:', cards);

型リファレンス

WechatInitializationOptions

WeChatの初期化オプション。

export interface WechatInitializationOptions {
  /**
   * Required WeChat application ID.
   */
  appId: string;

  /**
   * iOS universal link that is associated with your WeChat application.
   */
  universalLink?: string;
}

WechatAuthOptions

WeChat認証のオプション。

export interface WechatAuthOptions {
  /**
   * OAuth scope. Use 'snsapi_userinfo' for user info or 'snsapi_login' for login only.
   */
  scope: string;

  /**
   * Optional state parameter for CSRF protection.
   */
  state?: string;
}

WechatAuthResponse

WeChat認証のレスポンス。

export interface WechatAuthResponse {
  /**
   * Authorization code to exchange for access token.
   */
  code: string;

  /**
   * State parameter if provided in request.
   */
  state?: string;
}

WechatShareOptions

WeChatシェアのオプション。

export interface WechatShareOptions {
  /**
   * Share scene: 0 = Session (chat), 1 = Timeline (moments), 2 = Favorite.
   */
  scene: number;

  /**
   * Share type: 'text', 'image', 'link', 'music', 'video', 'miniprogram'.
   */
  type: 'text' | 'image' | 'link' | 'music' | 'video' | 'miniprogram';

  /**
   * Text content (for type 'text').
   */
  text?: string;

  /**
   * Title (for type 'link', 'music', 'video', 'miniprogram').
   */
  title?: string;

  /**
   * Description (for type 'link', 'music', 'video', 'miniprogram').
   */
  description?: string;

  /**
   * Link URL (for type 'link').
   */
  link?: string;

  /**
   * Image URL or base64 data.
   */
  imageUrl?: string;

  /**
   * Thumbnail URL or base64 data (for type 'link', 'music', 'video').
   */
  thumbUrl?: string;

  /**
   * Music or video URL (for type 'music', 'video').
   */
  mediaUrl?: string;

  /**
   * Mini-program username (for type 'miniprogram').
   */
  miniProgramUsername?: string;

  /**
   * Mini-program path (for type 'miniprogram').
   */
  miniProgramPath?: string;

  /**
   * Mini-program type: 0 = Release, 1 = Test, 2 = Preview (for type 'miniprogram').
   */
  miniProgramType?: number;

  /**
   * Mini-program web page URL fallback (for type 'miniprogram').
   */
  miniProgramWebPageUrl?: string;
}

WechatPaymentOptions

WeChatの決済オプション。

export interface WechatPaymentOptions {
  /**
   * Partner ID (merchant ID).
   */
  partnerId: string;

  /**
   * Prepay ID from unified order API.
   */
  prepayId: string;

  /**
   * Random string.
   */
  nonceStr: string;

  /**
   * Timestamp.
   */
  timeStamp: string;

  /**
   * Package value, typically 'Sign=WXPay'.
   */
  package: string;

  /**
   * Signature.
   */
  sign: string;
}

WechatMiniProgramOptions

WeChatミニプログラムのオプション。

export interface WechatMiniProgramOptions {
  /**
   * Mini-program username (original ID).
   */
  username: string;

  /**
   * Path to open in mini-program.
   */
  path?: string;

  /**
   * Mini-program type: 0 = Release, 1 = Test, 2 = Preview.
   */
  type?: number;
}

WechatInvoiceOptions

WeChatの請求書オプション。

export interface WechatInvoiceOptions {
  /**
   * App ID.
   */
  appId: string;

  /**
   * Signature type.
   */
  signType: string;

  /**
   * Card signature.
   */
  cardSign: string;

  /**
   * Timestamp.
   */
  timeStamp: string;

  /**
   * Random string.
   */
  nonceStr: string;
}

WechatInvoiceResponse

WeChatの請求書レスポンス。

export interface WechatInvoiceResponse {
  /**
   * Array of selected card IDs.
   */
  cards: WechatInvoiceCard[];
}

WechatInvoiceCard

WeChatの請求書カード項目

export interface WechatInvoiceCard {
  /**
   * The selected card identifier.
   */
  cardId: string;

  /**
   * Encrypted code returned by WeChat.
   */
  encryptCode?: string;
}

信頼できる情報源

このページはプラグインの src/definitions.tsから生成されています。上流で公開 API が変更されたら、sync を再実行してください。

Getting Started から続ける

以下を使用している場合： はじめに ダッシュボードと API の操作を計画するには、以下と連携してください @capgo/capacitor-wechatの使い方 @capgo/capacitor-wechat を使用してネイティブ機能を利用する場合: API の概要 API Overview の実装の詳細については、 はじめに Introduction の実装の詳細については、 API キー API Keys の実装の詳細については、 デバイス Devices の実装の詳細については。