Go Demo

本文介绍了如何使用阿里云智能语音服务提供的Go SDK,包括SDK的安装方法及SDK代码示例。

前提条件

  • 使用SDK前,请先阅读接口说明,详情请参见接口说明

  • 已开通智能语音交互并获取AccessKey ID和AccessKey Secret,详情请参见从这里开始

示例说明

  • 录音文件识别示例使用Go SDK的CommonRequest提交识别请求和查询识别结果,采用RPC风格的POP API调用方式。

  • 关于阿里云Go SDK,请参见使用阿里云Go SDK

  • Go SDK CommonRequest的使用方法,请参见使用CommonRequest进行调用

SDK安装

阿里云Go SDK支持Go 1.7及以上版本,您可以通过如下方式安装:

  • 使用Glide(推荐)

    glide get github.com/aliyun/alibaba-cloud-sdk-go
  • 使用govendor:

    go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk

调用步骤

  1. 创建并初始化阿里云鉴权对象。

    鉴权使用阿里云账号的AccessKey ID和AccessKey Secret。

  2. 创建录音文件识别请求,并设置请求参数。

  3. 提交录音文件识别请求,处理服务端返回的响应同时获取任务ID。

  4. 创建识别结果查询请求,设置查询参数为任务ID。

  5. 轮询识别结果。

代码示例

  • 下载nls-sample-16k.wav。该录音文件为PCM编码格式16000Hz采样率,管控台设置的模型为通用模型。如果使用其他录音文件,请填入对应的编码格式和采样率,并在管控台设置对应的模型,模型设置请参见管理项目

  • 调用接口前,需配置环境变量,通过环境变量读取访问凭证。智能语音交互的AccessKey ID、AccessKey Secret和AppKey的环境变量名:ALIYUN_AK_IDALIYUN_AK_SECRETNLS_APP_KEY

package main
import (
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk"
    "fmt"
    "encoding/json"
    "time"
)
func main() {
    // 地域ID,固定值。
    const REGION_ID string = "cn-shanghai"
    const ENDPOINT_NAME string = "cn-shanghai"
    const PRODUCT string = "nls-filetrans"
    const DOMAIN string = "filetrans.cn-shanghai.aliyuncs.com"
    const API_VERSION string = "2018-08-17"
    const POST_REQUEST_ACTION string = "SubmitTask"
    const GET_REQUEST_ACTION  string = "GetTaskResult"
    // 请求参数
    const KEY_APP_KEY string = "appkey"      //此处appkey无需替换。
    const KEY_FILE_LINK string = "file_link"
    const KEY_VERSION string = "version"
    const KEY_ENABLE_WORDS string = "enable_words"
    // 响应参数
    const KEY_TASK string = "Task"
    const KEY_TASK_ID string = "TaskId"
    const KEY_STATUS_TEXT string = "StatusText"
    const KEY_RESULT string = "Result"
    // 状态值
    const STATUS_SUCCESS string = "SUCCESS"
    const STATUS_RUNNING string = "RUNNING"
    const STATUS_QUEUEING string = "QUEUEING"
    var accessKeyId string = os.Getenv("ALIYUN_AK_ID")     //获取AccessKey ID和AccessKey Secret请前往控制台:https://ram.console.aliyun.com/manage/ak
    var accessKeySecret string = os.Getenv("ALIYUN_AK_SECRET")
    var appKey string = os.Getenv("NLS_APP_KEY")
    var fileLink string = "https://gw.alipayobjects.com/os/bmw-prod/0574ee2e-f494-45a5-820f-63aee583045a.wav"
    client, err := sdk.NewClientWithAccessKey(REGION_ID, accessKeyId, accessKeySecret)
    if err != nil {
        panic(err)
    }
    postRequest := requests.NewCommonRequest()
    postRequest.Domain = DOMAIN
    postRequest.Version = API_VERSION
    postRequest.Product = PRODUCT
    postRequest.ApiName = POST_REQUEST_ACTION
    postRequest.Method = "POST"
    mapTask := make(map[string]string)
    mapTask[KEY_APP_KEY] = appKey
    mapTask[KEY_FILE_LINK] = fileLink
    // 新接入请使用4.0版本,已接入(默认2.0)如需维持现状,请注释掉该参数设置。
    mapTask[KEY_VERSION] = "4.0"
    // 设置是否输出词信息,默认为false。开启时需要设置version为4.0。
    mapTask[KEY_ENABLE_WORDS] = "false"
    task, err := json.Marshal(mapTask)
    if err != nil {
        panic(err)
    }
    postRequest.FormParams[KEY_TASK] = string(task)
    postResponse, err := client.ProcessCommonRequest(postRequest)
    if err != nil {
        panic(err)
    }
    postResponseContent := postResponse.GetHttpContentString()
    fmt.Println(postResponseContent)
    if (postResponse.GetHttpStatus() != 200) {
        fmt.Println("录音文件识别请求失败,Http错误码: ", postResponse.GetHttpStatus())
        return
    }
    var postMapResult map[string]interface{}
    err = json.Unmarshal([]byte(postResponseContent), &postMapResult)
    if err != nil {
        panic(err)
    }
    var taskId string = ""
    var statusText string = ""
    statusText = postMapResult[KEY_STATUS_TEXT].(string)
    if statusText == STATUS_SUCCESS {
        fmt.Println("录音文件识别请求成功响应!")
        taskId = postMapResult[KEY_TASK_ID].(string)
    } else {
        fmt.Println("录音文件识别请求失败!")
        return
    }
    getRequest := requests.NewCommonRequest()
    getRequest.Domain = DOMAIN
    getRequest.Version = API_VERSION
    getRequest.Product = PRODUCT
    getRequest.ApiName = GET_REQUEST_ACTION
    getRequest.Method = "GET"
    getRequest.QueryParams[KEY_TASK_ID] = taskId
    statusText = ""
    for true {
        getResponse, err := client.ProcessCommonRequest(getRequest)
        if err != nil {
            panic(err)
        }
        getResponseContent := getResponse.GetHttpContentString()
        fmt.Println("识别查询结果:", getResponseContent)
        if (getResponse.GetHttpStatus() != 200) {
            fmt.Println("识别结果查询请求失败,Http错误码:", getResponse.GetHttpStatus())
            break
        }
        var getMapResult map[string]interface{}
        err = json.Unmarshal([]byte(getResponseContent), &getMapResult)
        if err != nil {
            panic(err)
        }
        statusText = getMapResult[KEY_STATUS_TEXT].(string)
        if statusText == STATUS_RUNNING || statusText == STATUS_QUEUEING {
            time.Sleep(10 * time.Second)
        } else {
            break
        }
    }
    if statusText == STATUS_SUCCESS {
        fmt.Println("录音文件识别成功!")
    } else {
        fmt.Println("录音文件识别失败!")
    }
}