有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

简介

本文档提供关于直播审核接口相关的 API 概览以及 SDK 示例代码。
API
操作描述
本接口用于提交一个直播流审核任务。直播流审核功能为异步任务方式,您可以通过提交直播流审核任务审核您的直播流,然后通过查询直播流审核任务接口查询审核结果
本接口用于主动查询指定的直播审核任务结果。直播审核功能为异步任务方式,您可以通过提交直播审核任务审核您的直播流,然后通过查询直播审核任务接口轮询获取审核结果
本接口用于取消一个在进行中的直播审核任务,成功取消后将返回已终止任务的 JobID

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参考 SDK API

提交直播审核

功能说明

本接口用于提交一个直播流审核任务。直播流审核功能为异步任务方式,您可以通过提交直播流审核任务审核您的直播流,然后通过查询直播流审核任务接口查询审核结果。
注意
COS Android SDK 版本需要大于等于 v5.9.14。

示例代码

// 存储桶名称,格式为 BucketName-APPID
String bucket = "examplebucket-1250000000";
// 直播的链接地址
String url = "rtmp://xxx.com/live";
PostLiveVideoAuditRequest request = new PostLiveVideoAuditRequest(bucket);
PostLiveVideoAudit postLiveVideoAudit = new PostLiveVideoAudit();
PostLiveVideoAudit.PostLiveVideoAuditInput input = new PostLiveVideoAudit.PostLiveVideoAuditInput();
// 需要审核的直播流播放地址,例如 rtmp://example.com/live/123。;是否必传:是;
input.url = url;
// 该字段在审核结果中会返回原始内容,长度限制为512字节。您可以使用该字段对待审核的数据进行唯一业务标识。;是否必传:否;
input.dataId = "dataId";
postLiveVideoAudit.input = input;
PostLiveVideoAudit.PostLiveVideoAuditConf conf = new PostLiveVideoAudit.PostLiveVideoAuditConf();
// 表示审核策略的唯一标识,您可以通过控制台上的审核策略页面,配置您希望审核的场景,例如涉黄、广告、违法违规等,配置指引: 设置审核策略。您可以在控制台上获取BizType。BizType 填写时,此条审核请求将按照该审核策略中配置的场景进行审核。BizType 不填写时��将自动使用默认的审核策略。;是否必传:是;
conf.bizType = "b81d45f94b91a683255e9a9506f45a11";
// 回调地址,以http://或者https://开头的地址。;是否必传:否;
conf.callback = "https://xxx.com";
// 回调片段类型,有效值:1(回调全部截帧和音频片段)、2(仅回调违规截帧和音频片段)。默认为 1。;是否必传:否;
conf.callbackType = 1;
postLiveVideoAudit.conf = conf;
request.setPostLiveVideoAudit(postLiveVideoAudit);
ciService.postLiveVideoAuditAsync(request, new CosXmlResultListener() {
@Override
public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
// result 提交直播审核任务的结果
// 详细字段请查看api文档或者SDK源码
PostLiveVideoAuditResult result = (PostLiveVideoAuditResult) cosResult;
}
@Override
public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
if (clientException != null) {
clientException.printStackTrace();
} else {
serviceException.printStackTrace();
}
}
});
说明
更多完整示例,请前往 GitHub 查看。

查询直播审核结果

功能说明

本接口用于主动查询指定的直播审核任务结果。直播审核功能为异步任务方式,您可以通过提交直播审核任务审核您的直播流,然后通过查询直播审核任务接口轮询获取审核结果。
注意
COS Android SDK 版本需要大于等于 v5.9.14。

示例代码

// 存储桶名称,格式为 BucketName-APPID
String bucket = "examplebucket-1250000000";
// 审核任务的 ID
String jobId = "iab1ca9fc8a3ed11ea834c525400863904";
GetLiveVideoAuditRequest request = new GetLiveVideoAuditRequest(bucket, jobId);
ciService.getLiveVideoAuditAsync(request, new CosXmlResultListener() {
@Override
public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
// result 查询直播审核任务的结果
// 详细字段请查看api文档或者SDK源码
GetLiveVideoAuditResult result = (GetLiveVideoAuditResult) cosResult;
}
@Override
public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
if (clientException != null) {
clientException.printStackTrace();
} else {
serviceException.printStackTrace();
}
}
});
说明
更多完整示例,请前往 GitHub 查看。

取消直播审核

功能说明

本接口用于取消一个在进行中的直播审核任务,成功取消后将返回已终止任务的 JobID。
注意
COS Android SDK 版本需要大于等于 v5.9.14。

示例代码

// 存储桶名称,格式为 BucketName-APPID
String bucket = "examplebucket-1250000000";
// 审核任务的 ID
String jobId = "iab1ca9fc8a3ed11ea834c525400863904";
CancelLiveVideoAuditRequest request = new CancelLiveVideoAuditRequest(bucket, jobId);
ciService.cancelLiveVideoAuditAsync(request, new CosXmlResultListener() {
@Override
public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
// result 取消直播审核任务的结果
// 详细字段请查看api文档或者SDK源码
CancelLiveVideoAuditResult result = (CancelLiveVideoAuditResult) cosResult;
}
@Override
public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
if (clientException != null) {
clientException.printStackTrace();
} else {
serviceException.printStackTrace();
}
}
});
说明
更多完整示例,请前往 GitHub 查看。