数据万象
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 数据万象 > SDK 文档 > COS iOS SDK > 内容识别 > 语音识别 > 任务接口

任务接口

最近更新时间：2023-07-12 12:18:21

我的收藏

本页目录：

简介

本文档提供关于提交语音识别任务、查询指定的语音识别任务、批量拉取语音识别任务相关的 API 概览以及 SDK 示例代码。
API
说明
接口用于提交一个语音识别任务。
用于查询指定的语音识别任务。
用于拉取符合条件的语音识别任务。

SDK API 参考

SDK 所有接口的具体参数与方法说明，请参见 SDK API。

提交语音识别任务

功能说明

接口用于提交一个语音识别任务。
注意
COS iOS SDK 版本需要大于等于 v6.1.3。

示例代码

Objective-C
QCloudPostAudioDiscernTaskRequest * request = [[QCloudPostAudioDiscernTaskRequest alloc]init];

// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";
request.regionName = @"regionName";

QCloudPostAudioDiscernTaskInfo* taskInfo = [QCloudPostAudioDiscernTaskInfo new];
taskInfo.Tag = @"SpeechRecognition";

// 操作规则
QCloudPostAudioDiscernTaskInfoInput * input = QCloudPostAudioDiscernTaskInfoInput.new;
input.Object = @"test1";
// 待操作的语音文件
taskInfo.Input = input;
QCloudPostAudioDiscernTaskInfoOperation * op = [QCloudPostAudioDiscernTaskInfoOperation new];
QCloudPostAudioDiscernTaskInfoOutput * output = QCloudPostAudioDiscernTaskInfoOutput.new;
output.Region = @"regionName";
output.Bucket = @"examplebucket-1250000000";
output.Object = @"test";
// 结果输出地址
op.Output = output;

QCloudPostAudioDiscernTaskInfoSpeechRecognition * speechRecognition = [QCloudPostAudioDiscernTaskInfoSpeechRecognition new];
speechRecognition.EngineModelType =@"16k_zh";
speechRecognition.ChannelNum = 1;
speechRecognition.ResTextFormat = 0;
speechRecognition.ConvertNumMode = 0;
// 当 Tag 为 SpeechRecognition 时有效，指定该任务的参数
op.SpeechRecognition = speechRecognition;
// 操作规则
taskInfo.Operation = op;
//  语音识别任务
request.taskInfo = taskInfo;

[request setFinishBlock:^(QCloudPostAudioDiscernTaskResult * _Nullable result, NSError * _Nullable error) {
    // outputObject 提交审核反馈信息 包含用于查询的 job id，详细字段请查看 API 文档或者 SDK 源码
    // QCloudPostAudioDiscernTaskResult 类；
}];
[[QCloudCOSXMLService defaultCOSXML] PostAudioDiscernTask:request];
说明
更多完整示例，请前往 GitHub 查看。
Swift
let request = QCloudPostAudioDiscernTaskRequest.init();

// 存储桶名称，格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000";
request.regionName = "regionName";

let taskInfo = QCloudPostAudioDiscernTaskInfo.init();
taskInfo.tag = "SpeechRecognition";

// 操作规则
let input = QCloudPostAudioDiscernTaskInfoInput.init();
input.object = "test1";
// 待操作的语音文件
taskInfo.input = input;
let op = QCloudPostAudioDiscernTaskInfoOperation.init();
let output = QCloudPostAudioDiscernTaskInfoOutput.init();
output.region = "regionName";
output.bucket = "examplebucket-1250000000";
output.object = "test";
// 结果输出地址
op.output = output;

let speechRecognition = QCloudPostAudioDiscernTaskInfoSpeechRecognition.init();
speechRecognition.engineModelType = "16k_zh";
speechRecognition.channelNum = 1;
speechRecognition.resTextFormat = 0;
speechRecognition.convertNumMode = 0;
// 当 Tag 为 SpeechRecognition 时有效，指定该任务的参数
op.speechRecognition = speechRecognition;
// 操作规则
taskInfo.operation = op;
// 语音识别任务
request.taskInfo = taskInfo;

[request .setFinish({ outputObject, error in
    // outputObject 提交审核反馈信息 包含用于查询的 job id，详细字段请查看 API 文档或者 SDK 源码
    // QCloudPostAudioDiscernTaskResult 类；
})];
QCloudCOSXMLService.defaultCOSXML().postAudioDiscernTask(request);
说明
更多完整示例，请前往 GitHub 查看。

查询指定的语音识别任务

功能说明

用于查询指定的语音识别任务。
注意
COS iOS SDK 版本需要大于等于 v6.1.3。

示例代码

Objective-C
QCloudGetAudioDiscernTaskRequest * request = [[QCloudGetAudioDiscernTaskRequest alloc]init];

// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";

// QCloudPostAudioDiscernTaskRequest接口返回的jobid
request.jobId = @"jobid";

request.regionName = @"regionName";

request.finishBlock = ^(QCloudGetAudioDiscernTaskResult * outputObject, NSError *error) {
    // outputObject 详细字段请查看 API 文档或者 SDK 源码
    // QCloudGetAudioDiscernTaskResult 类；
};
[[QCloudCOSXMLService defaultCOSXML] GetAudioDiscernTask:request];
说明
更多完整示例，请前往 GitHub 查看。
Swift
let request = QCloudGetAudioDiscernTaskRequest.init();

// 存储桶名称，格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000";

// QCloudPostAudioDiscernTaskRequest 接口返回的 jobid
request.jobId = "jobid";

request.regionName = "regionName";

request.setFinish { outputObject, error in
    // outputObject 详细字段请查看 API 文档或者 SDK 源码
    // QCloudGetAudioDiscernTaskResult 类；
};
QCloudCOSXMLService.defaultCOSXML().getAudioDiscernTask(request);
说明
更多完整示例，请前往 GitHub 查看。

批量拉取语音识别任务

功能说明

用于拉取符合条件的语音识别任务。
注意
COS iOS SDK 版本需要大于等于 v6.1.3。

示例代码

Objective-C
QCloudBatchGetAudioDiscernTaskRequest * request = [[QCloudBatchGetAudioDiscernTaskRequest alloc]init];

// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";

request.regionName = @"regionName";

request.states = QCloudTaskStatesSuccess | QCloudTaskStatesCancel;

// 其他更多参数请查阅sdk文档或源码注释

request.finishBlock = ^(QCloudBatchGetAudioDiscernTaskResult * outputObject, NSError *error) {
    // outputObject 任务结果，详细字段请查看 API 文档或者 SDK 源码
    // QCloudBatchGetAudioDiscernTaskResult 类；
};
[[QCloudCOSXMLService defaultCOSXML] BatchGetAudioDiscernTask:request];
说明
更多完整示例，请前往 GitHub 查看。
Swift
let request = QCloudBatchGetAudioDiscernTaskRequest.init();

// 存储桶名称，格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000";

request.regionName = "regionName";

request.states = QCloudTaskStatesEnum(rawValue: QCloudTaskStatesEnum.success.rawValue | QCloudTaskStatesEnum.cancel.rawValue)!;

// 其他更多参数请查阅 SDK 文档或源码注释

request.setFinish { outputObject, error in
    // outputObject 任务结果，详细字段请查看 API 文档或者 SDK 源码
    // QCloudBatchGetAudioDiscernTaskResult 类；
};
QCloudCOSXMLService.defaultCOSXML().batchGetAudioDiscernTask(request);
说明
更多完整示例，请前往 GitHub 查看。
中国站