简介
本文档提供关于直播审核接口相关的 API 概览以及 SDK 示例代码。
SDK API 参考
提交直播审核
功能说明
本接口用于提交一个直播流审核任务。直播流审核功能为异步任务方式,您可以通过提交直播流审核任务审核您的直播流,然后通过查询直播流审核任务接口查询审核结果。
注意
COS Android SDK 版本需要大于等于 v5.9.14。
示例代码
// 存储桶名称,格式为 BucketName-APPIDString 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() {@Overridepublic void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {// result 提交直播审核任务的结果// 详细字段请查看api文档或者SDK源码PostLiveVideoAuditResult result = (PostLiveVideoAuditResult) cosResult;}@Overridepublic void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {if (clientException != null) {clientException.printStackTrace();} else {serviceException.printStackTrace();}}});
说明
查询直播审核结果
功能说明
本接口用于主动查询指定的直播审核任务结果。直播审核功能为异步任务方式,您可以通过提交直播审核任务审核您的直播流,然后通过查询直播审核任务接口轮询获取审核结果。
注意
COS Android SDK 版本需要大于等于 v5.9.14。
示例代码
// 存储桶名称,格式为 BucketName-APPIDString bucket = "examplebucket-1250000000";// 审核任务的 IDString jobId = "iab1ca9fc8a3ed11ea834c525400863904";GetLiveVideoAuditRequest request = new GetLiveVideoAuditRequest(bucket, jobId);ciService.getLiveVideoAuditAsync(request, new CosXmlResultListener() {@Overridepublic void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {// result 查询直播审核任务的结果// 详细字段请查看api文档或者SDK源码GetLiveVideoAuditResult result = (GetLiveVideoAuditResult) cosResult;}@Overridepublic void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {if (clientException != null) {clientException.printStackTrace();} else {serviceException.printStackTrace();}}});
说明
取消直播审核
功能说明
本接口用于取消一个在进行中的直播审核任务,成功取消后将返回已终止任务的 JobID。
注意
COS Android SDK 版本需要大于等于 v5.9.14。
示例代码
// 存储桶名称,格式为 BucketName-APPIDString bucket = "examplebucket-1250000000";// 审核任务的 IDString jobId = "iab1ca9fc8a3ed11ea834c525400863904";CancelLiveVideoAuditRequest request = new CancelLiveVideoAuditRequest(bucket, jobId);ciService.cancelLiveVideoAuditAsync(request, new CosXmlResultListener() {@Overridepublic void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {// result 取消直播审核任务的结果// 详细字段请查看api文档或者SDK源码CancelLiveVideoAuditResult result = (CancelLiveVideoAuditResult) cosResult;}@Overridepublic void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {if (clientException != null) {clientException.printStackTrace();} else {serviceException.printStackTrace();}}});
说明