账户中心 退出系统
开发文档 资讯·分享 技术交流 会员登录
phpGrace GSCMS 公众号系统
永久素材管理

素材操作概述

公众号可以添加永久素材和临时素材,graceWeChat 封装了永久素材相关的操作( 临时素材不太常用 ),如果需要临时素材操作请参考公众号官方手册,利用 gracWeChat 对象的 getAccessToen() 函数、curlGet() 函数请求官方api 即可。

1 uploadForeverMedia() 添加永久素材

参数 1 : $mediaFile 本地文件地址
参数 2 : $info = array('type'=>'image') 数组形式的素材数据
示例 : 

<?php
class indexController extends grace{
    public $graceWeChat;
    public function __construct(){
        parent::__construct();
        $this->graceWeChat                  = new \phpGrace\tools\graceWeChat();
    }
    public function index(){
        // 实例化 素材操作对象
        $material = new \phpGrace\tools\graceWeChat\material($this->graceWeChat);
        // 新增永久素材 [ 从服务器到微信公众号 ]
        $res = $material->uploadForeverMedia('./demo.png');
        // 查询永久素材列表
        $res      = $material->getForeverMaterial();
        p($res);
    }
}

2 getForeverMaterial() 获取永久素材列表

参数 1 : $type 获取的文件类型:图片(image)、视频(video)、语音 (voice)、图文(news)
参数 2 : $offset 偏移位置,0表示从第一个素材返回,默认0
参数 3 : $count  素材的数量,取值在1到20之间,默认20
示例 : 

<?php
class indexController extends grace{
    public $graceWeChat;
    public function __construct(){
        parent::__construct();
        $this->graceWeChat = new \phpGrace\tools\graceWeChat();
    }
    public function index(){
        // 实例化 素材操作对象
        $material = new \phpGrace\tools\graceWeChat\material($this->graceWeChat);
        // 查询永久素材列表
        $res      = $material->getForeverMaterial();
        p($res);
    }
}

3 getForeverMaterialQuantity() 获取永久素材总数

参数 1 : $type 获取的文件类型:图片(image)、视频(video)、语音 (voice)、图文(news)默认 all (全部)
返回值 :
type = all :  Array (    [voice_count] => 0    [video_count] => 0    [image_count] => 2    [news_count] => 0 )
type = 其他 : 对应数量值
官方手册 : https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Get_the_total_of_all_materials.html
示例 : 

<?php
class indexController extends grace{
    public $graceWeChat;
    public function __construct(){
        parent::__construct();
        $this->graceWeChat = new \phpGrace\tools\graceWeChat();
    }
    public function index(){
        // 实例化 素材操作对象
        $material = new \phpGrace\tools\graceWeChat\material($this->graceWeChat);
        // 查询永久素材数量
        $res      = $material->getForeverMaterialQuantity();
        p($res);
    }
}

4 getMaterial() 获取单个素材

参数 1 : $mediaid 素材id
返回数据请查阅官网 : https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Getting_Permanent_Assets.html
示例 : 

<?php
class indexController extends grace{
    public $graceWeChat;
    public function __construct(){
        parent::__construct();
        $this->graceWeChat                  = new \phpGrace\tools\graceWeChat();
    }
    public function index(){
        // 实例化 素材操作对象
        $material = new \phpGrace\tools\graceWeChat\material($this->graceWeChat);
        $res      = $material->getMaterial('7G6PblwGzzSQ-pszqg0lYyHEjBSMiVqrHzQJqPuiAnA');
        p($res);
    }
}

5 removeForeverMaterial() 删除单个素材

参数 1 : $mediaid 素材id
返回 : 对象形式的执行结果
示例 : 

<?php
class indexController extends grace{
    public $graceWeChat;
    public function __construct(){
        parent::__construct();
        $this->graceWeChat = new \phpGrace\tools\graceWeChat();
    }
    public function index(){
        // 实例化 素材操作对象
        $material = new \phpGrace\tools\graceWeChat\material($this->graceWeChat);
        // 删除素材
        $res      = $material->removeForeverMaterial('7G6PblwGzzSQ-pszqg0lYw1YPfhUjOgJ4a6zZxI93sc');
        p($res);
        // 查询永久素材列表
        $res      = $material->getForeverMaterial();
        p($res);
        exit();
    }
}