カスタムメニュー作成インターフェース-WeChatの開発-php.cn

カスタムメニュー作成インターフェース

Y2J

リリース： 2017-05-17 15:31:33

オリジナル

1413 人が閲覧しました

カスタマイズされたメニューは、公式アカウントのインターフェースを強化し、ユーザーが公式アカウントの機能をより良く、より早く理解できるようにするのに役立ちます。カスタムメニューをオンにすると、公式アカウントのインターフェイスは次の図のようになります:

カスタムメニュー作成インターフェース

注意:

1 カスタムメニューには、最大 3 つの第 1 レベルのメニューと、各第 1 レベルのメニューを含めることができます。最大 5 つの第 2 レベルのメニューメニューを含めることができます。
2. 第 1 レベルのメニューには最大 4 文字、第 2 レベルのメニューには最大 7 文字の中国語を含めることができます。余分な部分は「...」に置き換えられます。
3. カスタムメニューを作成した後、ユーザーが公式アカウントの会話ページまたは公式アカウントのプロフィールページにアクセスしたときに、メニューを取得する最後のリクエストが 5 分前に見つかった場合、メニューが更新されます。メニューが更新されている場合、クライアントのメニューが更新されます。テストする場合は、公開アカウントのフォローを解除してから再度フォローしてみると、作成後の効果を確認できます。

カスタムメニューインターフェイスは、次のように複数のタイプのボタンを実装できます:

1. クリック: クリックプッシュイベントユーザーがクリックタイプボタンをクリックした後、WeChat サーバーはメッセージタイプをプッシュします。イベントの構造は、メッセージインターフェイスを通じて開発者に提供され (メッセージインターフェイスガイドを参照)、開発者がボタンに key 値を入力すると、開発者はカスタマイズされたキーを介してユーザーと対話できます。値;

2. ビュー: ジャンプ URL 転送ユーザーがビュータイプボタンをクリックすると、WeChat クライアントは、開発者がボタンに入力した Web ページ URL を開きます。これは、Web ページ認証インターフェイスと組み合わせることができます。ユーザーの基本情報を取得するユーザーの基本情報を取得します。

3. scancode_push: ユーザーがスキャンコードプッシュイベントのボタンをクリックすると、WeChat クライアントはスキャンコード操作の完了後にスキャンツールを起動します (URL の場合)。 URL が入力されます)、スキャンされたコードが表示され、コードの結果が開発者に渡され、開発者はメッセージを送信できます。

4. scancode_waitmsg: コードをスキャンしてイベントをプッシュし、ユーザーがボタンをクリックすると、コードのスキャン操作が完了すると、WeChat クライアントがスキャンツールを起動します。スキャンコードの結果が開発者に送信され、同時にスキャンツールをしまうと、「メッセージ受信中」プロンプトボックスが表示され、開発者からメッセージを受け取ることがあります。

5. pic_sysphoto: ユーザーが写真を撮ってシステムに写真を送信するボタンをクリックすると、写真操作が完了すると、WeChat クライアントがシステムカメラを呼び出し、撮影した写真が開発者に送信されます。イベントは開発者にプッシュされ、システムカメラをしまうと、開発者からメッセージが届く場合があります。

6. pic_photo_or_album: ユーザーが写真を撮るかアルバムに写真を送信するボタンをクリックすると、WeChat クライアントはユーザーが「写真を撮る」または「モバイルから選択」を選択するためのセレクターをポップアップします。電話アルバム」。ユーザーが選択した後、他の 2 つのプロセスを実行します。

7. pic_weixin: ユーザーがポップアップ WeChat フォトアルバム送信者のボタンをクリックすると、選択操作が完了すると、WeChat クライアントは WeChat フォトアルバムを呼び出し、選択された写真が開発者のものに送信されます。サーバーとイベントが開発者にプッシュされ、同時にフォトアルバムを閉じると、後で開発者からメッセージが届く場合があります。

8. location_select: ユーザーがポップアップ地理的場所セレクターのボタンをクリックすると、選択操作が完了すると、WeChat クライアントは地理的場所選択ツールを呼び出し、選択された地理的場所がに送信されます。開発者のサーバーにアクセスすると、その場所が閉鎖されます。ツールを選択すると、開発者からメッセージが届く場合があります。

9. media_id: メッセージを送信します (テキストメッセージを除く)。ユーザーが media_id タイプのボタンをクリックすると、WeChat サーバーは開発者によって入力された永続的なマテリアル ID に対応するマテリアルをユーザーに送信します。マテリアルのタイプは、写真、オーディオ、ビデオ、グラフィックメッセージです。注意してください: 永久マテリアル ID は、アップロード後に「マテリアル管理/追加永久マテリアル」インターフェースを通じて取得した法的 ID である必要があります。

10. view_limited: 画像とテキストメッセージの URL にジャンプします。ユーザーが view_limited タイプのボタンをクリックすると、WeChat クライアントは、開発者が入力した永続的なマテリアル ID に対応する画像とテキストメッセージの URL を開きます。ボタン。永続的なマテリアルタイプは画像とテキスト情報のみをサポートします。注意: 永久マテリアル ID は、「マテリアル管理/永久マテリアルの追加」インターフェースを介してアップロードした後に取得した法的 ID である必要があります。

3 から 8 までのすべてのイベントは WeChat iPhone 5.4.1 以降のみをサポートしており、古いバージョンの Android 5.4 以降の WeChat ユーザーはクリックしても応答せず、開発者はイベントプッシュを正常に受信できないことに注意してください。。 9 と 10 は、WeChat によって認定されていないサードパーティプラットフォームのサブスクリプションアカウント (具体的には、資格認定に合格しなかったアカウント) のために特別に用意されたイベントタイプであり、イベントプッシュがなく、その機能は比較的限定されています。他の種類の公開アカウント使用する必要はありません。

インターフェース呼び出しリクエストの説明

http リクエストメソッド: POST (https プロトコルを使用してください) api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

クリックしてリクエストの例を表示します

{
     "button":[
     {
          "type":"click",
          "name":"今日歌曲",
          "key":"V1001_TODAY_MUSIC"
      },
      {
           "name":"菜单",
           "sub_button":[
           {
               "type":"view",
               "name":"搜索",
               "url":"http://www.soso.com/"
            },
            {
               "type":"view",
               "name":"视频",
               "url":"http://v.qq.com/"
            },
            {
               "type":"click",
               "name":"赞一下我们",
               "key":"V1001_GOOD"
            }]
       }]
 }

ログイン後にコピー

その他 Newボタンタイプリクエスト例

{
    "button": [
        {
            "name": "扫码", 
            "sub_button": [
                {
                    "type": "scancode_waitmsg", 
                    "name": "扫码带提示", 
                    "key": "rselfmenu_0_0", 
                    "sub_button": [ ]
                }, 
                {
                    "type": "scancode_push", 
                    "name": "扫码推事件", 
                    "key": "rselfmenu_0_1", 
                    "sub_button": [ ]
                }
            ]
        }, 
        {
            "name": "发图", 
            "sub_button": [
                {
                    "type": "pic_sysphoto", 
                    "name": "系统拍照发图", 
                    "key": "rselfmenu_1_0", 
                   "sub_button": [ ]
                 }, 
                {
                    "type": "pic_photo_or_album", 
                    "name": "拍照或者相册发图", 
                    "key": "rselfmenu_1_1", 
                    "sub_button": [ ]
                }, 
                {
                    "type": "pic_weixin", 
                    "name": "微信相册发图", 
                    "key": "rselfmenu_1_2", 
                    "sub_button": [ ]
                }
            ]
        }, 
        {
            "name": "发送位置", 
            "type": "location_select", 
            "key": "rselfmenu_2_0"
        },
        {
           "type": "media_id", 
           "name": "图片", 
           "media_id": "MEDIA_ID1"
        }, 
        {
           "type": "view_limited", 
           "name": "图文消息", 
           "media_id": "MEDIA_ID2"
        }
    ]

ログイン後にコピー

パラメータ説明

カスタムメニュー作成インターフェース

戻り結果

正しい場合の戻りJSONデータパケットは以下の通り:

{"errcode":0,"errmsg":"ok"}

ログイン後にコピー

間違っている場合の戻りJSONデータパケットは以下の通り(例は無効なメニュー名の長さです):

{"errcode":40018,"errmsg":"invalid button name size"}

ログイン後にコピー

【関連する推奨事項】

1. 特別な推奨事項: 「php Programmer Toolbox」V0.1 バージョンのダウンロード

2. WeChat パブリックアカウントプラットフォームのソースコードのダウンロード

3 .

Alizi注文システムのソースコード

以上がカスタムメニュー作成インターフェースの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。