控制台指南

最佳实践

开发者指南

数据湖存储

API 文档

SDK 文档

数据库文档捉虫大赛邀您参加,好礼多多> HOT

简介

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

说明:

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

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

API 操作名 操作描述
PostVideoAudit 提交视频审核任务 用于提交视频审核任务
GetVideoAudit 查询视频审核任务结果 用于查询视频审核任务结果

SDK API 参考

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

提交视频审核任务

功能说明

用于提交视频审核任务。

注意:

COS Android SDK 版本需要大于等于 v5.8.7。

示例代码

        // 存储桶名称,格式为 BucketName-APPID
        String bucket = "examplebucket-1250000000";
        // 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"
        String cosPath = "dir1/exampleobject.mp4";
        //视频的链接地址,Object 和 Url 只能选择其中一种
        String url = "https://myqcloud.com/%205video.mp4";
        PostVideoAuditRequest request = new PostVideoAuditRequest(bucket);
        request.setObject(cosPath);
        request.setUrl(url);
        //设置原始内容,长度限制为512字节,该字段会在响应中原样返回
        request.setDataId("DataId");
        //回调地址,以http://或者https://开头的地址。
        request.setCallback("https://github.com");
        //回调内容的结构,有效值:Simple(回调内容包含基本信息)、Detail(回调内容包含详细信息)。默认为 Simple。
        request.setCallbackVersion("Detail");
        //视频截帧数量,范围为(0, 10000]。
        request.setCount(3);
        //视频截帧频率,范围为(0, 60],单位为秒,支持 float 格式,执行精度精确到毫秒。
        request.setTimeInterval(10);
        //审核的场景类型,有效值:Porn(涉黄)、Ads(广告),可以传入多种类型,不同类型以逗号分隔,例如:Porn,Ads。
        request.setDetectType("Porn,Ads");
        //用于指定是否审核视频声音,当值为0时:表示只审核视频画面截图;值为1时:表示同时审核视频画面截图和视频声音。默认值为0。
        request.setDetectContent(1);

        // CIService 是 CosXmlService 的子类,初始化方法和 CosXmlService 一致
        ciService.postVideoAuditAsync(request, new CosXmlResultListener() {
            @Override
            public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
                // result 提交视频审核任务的结果
                // 详细字段请查看api文档或者SDK源码
                PostAuditResult result = (PostAuditResult) cosResult;
            }

            @Override
            public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
                if (clientException != null) {
                    clientException.printStackTrace();
                } else {
                    serviceException.printStackTrace();
                }
            }
        });

说明:

更多完整示例,请前往 GitHub 查看。

查询视频审核任务结果

功能说明

用于查询视频审核任务结果。

注意:

COS Android SDK 版本需要大于等于 v5.8.7。

示例代码

        // 存储桶名称,格式为 BucketName-APPID
        String bucket = "examplebucket-1250000000";
        // 审核任务的 ID
        String jobId = "iab1ca9fc8a3ed11ea834c525400863904";
        GetVideoAuditRequest request = new GetVideoAuditRequest(bucket, jobId);
        // CIService 是 CosXmlService 的子类,初始化方法和 CosXmlService 一致
        ciService.getVideoAuditAsync(request, new CosXmlResultListener() {
            @Override
            public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
                // result 查询视频审核任务的结果
                // 详细字段请查看api文档或者SDK源码
                GetVideoAuditResult result = (GetVideoAuditResult) cosResult;
            }

            @Override
            public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
                if (clientException != null) {
                    clientException.printStackTrace();
                } else {
                    serviceException.printStackTrace();
                }
            }
        });

说明:

更多完整示例,请前往 GitHub 查看。

目录