简介
本文档提供关于视频审核的相关的 API 概览以及 SDK 示例代码。
API | 操作描述 |
用于提交一个视频审核任务 | |
用于查询指定的视频审核任务 |
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-APPIDrequest.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/56345request.bizType = @"BizType";// 用于指定是否审核视频声音，当值为 0 时：表示只审核视频画面截图；值为1时：表示同时审核视频画面截图和视频声音。默认值为 0。request.detectContent = YES;request.finishBlock = ^(QCloudPostVideoRecognitionResult * outputObject, NSError *error) {// outputObject 提交审核反馈信息 包含用于查询的 job id，详细字段请查看 api 文档或者 SDK 源码// QCloudPostVideoRecognitionResult 类；};[[QCloudCOSXMLService defaultCOSXML] PostVideoRecognition:request];
说明：
Swift
let request : QCloudPostVideoRecognitionRequest = QCloudPostVideoRecognitionRequest();// 对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "dir1/object1"request.object = "exampleobject";// 文件所在地域request.regionName = "regionName";// 存储桶名称，格式为 BucketName-APPIDrequest.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/56345request.bizType = "BizType";// 用于指定是否审核视频声音，当值为 0 时：表示只审核视频画面截图；值为1时：表示同时审核视频画面截图和视频声音。默认值为0。request.detectContent = true;request.finishBlock = { (result, error) in// outputObject 提交审核反馈信息 包含用于查询的 job id，详细字段请查看 api 文档或者 SDK 源码// QCloudPostVideoRecognitionResult 类；}QCloudCOSXMLService.defaultCOSXML().postVideoRecognition(request);
说明：
查询任务
功能说明
QCloudGetVideoRecognitionRequest 接口用来查询指定的视频审核任务。您可以根据视频审核任务的 job Id 来查询视频审核结果。
注意：
COS iOS SDK 版本需要大于等于 v6.0.9。
请求示例
Objective-C
QCloudGetVideoRecognitionRequest * request = [[QCloudGetVideoRecognitionRequest alloc]init];// 存储桶名称，格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";// QCloudPostVideoRecognitionRequest 接口返回的 jobidrequest.jobId = @"jobid";[request setFinishBlock:^(QCloudVideoRecognitionResult * _Nullable result, NSError * _Nullable error) {// outputObject 审核结果 包含用于查询的 job id，详细字段请查看 api 文档或者 SDK 源码// QCloudVideoRecognitionResult 类；}];[[QCloudCOSXMLService defaultCOSXML] GetVideoRecognition:request];
说明：
Swift
let request : QCloudGetVideoRecognitionRequest = QCloudGetVideoRecognitionRequest();// 存储桶名称，格式为 BucketName-APPIDrequest.bucket = "examplebucket-1250000000";// QCloudPostVideoRecognitionRequest 接口返回的 jobidrequest.jobId = "jobid";request.finishBlock = { (result, error) in// outputObject 审核结果 包含用于查询的 job id，详细字段请查看 api 文档或者 SDK 源码// QCloudVideoRecognitionResult 类；}QCloudCOSXMLService.defaultCOSXML().getVideoRecognition(request);
说明：
