tencent cloud

文档反馈

视频审核

最后更新时间:2024-03-13 10:07:10

    简介

    内容审核功能是由 数据万象(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";
    
    // 审核类型,拥有 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.000, 60.000],单位为秒,支持 float 格式,执行精度精确到毫秒
    request.timeInterval = 1;
    
    // 视频截帧数量,范围为(0, 10000]。
    request.count = 10;
    
    // 审核策略,不带审核策略时使用默认策略。具体查看 https://www.tencentcloud.com/document/product/460/56345?from_cn_redirect=1
    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";
    
    // 审核类型,拥有 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.000, 60.000],单位为秒,支持 float 格式,执行精度精确到毫秒
    request.timeInterval = 1;
    
    // 视频截帧数量,范围为(0, 10000]。
    request.count = 10;
    
    // 审核策略,不带审核策略时使用默认策略。具体查看 https://www.tencentcloud.com/document/product/460/56345?from_cn_redirect=1
    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 查看。
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持