控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

简介

内容审核功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。

说明:

使用内容审核服务需拥有数据万象使用权限:

本文档提供关于视频审核的相关的 API 概览以及 SDK 示例代码。

API 操作描述
提交视频审核任务 用于提交一个视频审核任务
查询视频审核任务结果 用于查询指定的视频审核任务

SDK API 参考

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

创建任务

功能说明

QCloudPostVideoRecognitionRequest 接口用于提交一个视频审核任务。您可以通过主动设置回调地址接收审核信息,也可以通过 Jobid 进行查询。

注意:

COS iOS SDK 版本需要大于等于 v6.0.9。

请求示例

Objective-C

QCloudPostVideoRecognitionRequest * request = [[QCloudPostVideoRecognitionRequest alloc]init];

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

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

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

// 审核类型,拥有 porn(涉黄识别)、ads(广告识别)
// 用户可选择多种识别类型,例如 detect-type=porn,ads 表示对图片进行涉黄及广告审核
// 可以使用或进行组合赋值 如: QCloudRecognitionPorn | QCloudRecognitionTerrorist
request.detectType = QCloudRecognitionPorn | QCloudRecognitionAds;

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

// 视频截帧频率,范围为(0, 60],单位为秒,支持 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 查看。

Swift

let request : QCloudPostVideoRecognitionRequest = QCloudPostVideoRecognitionRequest();

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

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

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

// 审核类型,拥有 porn(涉黄识别)、ads(广告识别)
// 用户可选择多种识别类型,例如 detect-type=porn,ads 表示对图片进行涉黄及广告审核
// 可以使用或进行组合赋值 如: QCloudRecognitionPorn | QCloudRecognitionTerrorist
request.detectType = QCloudRecognitionEnum(rawValue: QCloudRecognitionEnum.porn.rawValue | QCloudRecognitionEnum.ads.rawValue!

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

// 视频截帧频率,范围为(0, 60],单位为秒,支持 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

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 查看。

Swift

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 查看。

目录