#素材管理 ## 臨時素材 ####介紹 對于臨時素材，每個素材（media_id）會在開發者上傳或粉絲發送到微信服務器3天后自動刪除（所以用戶發送給開發者的素材，若開發者需要，應盡快下載到本地），以節省服務器資源。 <a href="http://mp.weixin.qq.com/wiki/5/963fc70b80dc75483a271298a76a8d59.html" target="_blank">查看官方文檔</a> **大小限制** * 圖片（image）: 1M，支持JPG格式 * 語音（voice）：2M，播放長度不超過60s，支持AMR\MP3格式 * 視頻（video）：10MB，支持MP4格式 * 縮略圖（thumb）：64KB，支持JPG格式 >臨時素材微信官網保存3天 ``` $d = Weixin::instance('material')->upload('image','1.png'); p($d); ``` ####新增臨時素材 ``` $media = Weixin::instance('material')->upload('image', '1.png',1); ``` ####下載臨時素材 ``` //上傳圖片素材 $result = Weixin::instance('material')->upload('image', '1.png',1); //下載素材到本地 參數: media_id 保存的文件名 Weixin::instance('material')->download($result['media_id'],'1_bak.png'); ``` ##永久素材 ####介紹 * 新增的永久素材也可以在公眾平臺官網素材管理模塊中看到 * 永久素材的數量是有上限的，請謹慎新增。圖文消息素材和圖片素材的上限為5000，其他類型為1000 ####新增其他類型永久素材 ``` $data = Weixin::instance('material')->upload('image', '1.png', 0); p($data); ``` ####獲取永久素材 ``` //$media_id 為素材media_id $result = Weixin::instance('material')->getMaterial($media_id); ``` ####刪除永久素材 ``` //$media_id 為素材media_id $result = Weixin::instance('material')->delete($media_id); ``` ####新增永久圖文素材 ``` //新增永久素材（用于測試上傳圖文素材） $articles = array( 'articles' => array( array( 'title' => '后盾網', //圖文消息的封面圖片素材id（必須是永久mediaID） 'thumb_media_id' => $data['media_id'], //作者 'author' => '后盾網', //圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空 'digest' => '摘要信息...', //1 顯示封面 0 不顯示 'show_cover_pic' => 1, //圖文內容，必須少于2萬字符 'content' => '圖文內容...', //圖文消息的原文地址，即點擊“閱讀原文”后的URL 'content_source_url' => 'http://houdunwang.com' ) ) ); //添加圖文,返回為新增的圖文消息素材的media_id。 $result = Weixin::instance('material')->addNews($articles); echo $result['media_id']; ``` ####修改永久圖文素材 ``` $article = array( //要修改的圖文消息的id "media_id" => 'xxxxx', //要更新的文章在圖文消息中的位置（多圖文消息時，此字段才有意義），第一篇為0 "index" => 0, 'articles' => array( array( 'title' => '后盾網', //圖文消息的封面圖片素材id（必須是永久mediaID） 'thumb_media_id' => $data['media_id'], //作者 'author' => '后盾網', //圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空 'digest' => '摘要信息...', //1 顯示封面 0 不顯示 'show_cover_pic' => 1, //圖文內容，必須少于2萬字符 'content' => '圖文內容...', //圖文消息的原文地址，即點擊“閱讀原文”后的URL 'content_source_url' => 'http://houdunwang.com' ) ) ); $result = Weixin::instance('material')->editNews($article); ``` ####獲取素材總數 圖片和圖文消息素材（包括單圖文和多圖文）的總數上限為5000，其他素材的總數上限為1000 ``` $result = Weixin::instance('material')->total(); ``` ####獲取素材列表 ``` $param = array( //素材的類型，圖片（image）、視頻（video）、語音 （voice）、圖文（news） "type" => 'image', //從全部素材的該偏移位置開始返回，0表示從第一個素材 返回 "offset" => 0, //返回素材的數量，取值在1到20之間 "count" => 10 ); $result = Weixin::instance('material')->lists($param); ```