开发者指南
更新时间：2022-08-25
多模态媒资检索
MMS 支持对BOS媒资、VOD媒资、URL媒资检索。对于不同来源的视频，需要按照如下规则拼接媒资路径source:
- 对于 BOS 视频，
source=bos://{bucket}/{object} - 对于 VOD 媒资原视频，
source=vod://{mediaId} - 对于 VOD 媒资转码后视频，
source="vod://<vod-media-id>-<preset>" - 对于 URL 视频，
source="<http(s)-url">
发起多模态媒资检索
指定媒资路径发起多模态媒资检索。
创建视频库
本接口用于创建视频库。
代码示例：
public MmsBaseResponse createVideoLib(CreateLibRequest request) {
mmsClient.createVideoLib(request);
}视频入库
根据BOS bucket和BOS key直接发起视频入库。需要说明，使用本方法需要将object配置公共GetObject权限，参考设置BOS bucket权限。简述为：在BOS 的控制台中 Bucket 设置-权限设置-自定义权限中添加 MMS 服务账号： 4523a498c3de4c9ab330f376d1bc2c2d。
代码示例：
public void insertVideo(MmsClient mmsClient, String libName, SourceAndDescRequest request) {
mmsClient.insertVideo(libName, request);
}根据视频ID查询视频入库结果
本接口用于查询视频入库结果。
代码示例：
public void getInsertVideoResultById(String libId, String mediaId) {
mmsClient.getInsertVideoResultById(libId, mediaId);
}创建图片库
本接口用于创建图片库。
代码示例：
public MmsBaseResponse createImageLib(CreateLibRequest request) {
mmsClient.createImageLib(request);
}图片入库
本接口用于向图片库中插入图片特征。
代码示例：
public void insertImage(MmsClient mmsClient, String libName, SourceAndDescRequest request) {
mmsClient.insertImage(libName, request);
}视频检索视频
本接口使用视频来检索库中存在的相似视频。
代码示例：
public void searchVideoByVideo(MmsClient mmsClient, String libName, SourceAndDescRequest request) {
mmsClient.searchVideoByVideo(libName, request);
}查询视频检索视频结果
本接口用于查询视频检索视频任务的结果。
代码示例：
public void getSearchVideoByVideoResultById(String libName, String taskId) {
mmsClient.getSearchVideoByVideoResultById(libName, taskId);
}图片检索图片
本接口使用图片来检索库中存在的相似图片。
代码示例：
public void searchImageByImage(MmsClient mmsClient, String libName, SourceAndDescRequest request) {
mmsClient.searchImageByImage(libName, request);
}图片检索视频
本接口使用图片来检索库中存在的包含相似图片的视频。
代码示例：
public void searchVideoByImage(MmsClient mmsClient, String libName, SourceAndDescRequest request) {
mmsClient.searchVideoByImage(libName, request);
}删除视频库中的视频特征
本接口用于删除视频库中某个视频的特征。
代码示例：
public void deleteVideoById(String libId, String mediaId) {
mmsClient.deleteVideoById(libId, mediaId);
}删除图片库中的图片特征
本接口用于删除图片库中某张图片的特征。
代码示例：
public void deleteImageById(String libId, String mediaId) {
mmsClient.deleteImageById(libId, mediaId);
}查询视频库中视频列表
本接口用于查询视频库中视频列表。
代码示例：
public void listVideo(ListMediaRequest request) {
mmsClient.listMedia(request);
}查询图片库中图片列表
本接口用于查询图片库中图片列表。
代码示例：
public void listImage(ListMediaRequest request) {
mmsClient.listMedia(request);
}删除视频库
本接口用于删除视频库。
代码示例：
public void deleteVideoLib(String libId) {
mmsClient.deleteVideoLib(libId);
}删除图片库
本接口用于删除图片库。
代码示例：
public deleteImageLib(String libId) {
mmsClient.deleteImageLib(libId);
}说明：
各参数含义参考MMS API。