直播审核

最近更新时间:2024-10-17 16:16:52

我的收藏

简介

内容审核功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。
说明:
使用内容审核服务需拥有数据万象使用权限:
主账号请 单击此处 进行角色授权。
子账号请参见 授权子账号接入数据万象服务 文档。
本文档提供关于直播审核的 API 概览和 SDK 示例代码。
注意:
COS Javascript SDK 版本需要大于等于 v1.3.1。
API
操作描述
用于提交一个直播审核任务
用于查询指定的直播审核任务
取消一个在进行中的直播审核任务

提交直播审核任务

功能说明

用于提交一个直播审核任务。

请求示例

// sdk的引入及初始化cos请参考 https://cloud.tencent.com/document/product/436/11459
function postLiveAuditing() {
const config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', // 存储桶,必须
Region: 'COS_REGION', // 存储桶所在地域,比如ap-beijing,必须
};
const host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com';
const key = 'video/auditing';
const url = `https://${host}/${key}`;
const body = COS.util.json2xml({
Request: {
Type: 'live_video', // 固定值,必须
Input: {
Url: 'rtmp://example.com/live/123', // 需要审核的直播流播放地址
// DataId: '',
// UserInfo: {},
},
Conf: {
BizType: 'xxx', // BizType 可通过控制台创建直播审核策略后获得,必填
// Callback: 'https://callback.com', // 回调地址,非必须
// CallbackType: 1, // 回调片段类型,非必须
}
}
});
cos.request({
Method: 'POST', // 固定值,必须
Url: url, // 请求的url,必须
Key: key, // 固定值,必须
ContentType: 'application/xml', // 固定值,必须
Body: body // 请求体参数,必须
},
function(err, data){
if (err) {
// 处理请求失败
console.log(err);
} else {
// 处理请求成功
console.log(data.Response);
}
});
}
postLiveAuditing();

参数说明

cos.request 方法参数说明:
参数名称
描述
类型
是否必选
Method
请求方法,固定值
String
Url
请求url,固定值
String
Key
固定值
String
ContentType
固定值
String
Body
请求体详情请参见 提交直播审核任务
Container

回调函数说明

function(err, data) { ... }
参数名称
参数描述
类型
err
请求发生错误时返回的对象,包括网络错误和业务错误。如果请求成功则为空,更多详情请参见 错误码
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
data
请求成功时返回的对象,如果请求发生错误,则为空
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
- Response
响应结果 详情请参见 提交直播审核任务
Object

相关链接

查询直播审核任务结果

功能说明

用于查询直播审核任务执行情况和结果。

请求示例

// sdk的引入及初始化cos请参考 https://cloud.tencent.com/document/product/436/11459
function getLiveAuditingResult() {
const config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', // 存储桶,必须
Region: 'COS_REGION', // 存储桶所在地域,比如ap-beijing,必须
};
const jobId = 'av0ca69557bd6111ed904c5254009411xx'; // jobId 可以通过提交直播审核任务返回
const host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com';
const key = `video/auditing/${jobId}`; // 固定值,必须
const url = `https://${host}/${key}`;
cos.request({
Method: 'GET', // 固定值,必须
Url: url, // 请求的url,必须
Key: key, // 固定值,必须
},
function(err, data){
if (err) {
// 处理请求失败
console.log(err);
} else {
// 处理请求成功
console.log(data.Response);
}
});
}
getLiveAuditingResult();

参数说明

cos.request 方法参数说明:
参数名称
描述
类型
是否必选
Method
请求方法,固定值
String
Url
请求url,固定值
String
Key
固定值:video/auditing/要查询的jobId
String
参数名称
描述
类型
是否必选
jobId
需要查询的任务 ID
String

回调函数说明

function(err, data) { ... }
参数名称
参数描述
类型
err
请求发生错误时返回的对象,包括网络错误和业务错误。如果请求成功则为空,更多详情请参见 错误码
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
data
请求成功时返回的对象,如果请求发生错误,则为空
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
- Response
响应结果 详情请参见 查询直播审核任务
Object

相关链接

取消直播审核任务

功能说明

本接口用于取消一个在进行中的直播审核任务,成功取消后将返回已终止任务的 JobID。

请求示例

// sdk的引入及初始化cos请参考 https://cloud.tencent.com/document/product/436/11459
function cancelLiveAuditing() {
const config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', // 存储桶,必须
Region: 'COS_REGION', // 存储桶所在地域,比如ap-beijing,必须
};
const host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com';
const jobId = 'xxxx'; // jobId 可以通过提交直播审核任务返回
const key = `video/cancel_auditing/${jobId}`; // 固定值,必须
const url = `https://${host}/${key}`;
cos.request(
{
Method: 'POST', // 固定值,必须
Url: url, // 请求的url,必须
Key: key, // 固定值,必须
},
function (err, data) {
if (err) {
// 处理请求失败
console.log(err);
} else {
// 处理请求成功
console.log(data.Response);
}
},
);
}

参数说明

cos.request 方法参数说明:
参数名称
描述
类型
是否必选
Method
请求方法,固定值
String
Url
请求url,固定值
String
Key
固定值:video/cancel_auditing/要取消的jobId
String
参数名称
描述
类型
是否必选
jobId
需要取消的任务 ID
String

回调函数说明

function(err, data) { ... }
参数名称
参数描述
类型
err
请求发生错误时返回的对象,包括网络错误和业务错误。如果请求成功则为空,更多详情请参见 错误码
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
data
请求成功时返回的对象,如果请求发生错误,则为空
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
- Response
响应结果 详情请参见 取消直播审核任务
Object

相关链接