cn.ipokerface.weixin.mp.proxy

类 MediaProxy

java.lang.Object

cn.ipokerface.weixin.proxy.AbstractProxy

cn.ipokerface.weixin.mp.proxy.MPlatformProxy

cn.ipokerface.weixin.mp.proxy.MediaProxy

直接已知子类:

ArticleProxy

public class MediaProxy
extends MPlatformProxy

Created by PokerFace Create Date 2019-12-28. Email: 214888341@163.com Version 1.0.0

Description:

字段概要

从类继承的字段 cn.ipokerface.weixin.mp.proxy.MPlatformProxy

tokenManager

从类继承的字段 cn.ipokerface.weixin.proxy.AbstractProxy

weixinRequestClient

构造器概要

构造器

构造器和说明
MediaProxy(TokenManager tokenManager)

方法概要

限定符和类型	方法和说明
MediaCounter	countMaterialMedia() 获取永久媒体素材的总数 .图片和图文消息素材（包括单图文和多图文）的总数上限为5000，其他素材的总数上限为1000
ApiResult	deleteMaterialMedia(String mediaId) 删除永久媒体素材
List<MpArticle>	downloadArticle(String mediaId) 下载永久图文素材
MediaDownloadResult	downloadMedia(String mediaId, boolean isMaterial) 下载媒体素材
List<MediaItem>	listAllMaterialMedia(MediaType mediaType) 获取全部的媒体素材
MediaRecord	listMaterialMedia(MediaType mediaType, Pageable pageable) 获取媒体素材记录列表
ApiResult	updateMaterialArticle(String mediaId, int index, MpArticle article) 更新永久图文素材
String	uploadImage(InputStream is, String fileName) 上传图片获取URL 请注意，本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。
String	uploadMaterialArticle(List<MpArticle> articles) 上传永久图文素材 、新增的永久素材也可以在公众平台官网素材管理模块中看到,永久素材的数量是有上限的，请谨慎新增。
String	uploadMaterialVideo(InputStream is, String fileName, String title, String introduction) 上传永久视频素材
MediaUploadResult	uploadMedia(boolean isMaterial, InputStream is, String fileName) 上传媒体文件:图片（image）、语音（voice）、视频(video)和缩略图（thumb） 此接口只包含图片、语音、缩略图、视频(临时)四种媒体类型的上传 正常情况下返回{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}, 否则抛出异常.
MpVideoMessageTuple	uploadVideo(InputStream is, String fileName, String title, String description) 上传群发中的视频素材

从类继承的方法 cn.ipokerface.weixin.mp.proxy.MPlatformProxy

getTokenManager

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

MediaProxy

public MediaProxy(TokenManager tokenManager)

方法详细资料

uploadImage

public String uploadImage(InputStream is,
                          String fileName)
                   throws WeixinException

上传图片获取URL 请注意，本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。图片仅支持jpg/png格式，大小必须在1MB以下。

参数:

is - 图片数据流

fileName - 文件名 为空时将自动生成

返回:

图片URL 可用于群发消息中的图片链接和创建卡券logo链接

抛出:

WeixinException

uploadVideo

public MpVideoMessageTuple uploadVideo(InputStream is,
                                       String fileName,
                                       String title,
                                       String description)
                                throws WeixinException

上传群发中的视频素材

参数:

is - 图片数据流

fileName - 文件名 为空时将自动生成

title - 视频标题 非空

description - 视频描述 可为空

返回:

群发视频消息对象

抛出:

WeixinException

另请参阅:

高级群发, MpVideoMessageTuple

uploadMedia

public MediaUploadResult uploadMedia(boolean isMaterial,
                                     InputStream is,
                                     String fileName)
                              throws WeixinException

上传媒体文件:图片（image）、语音（voice）、视频(video)和缩略图（thumb） 此接口只包含图片、语音、缩略图、视频(临时)四种媒体类型的上传 正常情况下返回{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}, 否则抛出异常.

参数:

isMaterial - 是否永久上传

is - 媒体数据流

fileName - 文件名

返回:

上传到微信服务器返回的媒体标识

抛出:

WeixinException

另请参阅:

上传临时素材, 上传永久素材, MediaUploadResult, MediaType

downloadMedia

public MediaDownloadResult downloadMedia(String mediaId,
                                         boolean isMaterial)
                                  throws WeixinException

下载媒体素材

参数:

mediaId - 媒体ID

isMaterial - 是否下载永久素材

返回:

媒体下载结果

抛出:

WeixinException

另请参阅:

MediaDownloadResult, 下载临时媒体素材, 下载永久媒体素材

uploadMaterialArticle

public String uploadMaterialArticle(List<MpArticle> articles)
                             throws WeixinException

上传永久图文素材

、新增的永久素材也可以在公众平台官网素材管理模块中看到,永久素材的数量是有上限的，请谨慎新增。图文消息素材和图片素材的上限为5000， 其他类型为1000

参数:

articles - 图文列表

返回:

上传到微信服务器返回的媒体标识

抛出:

WeixinException

另请参阅:

上传永久媒体素材, MpArticle

downloadArticle

public List<MpArticle> downloadArticle(String mediaId)
                                throws WeixinException

下载永久图文素材

参数:

mediaId - 媒体ID

返回:

图文列表

抛出:

WeixinException

另请参阅:

MpArticle

updateMaterialArticle

public ApiResult updateMaterialArticle(String mediaId,
                                       int index,
                                       MpArticle article)
                                throws WeixinException

更新永久图文素材

参数:

mediaId - 要修改的图文消息的id

index - 要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0

article - 图文对象

返回:

处理结果

抛出:

WeixinException

另请参阅:

MpArticle, 更新永久图文素材

deleteMaterialMedia

public ApiResult deleteMaterialMedia(String mediaId)
                              throws WeixinException

删除永久媒体素材

参数:

mediaId - 媒体素材的media_id

返回:

处理结果

抛出:

WeixinException

另请参阅:

删除永久媒体素材

uploadMaterialVideo

public String uploadMaterialVideo(InputStream is,
                                  String fileName,
                                  String title,
                                  String introduction)
                           throws WeixinException

上传永久视频素材

参数:

is - 大小不超过1M且格式为MP4的视频文件

fileName - 文件名 为空时将自动生成

title - 视频标题

introduction - 视频描述

返回:

上传到微信服务器返回的媒体标识

抛出:

WeixinException

另请参阅:

上传永久媒体素材

countMaterialMedia

public MediaCounter countMaterialMedia()
                                throws WeixinException

获取永久媒体素材的总数 .图片和图文消息素材（包括单图文和多图文）的总数上限为5000，其他素材的总数上限为1000

返回:

总数对象

抛出:

WeixinException

另请参阅:

MediaCounter, 获取素材总数

listMaterialMedia

public MediaRecord listMaterialMedia(MediaType mediaType,
                                     Pageable pageable)
                              throws WeixinException

获取媒体素材记录列表

参数:

mediaType - 素材的类型，图片（image）、视频（video）、语音 （voice）、图文（news）

pageable - 分页数据

返回:

媒体素材的记录对象

抛出:

WeixinException

另请参阅:

MediaRecord, MediaType, MediaItem, Pageable, PageData, 获取素材列表

listAllMaterialMedia

public List<MediaItem> listAllMaterialMedia(MediaType mediaType)
                                     throws WeixinException

获取全部的媒体素材

参数:

mediaType - 媒体类型

返回:

素材列表

抛出:

WeixinException