me.chanjar.weixin.cp.tp.service.WxCpTpMediaService Maven / Gradle / Ivy
package me.chanjar.weixin.cp.tp.service;
import me.chanjar.weixin.common.bean.result.WxMediaUploadResult;
import me.chanjar.weixin.common.error.WxErrorException;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
/**
*
* 媒体管理接口.
* Created by BinaryWang on 2017/6/24.
*
*
* @author Binary Wang
*/
public interface WxCpTpMediaService {
/**
*
* 上传多媒体文件.
* 上传的多媒体文件有格式和大小限制，如下：
* 图片（image）: 1M，支持JPG格式
* 语音（voice）：2M，播放长度不超过60s，支持AMR\MP3格式
* 视频（video）：10MB，支持MP4格式
* 缩略图（thumb）：64KB，支持JPG格式
* 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=上传下载多媒体文件
*
*
* @param mediaType 媒体类型, 请看{@link me.chanjar.weixin.common.api.WxConsts}
* @param fileType 文件类型，请看{@link me.chanjar.weixin.common.api.WxConsts}
* @param inputStream 输入流，需要调用方控制关闭该输入流
* @param corpId the corp id
* @return the wx media upload result
* @throws WxErrorException the wx error exception
* @throws IOException the io exception
*/
WxMediaUploadResult upload(String mediaType, String fileType, InputStream inputStream, String corpId)
throws WxErrorException, IOException;
/**
* 上传多媒体文件.
*
* @param mediaType 媒体类型
* @param file 文件对象
* @param corpId 授权企业的corpid
* @return the wx media upload result
* @throws WxErrorException 异常信息
* @see #upload(String, String, InputStream, String) #upload(String, String, InputStream, String)
*/
WxMediaUploadResult upload(String mediaType, File file, String corpId) throws WxErrorException;
/**
*
* 上传图片.
* 上传图片得到图片URL，该URL永久有效
* 返回的图片URL，仅能用于图文消息（mpnews）正文中的图片展示；若用于非企业微信域名下的页面，图片将被屏蔽。
* 每个企业每天最多可上传100张图片
* 接口url格式：https://qyapi.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
*
*
* @param file 上传的文件对象
* @param corpId 授权企业的corpid
* @return 返回图片url string
* @throws WxErrorException 异常信息
*/
String uploadImg(File file, String corpId) throws WxErrorException;
}