简介
内容审核功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。说明使用内容审核服务需拥有数据万象使用权限:主账号请 单击此处 进行角色授权。子账号请参见 授权子账号接入数据万象服务 文档。本文档提供关于视频审核的 API 概览和 SDK 示例代码。
API | 操作描述 |
提交视频审核任务 | 用于提交一个视频审核任务 |
查询视频审核任务结果 | 用于查询指定的视频审核任务 |
SDK API 参考
SDK 所有接口的具体参数与方法说明,请参考 SDK API。
提交视频审核任务
功能说明
视频审核功能为异步任务方式,您可以通过提交视频审核任务审核您的视频文件,然后通过查询视频审核任务接口查询审核结果。下面示例展示了如何提交一个视频审核任务,然后通过 JobId 查询视频审核任务结果。说明此操作需要存储桶开通数据万象相关功能。视频审核接口从 5.4.24 版本开始支持,下载新版 SDK 前往 Releases 或参见 快速入门。查看版本 Changelog 请前往 GitHub。
示例代码
using COSXML.Model.CI;using COSXML.Auth;using System;using System.Threading;using COSXML;
namespace COSSnippet{ public class SubmitVideoCensorJobModel {
private CosXml cosXml;
SubmitVideoCensorJobModel() { CosXmlConfig config = new CosXmlConfig.Builder() .SetRegion("COS_REGION") // 设置默认的地域, COS 地域的简称请参照 https://cloud.tencent.com/document/product/436/6224 .Build();
string secretId = "SECRET_ID"; // 云 API 密钥 SecretId, 获取 API 密钥请参照 https://console.cloud.tencent.com/cam/capi string secretKey = "SECRET_KEY"; // 云 API 密钥 SecretKey, 获取 API 密钥请参照 https://console.cloud.tencent.com/cam/capi long durationSecond = 600; //每次请求签名有效时长,单位为秒 QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId, secretKey, durationSecond);
this.cosXml = new CosXmlServer(config, qCloudCredentialProvider); }
/// 提交视频审核任务 public string SubmitVideoCensorJob() { // 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.cloud.tencent.com/developer string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能 SubmitVideoCensorJobRequest request = new SubmitVideoCensorJobRequest(bucket); request.SetCensorObject("video.mp4"); // 媒体文件的对象键,需要替换成桶内存在的媒体文件的对象键 // 审核的场景类型,有效值:Porn(涉黄)、Ads(广告),可以传入多种类型,不同类型以逗号分隔,例如:Porn,Ads request.SetDetectType("Porn,Ads"); // 视频画面的审核通过视频截帧能力截取出一定量的截图,通过对截图逐一审核而实现的,该参数用于指定视频截帧的配置。 request.SetSnapshotMode("Average"); // 截帧模式。Interval 表示间隔模式;Average 表示平均模式;Fps 表示固定帧率模式。 request.SetSnapshotCount("100"); // 视频截帧数量,范围为(0, 10000] request.SetSnapshotTimeInterval("1.0"); // 视频截帧频率,范围为(0, 60],单位为秒,支持 float 格式,执行精度精确到毫秒 // 执行请求 SubmitCensorJobResult result = cosXml.SubmitVideoCensorJob(request); Console.WriteLine(result.GetResultInfo()); Console.WriteLine(result.censorJobsResponse.JobsDetail.JobId); Console.WriteLine(result.censorJobsResponse.JobsDetail.State); Console.WriteLine(result.censorJobsResponse.JobsDetail.CreationTime); return result.censorJobsResponse.JobsDetail.JobId; }
static void Main(string[] args) { SubmitVideoCensorJobModel m = new SubmitVideoCensorJobModel(); /// 提交审核任务,JobId唯一标识了本次提交的审核任务的结果 string JobId = m.SubmitVideoCensorJob(); /// 打印 JobId Console.WriteLine("JobId : " + JobId); } }}
说明 更多完整示例,请前往 GitHub 查看。
查询视频审核任务结果
功能说明
用于查询视频审核任务执行情况和结果。
示例代码
using COSXML.Model.CI;using COSXML.Auth;using System;using System.Threading;using COSXML;
namespace COSSnippet{ public class SubmitVideoCensorJobModel {
private CosXml cosXml;
SubmitVideoCensorJobModel() { CosXmlConfig config = new CosXmlConfig.Builder() .SetRegion("COS_REGION") // 设置默认的区域, COS 地域的简称请参照 https://cloud.tencent.com/document/product/436/6224 .Build();
string secretId = "SECRET_ID"; // 云 API 密钥 SecretId, 获取 API 密钥请参照 https://console.cloud.tencent.com/cam/capi string secretKey = "SECRET_KEY"; // 云 API 密钥 SecretKey, 获取 API 密钥请参照 https://console.cloud.tencent.com/cam/capi long durationSecond = 600; //每次请求签名有效时长,单位为秒 QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId, secretKey, durationSecond);
this.cosXml = new CosXmlServer(config, qCloudCredentialProvider); }
/// 查询视频审核任务结果 public void GetVideoCensorJobResult(string JobId) { // 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.cloud.tencent.com/developer string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能 GetVideoCensorJobRequest request = new GetVideoCensorJobRequest(bucket, JobId); // 执行请求 GetVideoCensorJobResult result = cosXml.GetVideoCensorJob(request); Console.WriteLine(result.GetResultInfo());
// 读取审核结果 Console.WriteLine(result.resultStruct.JobsDetail.JobId); Console.WriteLine(result.resultStruct.JobsDetail.State); Console.WriteLine(result.resultStruct.JobsDetail.CreationTime); Console.WriteLine(result.resultStruct.JobsDetail.Object); Console.WriteLine(result.resultStruct.JobsDetail.SnapshotCount); Console.WriteLine(result.resultStruct.JobsDetail.Result);
Console.WriteLine(result.resultStruct.JobsDetail.PornInfo.HitFlag); Console.WriteLine(result.resultStruct.JobsDetail.PornInfo.Count);
Console.WriteLine(result.resultStruct.JobsDetail.AdsInfo.HitFlag); Console.WriteLine(result.resultStruct.JobsDetail.AdsInfo.Count);
// 审核视频截图内容 for(int i = 0; i < result.resultStruct.JobsDetail.Snapshot.Count; i++) { Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].Url); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].Text); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].SnapshotTime); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].PornInfo.HitFlag); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].PornInfo.Score); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].PornInfo.Label); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].PornInfo.SubLabel);
Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].AdsInfo.HitFlag); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].AdsInfo.Score); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].AdsInfo.Label); Console.WriteLine(result.resultStruct.JobsDetail.Snapshot[i].AdsInfo.SubLabel); } }
static void Main(string[] args) { SubmitVideoCensorJobModel m = new SubmitVideoCensorJobModel(); // 输入在提交审核任务时获取的JobId string JobId = "xxx"; /// 查询审核任务 m.GetVideoCensorJobResult(JobId); } }}
说明 更多完整示例,请前往 GitHub 查看。
对象存储官网1折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
转转请注明出处:https://www.yunxiaoer.com/145547.html