Skip to content

Commit

Permalink
bump version to 3.0.4
Browse files Browse the repository at this point in the history
  • Loading branch information
zqfan committed Sep 6, 2019
1 parent 88d6084 commit 92fe178
Show file tree
Hide file tree
Showing 208 changed files with 22,212 additions and 466 deletions.
2 changes: 1 addition & 1 deletion VERSION
@@ -1 +1 @@
3.0.3
3.0.4
16 changes: 14 additions & 2 deletions asr/CMakeLists.txt
Expand Up @@ -19,14 +19,26 @@ set(asr_public_header
)

set(asr_public_header_model
include/tencentcloud/asr/v20190614/model/SentenceRecognitionRequest.h
include/tencentcloud/asr/v20190614/model/CreateRecTaskResponse.h
include/tencentcloud/asr/v20190614/model/Task.h
include/tencentcloud/asr/v20190614/model/DescribeTaskStatusRequest.h
include/tencentcloud/asr/v20190614/model/SentenceRecognitionResponse.h
include/tencentcloud/asr/v20190614/model/TaskStatus.h
include/tencentcloud/asr/v20190614/model/CreateRecTaskRequest.h
include/tencentcloud/asr/v20190614/model/DescribeTaskStatusResponse.h
include/tencentcloud/asr/v20190614/model/SentenceRecognitionRequest.h
)

set(asr_src
src/v20190614/AsrClient.cpp
src/v20190614/model/SentenceRecognitionRequest.cpp
src/v20190614/model/CreateRecTaskResponse.cpp
src/v20190614/model/Task.cpp
src/v20190614/model/DescribeTaskStatusRequest.cpp
src/v20190614/model/SentenceRecognitionResponse.cpp
src/v20190614/model/TaskStatus.cpp
src/v20190614/model/CreateRecTaskRequest.cpp
src/v20190614/model/DescribeTaskStatusResponse.cpp
src/v20190614/model/SentenceRecognitionRequest.cpp
)

set(asr_include
Expand Down
41 changes: 36 additions & 5 deletions asr/include/tencentcloud/asr/v20190614/AsrClient.h
Expand Up @@ -23,6 +23,10 @@
#include <tencentcloud/core/Credential.h>
#include <tencentcloud/core/profile/ClientProfile.h>
#include <tencentcloud/core/AsyncCallerContext.h>
#include <tencentcloud/asr/v20190614/model/CreateRecTaskRequest.h>
#include <tencentcloud/asr/v20190614/model/CreateRecTaskResponse.h>
#include <tencentcloud/asr/v20190614/model/DescribeTaskStatusRequest.h>
#include <tencentcloud/asr/v20190614/model/DescribeTaskStatusResponse.h>
#include <tencentcloud/asr/v20190614/model/SentenceRecognitionRequest.h>
#include <tencentcloud/asr/v20190614/model/SentenceRecognitionResponse.h>

Expand All @@ -39,21 +43,48 @@ namespace TencentCloud
AsrClient(const Credential &credential, const std::string &region);
AsrClient(const Credential &credential, const std::string &region, const ClientProfile &profile);

typedef Outcome<Error, Model::CreateRecTaskResponse> CreateRecTaskOutcome;
typedef std::future<CreateRecTaskOutcome> CreateRecTaskOutcomeCallable;
typedef std::function<void(const AsrClient*, const Model::CreateRecTaskRequest&, CreateRecTaskOutcome, const std::shared_ptr<const AsyncCallerContext>&)> CreateRecTaskAsyncHandler;
typedef Outcome<Error, Model::DescribeTaskStatusResponse> DescribeTaskStatusOutcome;
typedef std::future<DescribeTaskStatusOutcome> DescribeTaskStatusOutcomeCallable;
typedef std::function<void(const AsrClient*, const Model::DescribeTaskStatusRequest&, DescribeTaskStatusOutcome, const std::shared_ptr<const AsyncCallerContext>&)> DescribeTaskStatusAsyncHandler;
typedef Outcome<Error, Model::SentenceRecognitionResponse> SentenceRecognitionOutcome;
typedef std::future<SentenceRecognitionOutcome> SentenceRecognitionOutcomeCallable;
typedef std::function<void(const AsrClient*, const Model::SentenceRecognitionRequest&, SentenceRecognitionOutcome, const std::shared_ptr<const AsyncCallerContext>&)> SentenceRecognitionAsyncHandler;



/**
*本接口用于对60秒之内的短音频文件进行识别,支持本地语音文件上传和语音URL上传两种请求方式。
*本接口服务对录音时长1小时以内的录音文件进行识别,异步返回识别全部结果。
<br>• 支持回调或轮询的方式获取结果,轮询方式请参考“录音文件识别结果查询”。
<br>• 支持语音 URL 和本地语音文件两种请求方式。
<br>• 接口是 HTTP RESTful 形式
当音频文件通过请求中body内容上传时,请求大小不能超过600KB;当音频以url方式传输时,音频时长不可超过60s。
所有请求参数放在POST请求的body中,编码类型采用x-www-form-urlencoded,参数进行urlencode编码后传输。
在使用该接口前,需要在 [语音识别控制台](https://console.cloud.tencent.com/asr) 开通服务,并进入 [API 密钥管理页面](https://console.cloud.tencent.com/cam/capi) 新建密钥,<br>生成 AppID、SecretID 和 SecretKey ,用于 API 调用时生成签名,签名将用来进行接口鉴权。
* @param req CreateRecTaskRequest
* @return CreateRecTaskOutcome
*/
CreateRecTaskOutcome CreateRecTask(const Model::CreateRecTaskRequest &request);
void CreateRecTaskAsync(const Model::CreateRecTaskRequest& request, const CreateRecTaskAsyncHandler& handler, const std::shared_ptr<const AsyncCallerContext>& context = nullptr);
CreateRecTaskOutcomeCallable CreateRecTaskCallable(const Model::CreateRecTaskRequest& request);

现暂只支持中文普通话和带有一定方言口音的中文普通话识别,支持识别8k16bit和16k16bit的mp3或者wav格式的单声道音频。
/**
*本接口需要配合录音文件识别请求接口使用,单独使用无效。在调用录音文件识别接口后,可以在本接口传入TaskID来轮询识别结果。
* @param req DescribeTaskStatusRequest
* @return DescribeTaskStatusOutcome
*/
DescribeTaskStatusOutcome DescribeTaskStatus(const Model::DescribeTaskStatusRequest &request);
void DescribeTaskStatusAsync(const Model::DescribeTaskStatusRequest& request, const DescribeTaskStatusAsyncHandler& handler, const std::shared_ptr<const AsyncCallerContext>& context = nullptr);
DescribeTaskStatusOutcomeCallable DescribeTaskStatusCallable(const Model::DescribeTaskStatusRequest& request);

/**
*本接口用于对60秒之内的短音频文件进行识别。
<br>• 支持中文普通话、英语、粤语和带有一定方言口音的中文普通话识别。
<br>• 支持本地语音文件上传和语音URL上传两种请求方式。
<br>• 音频格式支持wav、mp3;采样率支持8000Hz或者16000Hz;采样精度支持16bits;声道支持单声道。
<br>• 当音频文件通过请求中body内容上传时,请求大小不能超过600KB;当音频以URL方式传输时,音频时长不可超过60s。
<br>• 所有请求参数放在POST请求的body中,编码类型采用x-www-form-urlencoded,参数进行urlencode编码后传输。
* @param req SentenceRecognitionRequest
* @return SentenceRecognitionOutcome
*/
Expand Down
245 changes: 245 additions & 0 deletions asr/include/tencentcloud/asr/v20190614/model/CreateRecTaskRequest.h
@@ -0,0 +1,245 @@
/*
* Copyright (c) 2017-2019 THL A29 Limited, a Tencent company. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

#ifndef TENCENTCLOUD_ASR_V20190614_MODEL_CREATERECTASKREQUEST_H_
#define TENCENTCLOUD_ASR_V20190614_MODEL_CREATERECTASKREQUEST_H_

#include <string>
#include <vector>
#include <map>
#include <tencentcloud/core/AbstractModel.h>


namespace TencentCloud
{
namespace Asr
{
namespace V20190614
{
namespace Model
{
/**
* CreateRecTask请求参数结构体
*/
class CreateRecTaskRequest : public AbstractModel
{
public:
CreateRecTaskRequest();
~CreateRecTaskRequest() = default;
std::string ToJsonString() const;


/**
* 获取引擎类型。8k_0:电话 8k 通用模型;16k_0:16k 通用模型;8k_6: 电话场景下单声道话者分离模型。
* @return EngineModelType 引擎类型。8k_0:电话 8k 通用模型;16k_0:16k 通用模型;8k_6: 电话场景下单声道话者分离模型。
*/
std::string GetEngineModelType() const;

/**
* 设置引擎类型。8k_0:电话 8k 通用模型;16k_0:16k 通用模型;8k_6: 电话场景下单声道话者分离模型。
* @param EngineModelType 引擎类型。8k_0:电话 8k 通用模型;16k_0:16k 通用模型;8k_6: 电话场景下单声道话者分离模型。
*/
void SetEngineModelType(const std::string& _engineModelType);

/**
* 判断参数 EngineModelType 是否已赋值
* @return EngineModelType 是否已赋值
*/
bool EngineModelTypeHasBeenSet() const;

/**
* 获取语音声道数。1:单声道;2:双声道(仅在电话 8k 通用模型下支持)。
* @return ChannelNum 语音声道数。1:单声道;2:双声道(仅在电话 8k 通用模型下支持)。
*/
uint64_t GetChannelNum() const;

/**
* 设置语音声道数。1:单声道;2:双声道(仅在电话 8k 通用模型下支持)。
* @param ChannelNum 语音声道数。1:单声道;2:双声道(仅在电话 8k 通用模型下支持)。
*/
void SetChannelNum(const uint64_t& _channelNum);

/**
* 判断参数 ChannelNum 是否已赋值
* @return ChannelNum 是否已赋值
*/
bool ChannelNumHasBeenSet() const;

/**
* 获取识别结果文本编码方式。0:UTF-8。
* @return ResTextFormat 识别结果文本编码方式。0:UTF-8。
*/
uint64_t GetResTextFormat() const;

/**
* 设置识别结果文本编码方式。0:UTF-8。
* @param ResTextFormat 识别结果文本编码方式。0:UTF-8。
*/
void SetResTextFormat(const uint64_t& _resTextFormat);

/**
* 判断参数 ResTextFormat 是否已赋值
* @return ResTextFormat 是否已赋值
*/
bool ResTextFormatHasBeenSet() const;

/**
* 获取语音数据来源。0:语音 URL;1:语音数据(post body)。
* @return SourceType 语音数据来源。0:语音 URL;1:语音数据(post body)。
*/
uint64_t GetSourceType() const;

/**
* 设置语音数据来源。0:语音 URL;1:语音数据(post body)。
* @param SourceType 语音数据来源。0:语音 URL;1:语音数据(post body)。
*/
void SetSourceType(const uint64_t& _sourceType);

/**
* 判断参数 SourceType 是否已赋值
* @return SourceType 是否已赋值
*/
bool SourceTypeHasBeenSet() const;

/**
* 获取回调 URL,用户自行搭建的用于接收识别结果的服务器地址, 长度小于2048字节。
* @return CallbackUrl 回调 URL,用户自行搭建的用于接收识别结果的服务器地址, 长度小于2048字节。
*/
std::string GetCallbackUrl() const;

/**
* 设置回调 URL,用户自行搭建的用于接收识别结果的服务器地址, 长度小于2048字节。
* @param CallbackUrl 回调 URL,用户自行搭建的用于接收识别结果的服务器地址, 长度小于2048字节。
*/
void SetCallbackUrl(const std::string& _callbackUrl);

/**
* 判断参数 CallbackUrl 是否已赋值
* @return CallbackUrl 是否已赋值
*/
bool CallbackUrlHasBeenSet() const;

/**
* 获取语音的URL地址,需要公网可下载。长度小于2048字节,当 source_type 值为 0 时须填写该字段,为 1 时不需要填写。注意:请确保录音文件时长在一个小时之内,否则可能识别失败。请保证文件的下载速度,否则可能下载失败。
* @return Url 语音的URL地址,需要公网可下载。长度小于2048字节,当 source_type 值为 0 时须填写该字段,为 1 时不需要填写。注意:请确保录音文件时长在一个小时之内,否则可能识别失败。请保证文件的下载速度,否则可能下载失败。
*/
std::string GetUrl() const;

/**
* 设置语音的URL地址,需要公网可下载。长度小于2048字节,当 source_type 值为 0 时须填写该字段,为 1 时不需要填写。注意:请确保录音文件时长在一个小时之内,否则可能识别失败。请保证文件的下载速度,否则可能下载失败。
* @param Url 语音的URL地址,需要公网可下载。长度小于2048字节,当 source_type 值为 0 时须填写该字段,为 1 时不需要填写。注意:请确保录音文件时长在一个小时之内,否则可能识别失败。请保证文件的下载速度,否则可能下载失败。
*/
void SetUrl(const std::string& _url);

/**
* 判断参数 Url 是否已赋值
* @return Url 是否已赋值
*/
bool UrlHasBeenSet() const;

/**
* 获取语音数据,当SourceType 值为1时必须填写,为0可不写。要base64编码(采用python语言时注意读取文件应该为string而不是byte,以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。音频数据要小于5MB。
* @return Data 语音数据,当SourceType 值为1时必须填写,为0可不写。要base64编码(采用python语言时注意读取文件应该为string而不是byte,以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。音频数据要小于5MB。
*/
std::string GetData() const;

/**
* 设置语音数据,当SourceType 值为1时必须填写,为0可不写。要base64编码(采用python语言时注意读取文件应该为string而不是byte,以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。音频数据要小于5MB。
* @param Data 语音数据,当SourceType 值为1时必须填写,为0可不写。要base64编码(采用python语言时注意读取文件应该为string而不是byte,以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。音频数据要小于5MB。
*/
void SetData(const std::string& _data);

/**
* 判断参数 Data 是否已赋值
* @return Data 是否已赋值
*/
bool DataHasBeenSet() const;

/**
* 获取数据长度,当 SourceType 值为1时必须填写,为0可不写(此数据长度为数据未进行base64编码时的数据长度)。
* @return DataLen 数据长度,当 SourceType 值为1时必须填写,为0可不写(此数据长度为数据未进行base64编码时的数据长度)。
*/
uint64_t GetDataLen() const;

/**
* 设置数据长度,当 SourceType 值为1时必须填写,为0可不写(此数据长度为数据未进行base64编码时的数据长度)。
* @param DataLen 数据长度,当 SourceType 值为1时必须填写,为0可不写(此数据长度为数据未进行base64编码时的数据长度)。
*/
void SetDataLen(const uint64_t& _dataLen);

/**
* 判断参数 DataLen 是否已赋值
* @return DataLen 是否已赋值
*/
bool DataLenHasBeenSet() const;

private:

/**
* 引擎类型。8k_0:电话 8k 通用模型;16k_0:16k 通用模型;8k_6: 电话场景下单声道话者分离模型。
*/
std::string m_engineModelType;
bool m_engineModelTypeHasBeenSet;

/**
* 语音声道数。1:单声道;2:双声道(仅在电话 8k 通用模型下支持)。
*/
uint64_t m_channelNum;
bool m_channelNumHasBeenSet;

/**
* 识别结果文本编码方式。0:UTF-8。
*/
uint64_t m_resTextFormat;
bool m_resTextFormatHasBeenSet;

/**
* 语音数据来源。0:语音 URL;1:语音数据(post body)。
*/
uint64_t m_sourceType;
bool m_sourceTypeHasBeenSet;

/**
* 回调 URL,用户自行搭建的用于接收识别结果的服务器地址, 长度小于2048字节。
*/
std::string m_callbackUrl;
bool m_callbackUrlHasBeenSet;

/**
* 语音的URL地址,需要公网可下载。长度小于2048字节,当 source_type 值为 0 时须填写该字段,为 1 时不需要填写。注意:请确保录音文件时长在一个小时之内,否则可能识别失败。请保证文件的下载速度,否则可能下载失败。
*/
std::string m_url;
bool m_urlHasBeenSet;

/**
* 语音数据,当SourceType 值为1时必须填写,为0可不写。要base64编码(采用python语言时注意读取文件应该为string而不是byte,以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。音频数据要小于5MB。
*/
std::string m_data;
bool m_dataHasBeenSet;

/**
* 数据长度,当 SourceType 值为1时必须填写,为0可不写(此数据长度为数据未进行base64编码时的数据长度)。
*/
uint64_t m_dataLen;
bool m_dataLenHasBeenSet;

};
}
}
}
}

#endif // !TENCENTCLOUD_ASR_V20190614_MODEL_CREATERECTASKREQUEST_H_

0 comments on commit 92fe178

Please sign in to comment.