萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

微信公眾平台開發:基於百度音樂接口實現「點歌」功能全流程

微信公眾平台開放「音樂消息」接口後,開發者可構建「微信點歌」機器人:用戶發送「點歌 歌名」,公眾號返回音樂卡片,點擊即播放。本文從音樂資源獲取、消息格式對接、核心代碼實現到效果演示全流程講解。

一、獲取音樂資源:百度音樂盒接口

接口地址(非官方公開,穩定性無保證,生產建議用正版音樂開放平台):

https://box.zhangmen.baidu.com/x?op=12&count=1&title=歌曲名$$歌手名$$$$

返回 XML,解析出 encode(加密鏈接)、decode(真實 MP3 鏈接)等字段。

百度接口返回示例1

百度接口返回示例2

二、微信音樂消息格式

被動回復音樂消息 XML 結構:

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[music]]></MsgType>
  <Music>
    <Title><![CDATA[TITLE]]></Title>
    <Description><![CDATA[DESCRIPTION]]></Description>
    <MusicUrl><![CDATA[MUSIC_URL]]></MusicUrl>
    <HQMusicUrl><![CDATA[HQ_MUSIC_URL]]></HQMusicUrl>
    <ThumbMediaId><![CDATA[media_id]]></ThumbMediaId>
  </Music>
</xml>

音樂消息格式

參數說明

三、核心業務邏輯實現(Python Flask 示例)

import requests, xml.etree.ElementTree as ET, hashlib, time
from flask import Flask, request, make_response

app = Flask(__name__)
TOKEN = 'your_token'

@app.route('/wechat', methods=['GET', 'POST'])
def wechat():
    if request.method == 'GET':
        # 驗證服務器
        signature = request.args.get('signature')
        timestamp = request.args.get('timestamp')
        nonce = request.args.get('nonce')
        echostr = request.args.get('echostr')
        if check_signature(signature, timestamp, nonce):
            return echostr
        return 'fail'
    
    # 接收消息
    xml_data = request.data
    msg = parse_xml(xml_data)
    
    if msg['MsgType'] == 'text':
        content = msg['Content'].strip()
        if content.startswith('點歌 '):
            song_name = content[3:].strip()
            music_info = search_music(song_name)
            if music_info:
                return build_music_reply(msg, music_info)
            else:
                return build_text_reply(msg, '未找到相關歌曲,請換個關鍵詞試試~')
    
    return build_text_reply(msg, '發送「點歌 歌名」即可聽歌哦!')

def search_music(keyword):
    # 1. 搜索百度獲取歌曲 ID/鏈接(此處簡化,實際需解析搜索頁或用正規 API)
    # 2. 調用 box.zhangmen.baidu.com 獲取真實 MP3 鏈接
    # 返回 dict: title, author, music_url, hq_url, thumb_media_id
    pass  # 具體實現略

def build_music_reply(msg, music):
    tpl = '''<xml>
    <ToUserName><![CDATA[{to}]]></ToUserName>
    <FromUserName><![CDATA[{from_user}]></FromUserName>
    <CreateTime>{time}</CreateTime>
    <MsgType><![CDATA[music]]></MsgType>
    <Music>
        <Title><![CDATA[{title}]]></Title>
        <Description><![CDATA[{author}]]></Description>
        <MusicUrl><![CDATA[{url}]]></MusicUrl>
        <HQMusicUrl><![CDATA[{hq_url}]]></HQMusicUrl>
        <ThumbMediaId><![CDATA[{thumb}]]></ThumbMediaId>
    </Music>
</xml>'''
    return tpl.format(
        to=msg['FromUserName'], from_user=msg['ToUserName'],
        time=int(time.time()),
        title=music['title'], author=music['author'],
        url=music['music_url'], hq_url=music['hq_url'],
        thumb=music['thumb_media_id']
    )

def check_signature(sig, ts, nonce):
    arr = sorted([TOKEN, ts, nonce])
    return hashlib.sha1(''.join(arr).encode()).hexdigest() == sig

def parse_xml(xml_bytes):
    root = ET.fromstring(xml_bytes)
    return {child.tag: child.text for child in root}

核心代碼截圖

四、效果演示

  1. 用戶關注公眾號「方倍工作室」。
  2. 發送「點歌 最炫民族風」。
  3. 收到音樂卡片,顯示標題、歌手、封面。
  4. 點擊播放,WiFi 下流暢無卡頓。

點歌成功界面

頂部欄顯示

音樂播放界面

五、生產環境避坑指南

  • 版權合規:必須使用正版授權音樂源(QQ音樂開放平台、網易雲音樂 API、自有版權庫),百度接口僅供學習。
  • 媒體 ID 獲取:ThumbMediaId 需先上傳縮略圖至微信素材管理獲取 media_id。
  • 高清鏈接:HQMusicUrl 填寫高碼率鏈接,WiFi 下自動切換。
  • 並發與緩存:搜索結果緩存到 Redis,減少對上游 API 壓力。
  • 異常降級:音樂服務不可用時回復文本提示,不阻塞主流程。

掌握「音樂消息」接口,結合豐富曲庫,即可打造留存率極高的微信聽歌工具。

copyright © 萬盛學電腦網 all rights reserved