简介
本文档提供关于直播审核的相关的 API 概览以及 SDK 示例代码。
API | 操作描述 |
用于提交一个直播审核任务 | |
用于查询指定的直播审核任务 | |
用于取消指定的直播审核任务 |
SDK API 参考
创建任务
功能说明
QCloudPostLiveVideoRecognitionRequest 接口用于提交一个直播审核任务。您可以通过主动设置回调地址接收审核信息,也可以通过 Jobid 进行查询。
注意
COS iOS SDK 版本需要大于等于 v6.1.6。
请求示例
Objective-C
QCloudPostLiveVideoRecognitionRequest * request = [[QCloudPostLiveVideoRecognitionRequest alloc]init];request.regionName = @"regionName";// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";// 表示直播流所要转存的路径,直播流的 ts 文件和 m3u8 文件将保存在本桶该目录下。m3u8 文件保存文件名为 Path/{$JobId}.m3u8,ts 文件的保存文件名为 Path/{$JobId}-{$Realtime}.ts,其中 Realtime 为17位年月日时分秒毫秒时间。request.path = @"test";// 需要审核的直播流播放地址,例如 rtmp://example.com/live/123。request.url = @"test";// 审核策略,不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345request.bizType = BizType;request.finishBlock = ^(QCloudPostVideoRecognitionResult * outputObject, NSError *error) {// outputObject 提交审核反馈信息 包含用于查询的 job id,详细字段请查看 api 文档或者 SDK 源码// QCloudPostVideoRecognitionResult 类;};[[QCloudCOSXMLService defaultCOSXML] PostLiveVideoRecognition:request];
说明
查询任务
功能说明
QCloudGetLiveVideoRecognitionRequest 接口用来查询指定的直播审核任务。您可以根据直播审核任务的 job Id 来查询直播审核结果。
注意
COS iOS SDK 版本需要大于等于 v6.1.6。
请求示例
Objective-C
QCloudGetLiveVideoRecognitionRequest * request = [[QCloudGetLiveVideoRecognitionRequest alloc]init];// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";// QCloudPostLiveVideoRecognitionRequest 接口返回的 jobidrequest.jobId = @"jobid";request.regionName = @"regionName";request.finishBlock = ^(QCloudGetVideoRecognitionRequest * outputObject, NSError *error) {// outputObject 审核结果 包含用于查询的 job id,详细字段请查看 api 文档或者 SDK 源码// QCloudVideoRecognitionResult 类;};[[QCloudCOSXMLService defaultCOSXML] GetLiveVideoRecognition:request];
说明
取消任务
功能说明
QCloudCancelLiveVideoRecognitionRequest 接口用来取消指定的直播审核任务。您可以根据直播审核任务的 job Id 来取消直播审核结果。
注意
COS iOS SDK 版本需要大于等于 v6.1.6。
请求示例
Objective-C
QCloudCancelLiveVideoRecognitionRequest * request = [[QCloudCancelLiveVideoRecognitionRequest alloc]init];// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";// QCloudPostLiveVideoRecognitionRequest 接口返回的 jobidrequest.jobId = @"jobid";request.regionName = @"regionName";request.finishBlock = ^(QCloudPostVideoRecognitionResult * outputObject, NSError *error) {// outputObject 审核结果 包含用于查询的 job id,详细字段请查看 api 文档或者 SDK 源码// QCloudPostVideoRecognitionResult 类;};[[QCloudCOSXMLService defaultCOSXML] CancelLiveVideoRecognition:request];
说明