v20190614

package
v3.0.117+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 6, 2020 License: Apache-2.0 Imports: 4 Imported by: 0

Documentation

Index

Constants

View Source 
const APIVersion = "2019-06-14"

Variables

This section is empty.

Functions

This section is empty.

Types

type Client 

type Client struct {
	common.Client
}

func NewClient 

func NewClient(credential *common.Credential, region string, clientProfile *profile.ClientProfile) (client *Client, err error)

func NewClientWithSecretId 

func NewClientWithSecretId(secretId, secretKey, region string) (client *Client, err error)

Deprecated

func (*Client) CreateRecTask 

func (c *Client) CreateRecTask(request *CreateRecTaskRequest) (response *CreateRecTaskResponse, err error)

本接口服务对录音时长1小时以内的录音文件进行识别，异步返回识别全部结果。 <br>• 接口是 HTTP RESTful 形式 <br>• 接口支持wav、mp3、silk、amr、m4a等主流音频格式 <br>• 支持语音 URL 和本地语音文件两种请求方式 <br>• 本地语音文件上传的文件不能大于5MB，语音 URL的音频时长不能长于1小时 <br>• 支持中文普通话、英语和粤语。 <br>• 支持回调或轮询的方式获取结果，结果获取请参考[ 录音文件识别结果查询](https://cloud.tencent.com/document/product/1093/37822)。

func (*Client) DescribeTaskStatus 

func (c *Client) DescribeTaskStatus(request *DescribeTaskStatusRequest) (response *DescribeTaskStatusResponse, err error)

在调用录音文件识别请求接口后，有回调和轮询两种方式获取识别结果。 <br>• 当采用回调方式时，识别完成后会将结果通过 POST 请求的形式通知到用户在请求时填写的回调 URL，具体请参见[ 录音识别结果回调 ](https://cloud.tencent.com/document/product/1093/37139#callback)。 <br>• 当采用轮询方式时，需要主动提交任务ID来轮询识别结果，共有任务成功、等待、执行中和失败四种结果，具体信息请参见下文说明。

func (*Client) SentenceRecognition 

func (c *Client) SentenceRecognition(request *SentenceRecognitionRequest) (response *SentenceRecognitionResponse, err error)

本接口用于对60秒之内的短音频文件进行识别。 <br>• 支持中文普通话、英语、粤语。 <br>• 支持本地语音文件上传和语音URL上传两种请求方式。 <br>• 音频格式支持wav、mp3；采样率支持8000Hz或者16000Hz；采样精度支持16bits；声道支持单声道。 <br>• 当音频文件通过请求中body内容上传时，请求大小不能超过600KB；当音频以URL方式传输时，音频时长不可超过60s。 <br>• 所有请求参数放在POST请求的body中，编码类型采用x-www-form-urlencoded，参数进行urlencode编码后传输。

type CreateRecTaskRequest 

type CreateRecTaskRequest struct {
	*tchttp.BaseRequest

	// 引擎模型类型。
	// 8k_0：电话 8k 中文普通话通用，可用于双声道音频的识别；
	// 8k_6：电话 8k 中文普通话话者分离，仅用于单声道；
	// 16k_0：16k 中文普通话通用；
	// 16k_en：16k 英语；
	// 16k_ca：16k 粤语。
	EngineModelType *string `json:"EngineModelType,omitempty" name:"EngineModelType"`

	// 语音声道数。1：单声道；2：双声道（仅在电话 8k 通用模型下支持）。
	ChannelNum *uint64 `json:"ChannelNum,omitempty" name:"ChannelNum"`

	// 识别结果文本编码方式。0：UTF-8。
	ResTextFormat *uint64 `json:"ResTextFormat,omitempty" name:"ResTextFormat"`

	// 语音数据来源。0：语音 URL；1：语音数据（post body）。
	SourceType *uint64 `json:"SourceType,omitempty" name:"SourceType"`

	// 回调 URL，用户自行搭建的用于接收识别结果的服务器地址， 长度小于2048字节。如果用户使用回调方式获取识别结果，需提交该参数；如果用户使用轮询方式获取识别结果，则无需提交该参数。
	CallbackUrl *string `json:"CallbackUrl,omitempty" name:"CallbackUrl"`

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

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

	// 数据长度，当 SourceType 值为1时必须填写，为0可不写（此数据长度为数据未进行base64编码时的数据长度）。
	DataLen *uint64 `json:"DataLen,omitempty" name:"DataLen"`
}

func NewCreateRecTaskRequest 

func NewCreateRecTaskRequest() (request *CreateRecTaskRequest)

func (*CreateRecTaskRequest) FromJsonString 

func (r *CreateRecTaskRequest) FromJsonString(s string) error

func (*CreateRecTaskRequest) ToJsonString 

func (r *CreateRecTaskRequest) ToJsonString() string

type CreateRecTaskResponse 

type CreateRecTaskResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 录音文件识别的请求返回结果，包含结果查询需要的TaskId
		Data *Task `json:"Data,omitempty" name:"Data"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

func NewCreateRecTaskResponse 

func NewCreateRecTaskResponse() (response *CreateRecTaskResponse)

func (*CreateRecTaskResponse) FromJsonString 

func (r *CreateRecTaskResponse) FromJsonString(s string) error

func (*CreateRecTaskResponse) ToJsonString 

func (r *CreateRecTaskResponse) ToJsonString() string

type DescribeTaskStatusRequest 

type DescribeTaskStatusRequest struct {
	*tchttp.BaseRequest

	// 从CreateRecTask接口获取的TaskId，用于获取任务状态与结果。
	TaskId *uint64 `json:"TaskId,omitempty" name:"TaskId"`
}

func NewDescribeTaskStatusRequest 

func NewDescribeTaskStatusRequest() (request *DescribeTaskStatusRequest)

func (*DescribeTaskStatusRequest) FromJsonString 

func (r *DescribeTaskStatusRequest) FromJsonString(s string) error

func (*DescribeTaskStatusRequest) ToJsonString 

func (r *DescribeTaskStatusRequest) ToJsonString() string

type DescribeTaskStatusResponse 

type DescribeTaskStatusResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 录音文件识别的请求返回结果。
		Data *TaskStatus `json:"Data,omitempty" name:"Data"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

func NewDescribeTaskStatusResponse 

func NewDescribeTaskStatusResponse() (response *DescribeTaskStatusResponse)

func (*DescribeTaskStatusResponse) FromJsonString 

func (r *DescribeTaskStatusResponse) FromJsonString(s string) error

func (*DescribeTaskStatusResponse) ToJsonString 

func (r *DescribeTaskStatusResponse) ToJsonString() string

type SentenceRecognitionRequest 

type SentenceRecognitionRequest struct {
	*tchttp.BaseRequest

	// 腾讯云项目 ID，可填 0，总长度不超过 1024 字节。
	ProjectId *uint64 `json:"ProjectId,omitempty" name:"ProjectId"`

	// 子服务类型。2： 一句话识别。
	SubServiceType *uint64 `json:"SubServiceType,omitempty" name:"SubServiceType"`

	// 引擎类型。
	// 8k：电话 8k 中文普通话通用；
	// 16k：16k 中文普通话通用；
	// 16k_en：16k 英语；
	// 16k_ca：16k 粤语。
	EngSerViceType *string `json:"EngSerViceType,omitempty" name:"EngSerViceType"`

	// 语音数据来源。0：语音 URL；1：语音数据（post body）。
	SourceType *uint64 `json:"SourceType,omitempty" name:"SourceType"`

	// 识别音频的音频格式。mp3、wav。
	VoiceFormat *string `json:"VoiceFormat,omitempty" name:"VoiceFormat"`

	// 用户端对此任务的唯一标识，用户自助生成，用于用户查找识别结果。
	UsrAudioKey *string `json:"UsrAudioKey,omitempty" name:"UsrAudioKey"`

	// 语音 URL，公网可下载。当 SourceType 值为 0（语音 URL上传） 时须填写该字段，为 1 时不填；URL 的长度大于 0，小于 2048，需进行urlencode编码。音频时间长度要小于60s。
	Url *string `json:"Url,omitempty" name:"Url"`

	// 语音数据，当SourceType 值为1（本地语音数据上传）时必须填写，当SourceType 值为0（语音 URL上传）可不写。要使用base64编码(采用python语言时注意读取文件应该为string而不是byte，以byte格式读取后要decode()。编码后的数据不可带有回车换行符)。音频数据要小于600KB。
	Data *string `json:"Data,omitempty" name:"Data"`

	// 数据长度，单位为字节。当 SourceType 值为1（本地语音数据上传）时必须填写，当 SourceType 值为0（语音 URL上传）可不写（此数据长度为数据未进行base64编码时的数据长度）。
	DataLen *int64 `json:"DataLen,omitempty" name:"DataLen"`
}

func NewSentenceRecognitionRequest 

func NewSentenceRecognitionRequest() (request *SentenceRecognitionRequest)

func (*SentenceRecognitionRequest) FromJsonString 

func (r *SentenceRecognitionRequest) FromJsonString(s string) error

func (*SentenceRecognitionRequest) ToJsonString 

func (r *SentenceRecognitionRequest) ToJsonString() string

type SentenceRecognitionResponse 

type SentenceRecognitionResponse struct {
	*tchttp.BaseResponse
	Response *struct {

		// 识别结果。
		Result *string `json:"Result,omitempty" name:"Result"`

		// 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
		RequestId *string `json:"RequestId,omitempty" name:"RequestId"`
	} `json:"Response"`
}

func NewSentenceRecognitionResponse 

func NewSentenceRecognitionResponse() (response *SentenceRecognitionResponse)

func (*SentenceRecognitionResponse) FromJsonString 

func (r *SentenceRecognitionResponse) FromJsonString(s string) error

func (*SentenceRecognitionResponse) ToJsonString 

func (r *SentenceRecognitionResponse) ToJsonString() string

type Task 

type Task struct {

	// 任务ID，可通过此ID在轮询接口获取识别状态与结果
	TaskId *uint64 `json:"TaskId,omitempty" name:"TaskId"`
}

type TaskStatus 

type TaskStatus struct {

	// 任务标识。
	TaskId *uint64 `json:"TaskId,omitempty" name:"TaskId"`

	// 任务状态码，0：任务等待，1：任务执行中，2：任务成功，3：任务失败。
	Status *int64 `json:"Status,omitempty" name:"Status"`

	// 任务状态，waiting：任务等待，doing：任务执行中，success：任务成功，failed：任务失败。
	StatusStr *string `json:"StatusStr,omitempty" name:"StatusStr"`

	// 识别结果。
	Result *string `json:"Result,omitempty" name:"Result"`

	// 失败原因说明。
	ErrorMsg *string `json:"ErrorMsg,omitempty" name:"ErrorMsg"`
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.