有奖捉虫:云通信与企业服务文档专题,速来> HOT

简介

内容审核功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。
说明
使用内容审核服务需拥有数据万象使用权限:
主账号请 单击此处 进行角色授权。
子账号请参见 授权子账号接入数据万象服务 文档。
本文档提供关于视频审核的相关的 API 概览以及 SDK 示例代码。
API
操作描述
用于提交一个视频审核任务
用于查询指定的视频审核任务

SDK API 参考

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

创建任务

功能说明

QCloudPostVideoRecognitionRequest 接口用于提交一个视频审核任务。您可以通过主动设置回调地址接收审核信息,也可以通过 Jobid 进行查询。
注意
COS iOS SDK 版本需要大于等于 v6.0.9。

请求示例

Objective-C
Swift
QCloudPostVideoRecognitionRequest * request = [[QCloudPostVideoRecognitionRequest alloc]init];

// 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"
request.object = @"exampleobject";

// 文件所在地域
request.regionName = @"regionName";

// 存储桶名称,格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";

// 截帧模式。Interval 表示间隔模式;Average 表示平均模式;Fps 表示固定帧率模式。
// Interval 模式:TimeInterval,Count 参数生效。当设置 Count,未设置 TimeInterval 时,表示截取所有帧,共 Count 张图片。
// Average 模式:Count 参数生效。表示整个视频,按平均间隔截取共 Count 张图片。
// Fps 模式:TimeInterval 表示每秒截取多少帧,Count 表示共截取多少帧。
request.mode = QCloudVideoRecognitionModeFps;

// 视频截帧频率,范围为(0.000, 60.000],单位为秒,支持 float 格式,执行精度精确到毫秒
request.timeInterval = 1;

// 视频截帧数量,范围为(0, 10000]。
request.count = 10;

// 审核策略,不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345
request.bizType = @"BizType";

// 用于指定是否审核视频声音,当值为 0 时:表示只审核视频画面截图;值为1时:表示同时审核视频画面截图和视频声音。默认值为 0。
request.detectContent = YES;

request.finishBlock = ^(QCloudPostVideoRecognitionResult * outputObject, NSError *error) {
// outputObject 提交审核反馈信息 包含用于查询的 job id,详细字段请查看 api 文档或者 SDK 源码
// QCloudPostVideoRecognitionResult 类;
};
[[QCloudCOSXMLService defaultCOSXML] PostVideoRecognition:request];

说明
更多完整示例,请前往 GitHub 查看。
let request : QCloudPostVideoRecognitionRequest = QCloudPostVideoRecognitionRequest();

// 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"
request.object = "exampleobject";

// 文件所在地域
request.regionName = "regionName";

// 存储桶名称,格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000";

// 截帧模式。Interval 表示间隔模式;Average 表示平均模式;Fps 表示固定帧率模式。
// Interval 模式:TimeInterval,Count 参数生效。当设置 Count,未设置 TimeInterval 时,表示截取所有帧,共 Count 张图片。
// Average 模式:Count 参数生效。表示整个视频,按平均间隔截取共 Count 张图片。
// Fps 模式:TimeInterval 表示每秒截取多少帧,Count 表示共截取多少帧。
request.mode = QCloudVideoRecognitionMode.fps;

// 视频截帧频率,范围为(0.000, 60.000],单位为秒,支持 float 格式,执行精度精确到毫秒
request.timeInterval = 1;

// 视频截帧数量,范围为(0, 10000]。
request.count = 10;

// 审核策略,不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345
request.bizType = "BizType";

// 用于指定是否审核视频声音,当值为 0 时:表示只审核视频画面截图;值为1时:表示同时审核视频画面截图和视频声音。默认值为0。
request.detectContent = true;

request.finishBlock = { (result, error) in
// outputObject 提交审核反馈信息 包含用于查询的 job id,详细字段请查看 api 文档或者 SDK 源码
// QCloudPostVideoRecognitionResult 类;
}
QCloudCOSXMLService.defaultCOSXML().postVideoRecognition(request);
说明
完整示例,请前往 GitHub 查看。

查询任务

功能说明

QCloudGetVideoRecognitionRequest 接口用来查询指定的视频审核任务。您可以根据视频审核任务的 job Id 来查询视频审核结果。
注意
COS iOS SDK 版本需要大于等于 v6.0.9。

请求示例

Objective-C
Swift
QCloudGetVideoRecognitionRequest * request = [[QCloudGetVideoRecognitionRequest alloc]init];

// 存储桶名称,格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";

// QCloudPostVideoRecognitionRequest 接口返回的 jobid
request.jobId = @"jobid";
[request setFinishBlock:^(QCloudVideoRecognitionResult * _Nullable result, NSError * _Nullable error) {
// outputObject 审核结果 包含用于查询的 job id,详细字段请查看 api 文档或者 SDK 源码
// QCloudVideoRecognitionResult 类;
}];
[[QCloudCOSXMLService defaultCOSXML] GetVideoRecognition:request];

说明
更多完整示例,请前往 GitHub 查看。
let request : QCloudGetVideoRecognitionRequest = QCloudGetVideoRecognitionRequest();

// 存储桶名称,格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000";

// QCloudPostVideoRecognitionRequest 接口返回的 jobid
request.jobId = "jobid";

request.finishBlock = { (result, error) in
// outputObject 审核结果 包含用于查询的 job id,详细字段请查看 api 文档或者 SDK 源码
// QCloudVideoRecognitionResult 类;
}
QCloudCOSXMLService.defaultCOSXML().getVideoRecognition(request);
说明
更多完整示例,请前往 GitHub 查看。