写真、音声、ビデオに返信するとき、WeChat 公開アカウントは media_id を使用して関連ファイルを呼び出します。多くの友人がこれを開発および実装する方法を尋ねました。この記事では、WeChat パブリック プラットフォームの開発プロセス中にマルチメディア ファイルをアップロードおよびダウンロードする方法を紹介します。
1. マルチメディア ファイルをアップロードします
パブリック アカウントは、このインターフェイスを呼び出して、写真、音声、ビデオ、その他のファイルを WeChat サーバーにアップロードできます。パブリック アカウントは、対応する media_id を返します。この media_id に基づいてマルチメディアを取得します。 media_id は再利用可能であり、このインターフェイスを呼び出すには http プロトコルが必要であることに注意してください。
通常、ファイルアップロードはHTMLフォームを通じて行われますが、CURLを利用することでブラウザを経由せずにサーバー側で直接フォームPOSTを送信することでファイルアップロード機能を完了することができます。
ファイル名は完全な絶対パスである必要があり、絶対パスの前に「@」を付けて区別する必要があることに注意してください。
Windows サーバーの形式の例は「@F:israeluploadWinter.jpg」、Linux サーバーの形式の例は「@home/israel/upload/Winter.jpg」です。
httpリクエストメソッド: POST/FORM
http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
パラメータの説明
パラメータ |
必要ですか |
説明 |
access_token |
は |
クーポン |
タイプ |
は | です画像、音声、ビデオ、サムネイルを含むメディアファイルタイプ |
media |
はフォームデータ内の |
メディアです ファイル名、ファイル長、コンテンツタイプおよびその他の情報を含むファイル識別 |
写真をアップロード
結果を返す
{ "type": "image", "media_id": "QQ9nj-7ctrqA8t3WKU3dQN24IuFV_516MfZRZNnQ0c-BFVkk66jUkPXF49QE9L1l", "created_at": 1389793969}
音声をアップロード
結果を返す
rreee
ビデオをアップロード
結果を返す
すごいサムネイルをアップロード
結果を返す
{ "type": "voice", "media_id": "5Idx79V9E3XfBCz_A50gr1a1_klgPpJnb_eq73yz0bn-prhIsNlwI3n6jQgshmWk", "created_at": 1389794760}
パラメータの説明
パラメータ |
説明 |
type |
写真(画像)、音声(音声)、ビデオ(ビデオ)、サムネイル(主にサムネイルに使用されるサムネイル)を含むメディアファイルタイプビデオおよび音楽形式) |
media_id |
メディア ファイルがアップロードされた後、取得された一意の識別子 |
created_at |
メディア ファイルのアップロード タイムスタンプ |
注意事项
上传的多媒体文件有格式和大小限制,如下:
图片(image): 128K,支持JPG格式
语音(voice):256K,播放长度不超过60s,支持AMR\MP3格式
视频(video):1MB,支持MP4格式
缩略图(thumb):64KB,支持JPG格式
媒体文件在后台保存时间为3天,即3天后media_id失效。对于需要重复使用的多媒体文件,可以每3天循环上传一次,更新media_id。
二、下载多媒体文件
公众号可调用本接口来获取多媒体文件。请注意,视频文件不支持下载,调用该接口需http协议。
下载文件使用获取图片数据,写入新文件的方法。
http请求方式: GET
http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
参数说明
参数 |
是否必须 |
说明 |
access_token |
是 |
调用接口凭证 |
media_id |
是 |
媒体文件ID |
下载图片
代码实现
返回HTTP头示例如下
{ "url": "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=My4oqLEyFVrgFF-XOZagdvbTt9XywYjGwMg_GxkPwql7-f0BpnvXFCOKBUyAf0agmZfMChW5ECSyTAgAoaoU2WMyj7aVHmB17ce4HzLRZ3XFTbm2vpKt_9gYA29xrwIKpnvH-BYmNFSddt7re5ZrIg&media_id=QQ9nj-7ctrqA8t3WKU3dQN24IuFV_516MfZRZNnQ0c-BFVkk66jUkPXF49QE9L1l", "content_type": "image/jpeg", "http_code": 200, "header_size": 308, "request_size": 316, "filetime": -1, "ssl_verify_result": 0, "redirect_count": 0, "total_time": 1.36, "namelookup_time": 1.016, "connect_time": 1.078, "pretransfer_time": 1.078, "size_upload": 0, "size_download": 105542, "speed_download": 77604, "speed_upload": 0, "download_content_length": 105542, "upload_content_length": 0, "starttransfer_time": 1.141, "redirect_time": 0}
下载语音
代码实现
返回HTTP头如下
{ "url": "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=My4oqLEyFVrgFF-XOZagdvbTt9XywYjGwMg_GxkPwql7-f0BpnvXFCOKBUyAf0agmZfMChW5ECSyTAgAoaoU2WMyj7aVHmB17ce4HzLRZ3XFTbm2vpKt_9gYA29xrwIKpnvH-BYmNFSddt7re5ZrIg&media_id=5Idx79V9E3XfBCz_A50gr1a1_klgPpJnb_eq73yz0bn-prhIsNlwI3n6jQgshmWk", "content_type": "audio/amr", "http_code": 200, "header_size": 306, "request_size": 316, "filetime": -1, "ssl_verify_result": 0, "redirect_count": 0, "total_time": 0.125, "namelookup_time": 0.031, "connect_time": 0.063, "pretransfer_time": 0.063, "size_upload": 0, "size_download": 10470, "speed_download": 83760, "speed_upload": 0, "download_content_length": 10470, "upload_content_length": 0, "starttransfer_time": 0.125, "redirect_time": 0}
可以看出,MP3的语音格式被压缩成AMR格式了。
下载缩略图
实现代码
返回HTTP头如下
{ "url": "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=My4oqLEyFVrgFF-XOZagdvbTt9XywYjGwMg_GxkPwql7-f0BpnvXFCOKBUyAf0agmZfMChW5ECSyTAgAoaoU2WMyj7aVHmB17ce4HzLRZ3XFTbm2vpKt_9gYA29xrwIKpnvH-BYmNFSddt7re5ZrIg&media_id=2RhP0caRKHVOmZO5AKelHkK--vqPPwgUaRp5-WE63dvmmPRWiYVKgvNblIp_gv79", "content_type": "image/jpeg", "http_code": 200, "header_size": 306, "request_size": 316, "filetime": -1, "ssl_verify_result": 0, "redirect_count": 0, "total_time": 0.094, "namelookup_time": 0, "connect_time": 0.047, "pretransfer_time": 0.047, "size_upload": 0, "size_download": 6057, "speed_download": 64436, "speed_upload": 0, "download_content_length": 6057, "upload_content_length": 0, "starttransfer_time": 0.094, "redirect_time": 0}
至于回复相应的消息,就是利用消息接口或者客服接口,构造成相应的消息就行了,和构造文本,图文消息的方法是一样的。
更多微信公众平台开发 上传下载多媒体文件 相关文章请关注PHP中文网!