您的浏览器已禁用 JavaScript。
跳过导航链接
me.chanjar.weixin.mp.api.impl

类 WxMpMaterialServiceImpl

    • 构造器详细资料

      • WxMpMaterialServiceImpl

        public WxMpMaterialServiceImpl()

    • 方法详细资料

      • mediaUpload

        public WxMediaUploadResult mediaUpload(String mediaType,
 File file)
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         新增临时素材
 公众号经常有需要用到一些临时性的多媒体素材的场景,例如在使用接口特别是发送消息时,对多媒体文件、多媒体消息的获取和调用等操作,是通过media_id来进行的。
 素材管理接口对所有认证的订阅号和服务号开放。通过本接口,公众号可以新增临时素材(即上传临时多媒体文件)。
 请注意:
 1、对于临时素材,每个素材(media_id)会在开发者上传或粉丝发送到微信服务器3天后自动删除(所以用户发送给开发者的素材,若开发者需要,应尽快下载到本地),以节省服务器资源。
 2、media_id是可复用的。
 3、素材的格式大小等要求与公众平台官网一致。具体是,图片大小不超过2M,支持png/jpeg/jpg/gif格式,语音大小不超过5M,长度不超过60秒,支持mp3/amr格式
 4、需使用https调用本接口。
 本接口即为原"上传多媒体文件"接口。
 注意事项:
 上传的临时多媒体文件有格式和大小限制,如下:
 图片(image): 2M,支持PNG\JPEG\JPG\GIF格式
 语音(voice):2M,播放长度不超过60s,支持AMR\MP3格式
 视频(video):10MB,支持MP4格式
 缩略图(thumb):64KB,支持JPG格式
 媒体文件在后台保存时间为3天,即3天后media_id失效。
 详情请见: 新增临时素材
 接口url格式:https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
        指定者:
        mediaUpload 在接口中 WxMpMaterialService
        参数:
        mediaType - 媒体类型, 请看WxConsts
        file - 文件对象
        返回:
        the wx media upload result
        抛出:
        WxErrorException - the wx error exception
        另请参阅:
        #mediaUpload(String, String, InputStream)#mediaUpload(String, String, InputStream)

      • mediaDownload

        public File mediaDownload(String mediaId)
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         获取临时素材
 公众号可以使用本接口获取临时素材(即下载临时的多媒体文件)。请注意,视频文件不支持https下载,调用该接口需http协议。
 本接口即为原"下载多媒体文件"接口。
 根据微信文档,视频文件下载不了,会返回null
 详情请见: 获取临时素材
 接口url格式:https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
        指定者:
        mediaDownload 在接口中 WxMpMaterialService
        参数:
        mediaId - 媒体文件Id
        返回:
        保存到本地的临时文件 file
        抛出:
        WxErrorException - the wx error exception

      • jssdkMediaDownload

        public File jssdkMediaDownload(String mediaId)
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         获取高清语音素材
 公众号可以使用本接口获取从JSSDK的uploadVoice接口上传的临时语音素材,格式为speex,16K采样率。
 该音频比上文的临时素材获取接口(格式为amr,8K采样率)更加清晰,适合用作语音识别等对音质要求较高的业务。
 详情请见: 
 获取高清语音素材
 接口url格式:https://api.weixin.qq.com/cgi-bin/media/get/jssdk?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
        指定者:
        jssdkMediaDownload 在接口中 WxMpMaterialService
        参数:
        mediaId - 媒体文件Id
        返回:
        保存到本地的临时文件 file
        抛出:
        WxErrorException - the wx error exception

      • mediaImgUpload

        public WxMediaImgUploadResult mediaImgUpload(File file)
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         上传图文消息内的图片获取URL
 请注意,本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。图片仅支持jpg/png格式,大小必须在1MB以下。
 详情请见: 新增永久素材
 接口url格式:https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
        指定者:
        mediaImgUpload 在接口中 WxMpMaterialService
        参数:
        file - 上传的文件对象
        返回:
        WxMediaImgUploadResult 返回图片url
        抛出:
        WxErrorException - the wx error exception

      • materialFileUpload

        public WxMpMaterialUploadResult materialFileUpload(String mediaType,
 WxMpMaterial material)
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         新增非图文永久素材
 通过POST表单来调用接口,表单id为media,包含需要上传的素材内容,有filename、filelength、content-type等信息。请注意:图片素材将进入公众平台官网素材管理模块中的默认分组。
 新增永久视频素材需特别注意:
 在上传视频素材时需要POST另一个表单,id为description,包含素材的描述信息,内容格式为JSON,格式如下:
 { "title":VIDEO_TITLE, "introduction":INTRODUCTION }
 详情请见: 新增永久素材
 接口url格式:https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE
 除了3天就会失效的临时素材外,开发者有时需要永久保存一些素材,届时就可以通过本接口新增永久素材。
 永久图片素材新增后,将带有URL返回给开发者,开发者可以在腾讯系域名内使用(腾讯系域名外使用,图片将被屏蔽)。
 请注意:
 1、新增的永久素材也可以在公众平台官网素材管理模块中看到
 2、永久素材的数量是有上限的,请谨慎新增。图文消息素材和图片素材的上限为5000,其他类型为1000
 3、素材的格式大小等要求与公众平台官网一致。具体是,图片大小不超过2M,支持bmp/png/jpeg/jpg/gif格式,语音大小不超过5M,长度不超过60秒,支持mp3/wma/wav/amr格式
 4、调用该接口需https协议
        指定者:
        materialFileUpload 在接口中 WxMpMaterialService
        参数:
        mediaType - 媒体类型, 请看WxConsts
        material - 上传的素材, 请看WxMpMaterial
        返回:
        the wx mp material upload result
        抛出:
        WxErrorException - the wx error exception

      • materialNewsUpload

        public WxMpMaterialUploadResult materialNewsUpload(WxMpMaterialNews news)
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         新增永久图文素材
 详情请见: 新增永久素材
 接口url格式:https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN
 除了3天就会失效的临时素材外,开发者有时需要永久保存一些素材,届时就可以通过本接口新增永久素材。
 永久图片素材新增后,将带有URL返回给开发者,开发者可以在腾讯系域名内使用(腾讯系域名外使用,图片将被屏蔽)。
 请注意:
 1、新增的永久素材也可以在公众平台官网素材管理模块中看到
 2、永久素材的数量是有上限的,请谨慎新增。图文消息素材和图片素材的上限为5000,其他类型为1000
 3、素材的格式大小等要求与公众平台官网一致。具体是,图片大小不超过2M,支持bmp/png/jpeg/jpg/gif格式,语音大小不超过5M,长度不超过60秒,支持mp3/wma/wav/amr格式
 4、调用该接口需https协议
        指定者:
        materialNewsUpload 在接口中 WxMpMaterialService
        参数:
        news - 上传的图文消息, 请看WxMpMaterialNews
        返回:
        the wx mp material upload result
        抛出:
        WxErrorException - the wx error exception

      • materialDelete

        public boolean materialDelete(String mediaId)
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         删除永久素材
 在新增了永久素材后,开发者可以根据本接口来删除不再需要的永久素材,节省空间。
 请注意:
 1、请谨慎操作本接口,因为它可以删除公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材(但需要先通过获取素材列表来获知素材的media_id)
 2、临时素材无法通过本接口删除
 3、调用该接口需https协议
 详情请见: 删除永久素材
 接口url格式:https://api.weixin.qq.com/cgi-bin/material/del_material?access_token=ACCESS_TOKEN
        指定者:
        materialDelete 在接口中 WxMpMaterialService
        参数:
        mediaId - 永久素材的id
        返回:
        the boolean
        抛出:
        WxErrorException - the wx error exception

      • materialCount

        public WxMpMaterialCountResult materialCount()
 throws WxErrorException
        从接口复制的说明: WxMpMaterialService 
         获取各类素材总数
 开发者可以根据本接口来获取永久素材的列表,需要时也可保存到本地。
 请注意:
 1.永久素材的总数,也会计算公众平台官网素材管理中的素材
 2.图片和图文消息素材(包括单图文和多图文)的总数上限为5000,其他素材的总数上限为1000
 3.调用该接口需https协议
 详情请见: 获取素材总数
 接口url格式:https://api.weixin.qq.com/cgi-bin/material/get_materialcount?access_token=ACCESS_TOKEN
        指定者:
        materialCount 在接口中 WxMpMaterialService
        返回:
        the wx mp material count result
        抛出:
        WxErrorException - the wx error exception
跳过导航链接

Copyright © 2024. All rights reserved.

AltStyle によって変換されたページ (->オリジナル) /