日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

Go SDK

本文介紹如何使用阿里云智能語音服務提供的Go SDK,包括SDK的安裝方法及SDK代碼示例。

前提條件

在使用SDK前,請先閱讀接口說明,詳情請參見接口說明

下載安裝

說明
  • SDK支持Go 1.16及以上版本。

  • 請確認已經安裝Golang環境,并完成基本配置。

  1. 下載并安裝SDK。

    通過以下命令完成SDK下載和安裝。

    go get github.com/aliyun/alibabacloud-nls-go-sdk
  2. 導入SDK。

    在代碼中通過添加以下字段導入SDK。

    import ("github.com/aliyun/alibabacloud-nls-go-sdk")

SDK常量

常量

含義

SDK_VERSION

SDK版本。

PCM

PCM音頻格式。

WAV

WAV音頻格式。

OPUS

OPUS音頻格式。

OPU

OPU音頻格式。

DEFAULT_DISTRIBUTE

獲取Token時使用的默認區域,默認為"cn-shanghai"。

DEFAULT_DOMAIN

獲取Token時使用的默認URL,默認為"nls-meta.cn-shanghai.aliyuncs.com"。

DEFAULT_VERSION

獲取Token時使用的協議版本,默認為"2019-02-28"。

DEFAULT_URL

默認公有云URL,默認為"wss://nls-gateway-cn-shanghai.aliyuncs.com/ws/v1"。

建立連接

重要

使用AkidAkkey來獲取Token時,建議針對Token進行緩存,并根據獲取Token時獲得的過期時間參數進行及時更新;請勿頻繁調用獲取Token的接口,否則會造成云端限流。

1.ConnectionConfig

用于建立連接的基礎參數。

參數說明:

參數

類型

參數說明

Url

String

訪問的公共云URL,如果不確定,可以使用常量DEFAULT_URL

Token

String

訪問Token,詳情可參見獲取Token概述

Akid

String

阿里云賬號AccessKey ID。

  • 若未填寫Token字段,則需要填寫該字段。

  • 若已填寫Token字段,則該字段可不填寫。

Akkey

String

阿里云賬號AccessKey Secret。

  • 若未填寫Token字段,則需要填寫該字段。

  • 若已填寫Token字段,則該字段可不填寫。

Appkey

String

對應項目Appkey。獲取Appkey請前往控制臺

2.func NewConnectionConfigWithToken(url string, appkey string, token string) *ConnectionConfig

通過URL、Appkey和Token創建連接參數。

  • 參數說明:

參數

類型

參數說明

Url

String

訪問的公共云URL,如果不確定,可以使用常量DEFAULT_URL

Appkey

String

對應項目Appkey。獲取Appkey請前往控制臺

Token

String

訪問Token,詳情可參見獲取Token概述

  • 返回值:

*ConnectionConfig:連接配置對象指針。

3. func NewConnectionConfigFromJson(jsonStr string) (*ConnectionConfig, error)

通過JSON字符串來創建連接參數。

  • 參數說明:

參數

類型

參數說明

jsonStr

String

描述連接參數的JSON字符串,有效字段如下:urltokenakidakkeyappkey。其中必須包含urlappkey,如果包含Token則不需要包含akidakkey

  • 返回值:

*ConnectionConfig:連接配置對象指針。

實時語音識別

1. SpeechTranscriptionStartParam

實時語音識別參數。

參數

類型

參數說明

Format

String

音頻格式,默認值:PCM。取值為OPUS、OPU和PCM,如果是OPUS或OPU時,您需要自行編碼。

SampleRate

Integer

采樣率,默認值:16000 Hz。

EnableIntermediateResult

Boolean

是否打開中間結果返回。

  • true:打開。

  • false:關閉。

EnablePunctuationPrediction

Boolean

是否打開標點預測。

  • true:打開。

  • false:關閉。

EnableInverseTextNormalization

Boolean

ITN(逆文本inverse text normalization)中文數字轉換阿拉伯數字。設置為True時,中文數字將轉為阿拉伯數字輸出,默認值:False。

MaxSentenceSilence

Integer

語音斷句檢測閾值。靜音時長超過該閾值會被認為斷句,合法參數范圍200~2000毫秒,默認值800毫秒。

enable_words

Boolean

是否開啟返回詞信息。默認不開啟。

  • true:開啟。

  • false:不開啟。

2. func DefaultSpeechTranscriptionParam() SpeechTranscriptionStartParam

創建一個默認參數。

  • 參數說明:無。

  • 返回值:

    SpeechTranscriptionStartParam:默認參數。

3. func NewSpeechTranscription(...) (*SpeechTranscription, error)

創建一個實時語音識別對象。

  • 參數說明:

參數

類型

參數說明

config

*ConnectionConfig

參見建立連接相關內容。

logger

*NlsLogger

參見SDK日志相關內容。

taskfailed

func(string, interface{})

識別過程中的錯誤處理回調參數,interface{}為用戶自定義參數。

started

func(string, interface{})

建連完成回調參數。

sentencebegin

func(string, interface{})

一句話開始。

sentenceend

func(string, interface{})

一句話結束。

resultchanged

func(string, interface{})

識別中間結果回調參數。

completed

func(string, interface{})

最終識別結果回調參數。

closed

func(interface{})

連接斷開回調參數。

param

interface{}

用戶自定義參數。

  • 返回值:

    • *SpeechRecognition:識別對象指針。

    • error:錯誤異常。

4. func (st *SpeechTranscription) Start(param SpeechTranscriptionStartParam, extra map[string]interface{}) (chan bool, error)

開始實時語音識別。

  • 參數說明:

參數

類型

參數說明

param

SpeechTranscriptionStartParam

實時語音識別參數。

extra

map[string]interface{}

額外key:value參數。

  • 返回值:

    • chan bool:同步start完成的管道。

    • error:錯誤異常。

5. func (st *SpeechTranscription) Stop() (chan bool, error)

停止實時語音識別。

  • 參數說明:無。

  • 返回值:

    • chan bool:同步stop完成的管道。

    • error:錯誤異常。

6. func (st *SpeechTranscription) Ctrl(param map[string]interface{}) error

發送控制命令,可先查看接口說明

  • 參數說明:無。

    參數

    類型

    參數說明

    param

    map[string]interface{}

    自定義控制命令,該字典內容會以key:value形式合并進請求的payload段中。

  • 返回值:

    error:錯誤異常。

7. func (st *SpeechTranscription) Shutdown()

強制停止實時語音識別。

  • 參數說明:無。

  • 返回值:無。

8. func (sr *SpeechTranscription) SendAudioData(data []byte) error

發送音頻,音頻格式必須和參數中一致。

  • 參數說明:

參數

類型

參數說明

data

[]byte

音頻數據。

  • 返回值:

error:錯誤異常。

SDK日志

1.func DefaultNlsLog() *NlsLogger

用于創建全局唯一的默認日志對象,默認日志以NLS為前綴,輸出到標準錯誤。

  • 參數說明:無。

  • 返回值:

NlsLogger:日志對象指針。

2.func NewNlsLogger(w io.Writer, tag string, flag int) *NlsLogger

創建一個新的日志。

  • 參數說明:

參數

類型

參數說明

w

io.Writer

任意實現io.Writer接口的對象。

tag

String

日志前綴,會打印到日志行首部。

flag

Integer

日志flag,具體請參見Go官方log文檔

  • 返回值:

NlsLogger:日志對象指針。

3.func (logger *NlsLogger) SetLogSil(sil bool)

設置日志是否輸出到對應的io.Writer。

  • 參數說明:

參數

類型

參數說明

sil

Boolean

是否禁止日志輸出。

  • true:禁止。

  • false:允許。

  • 返回值:無。

4.func (logger *NlsLogger) SetDebug(debug bool)

設置是否打印Debug日志,僅影響通過Debugf或Debugln進行輸出的日志。

  • 參數說明:

參數

類型

參數說明

debug

Boolean

是否允許Debug日志輸出。

  • true:允許。

  • false:禁止。

  • 返回值:無。

5. func (logger *NlsLogger) SetOutput(w io.Writer)

設置日志輸出方式。

  • 參數說明:

參數

類型 

參數說明

w

io.Writer

任意實現io.Writer接口的對象。

  • 返回值:無。

6. func (logger *NlsLogger) SetPrefix(prefix string)

設置日志行的標簽。

  • 參數說明:

參數

類型

參數說明

prefix

String

日志行標簽,會輸出在日志行行首。

  • 返回值:無。

7. func (logger *NlsLogger) SetFlags(flags int)

設置日志屬性。

  • 參數說明:

參數

類型

參數說明

flags

Integer

日志屬性,具體請參見Go官方文檔

  • 返回值:無。

8. 日志打印

日志打印方法:

方法名

方法說明

func (l *NlsLogger) Print(v ...interface{})

標準日志輸出。

func (l *NlsLogger) Println(v ...interface{})

標注日志輸出,行尾自動換行。

func (l *NlsLogger) Printf(format string, v ...interface{})

帶Format的日志輸出,Format方式見具體請參見Go官方文檔

func (l *NlsLogger) Debugln(v ...interface{})

Debug信息日志輸出,行尾自動換行。

func (l *NlsLogger) Debugf(format string, v ...interface{})

帶Format的Debug信息日志輸出。

func (l *NlsLogger) Fatal(v ...interface{})

致命錯誤日志輸出,輸出后自動進程退出。

func (l *NlsLogger) Fatalln(v ...interface{})

致命錯誤日志輸出,行尾自動換行,輸出后自動進程退出。

func (l *NlsLogger) Fatalf(format string, v ...interface{})

帶Format的致命錯誤日志輸出,輸出后自動進程退出。

func (l *NlsLogger) Panic(v ...interface{})

致命錯誤日志輸出,輸出后自動進程退出并打印崩潰信息。

func (l *NlsLogger) Panicln(v ...interface{})

致命錯誤日志輸出,行尾自動換行,輸出后自動進程退出并打印崩潰信息。

func (l *NlsLogger) Panicf(format string, v ...interface{})

帶Format的致命錯誤日志輸出,輸出后自動進程退出并打印崩潰信息。

代碼示例

package main

import (
        "errors"
        "flag"
        "fmt"
        "log"
        "os"
        "os/signal"
        "sync"
        "time"

        "github.com/aliyun/alibabacloud-nls-go-sdk"
)

const (
    AKID  = "Your AKID"
        AKKEY = "Your AKKEY"
        //online key
        APPKEY = "Your APPKEY"
        TOKEN  = "Your TOKEN"
)

func onTaskFailed(text string, param interface{}) {
        logger, ok := param.(*nls.NlsLogger)
        if !ok {
                log.Default().Fatal("invalid logger")
                return
        }

        logger.Println("TaskFailed:", text)
}

func onStarted(text string, param interface{}) {
        logger, ok := param.(*nls.NlsLogger)
        if !ok {
                log.Default().Fatal("invalid logger")
                return
        }

        logger.Println("onStarted:", text)
}

func onSentenceBegin(text string, param interface{}) {
        logger, ok := param.(*nls.NlsLogger)
        if !ok {
                log.Default().Fatal("invalid logger")
                return
        }

        logger.Println("onSentenceBegin:", text)
}

func onSentenceEnd(text string, param interface{}) {
        logger, ok := param.(*nls.NlsLogger)
        if !ok {
                log.Default().Fatal("invalid logger")
                return
        }

        logger.Println("onSentenceEnd:", text)
}

func onResultChanged(text string, param interface{}) {
        logger, ok := param.(*nls.NlsLogger)
        if !ok {
                log.Default().Fatal("invalid logger")
                return
        }

        logger.Println("onResultChanged:", text)
}

func onCompleted(text string, param interface{}) {
        logger, ok := param.(*nls.NlsLogger)
        if !ok {
                log.Default().Fatal("invalid logger")
                return
        }

        logger.Println("onCompleted:", text)
}

func onClose(param interface{}) {
        logger, ok := param.(*nls.NlsLogger)
        if !ok {
                log.Default().Fatal("invalid logger")
                return
        }

        logger.Println("onClosed:")
}

func waitReady(ch chan bool, logger *nls.NlsLogger) error {
        select {
        case done := <-ch:
                {
                        if !done {
                                logger.Println("Wait failed")
                                return errors.New("wait failed")
                        }
                        logger.Println("Wait done")
                }
        case <-time.After(20 * time.Second):
                {
                        logger.Println("Wait timeout")
                        return errors.New("wait timeout")
                }
        }
        return nil
}

var lk sync.Mutex
var fail = 0
var reqNum = 0

func testMultiInstance(num int) {
        pcm, err := os.Open("tests/test1.pcm")
        if err != nil {
                log.Default().Fatalln(err)
        }

        buffers := nls.LoadPcmInChunk(pcm, 320)
        param := nls.DefaultSpeechTranscriptionParam()
        config, _ := nls.NewConnectionConfigWithAKInfoDefault(nls.DEFAULT_URL, APPKEY, AKID, AKKEY)
        var wg sync.WaitGroup
        for i := 0; i < num; i++ {
                wg.Add(1)
                go func(id int) {
                        defer wg.Done()
                        strId := fmt.Sprintf("ID%d   ", id)
                        logger := nls.NewNlsLogger(os.Stderr, strId, log.LstdFlags|log.Lmicroseconds)
                        logger.SetLogSil(false)
                        logger.SetDebug(true)
                        logger.Printf("Test Normal Case for SpeechRecognition:%s", strId)
                        st, err := nls.NewSpeechTranscription(config, logger,
                                onTaskFailed, onStarted,
                                onSentenceBegin, onSentenceEnd, onResultChanged,
                                onCompleted, onClose, logger)
                        if err != nil {
                                logger.Fatalln(err)
                                return
                        }

                        test_ex := make(map[string]interface{})
                        test_ex["test"] = "hello"

                        for {
                                lk.Lock()
                                reqNum++
                                lk.Unlock()
                                logger.Println("ST start")
                                ready, err := st.Start(param, test_ex)
                                if err != nil {
                                        lk.Lock()
                                        fail++
                                        lk.Unlock()
                                        st.Shutdown()
                                        continue
                                }

                                err = waitReady(ready, logger)
                                if err != nil {
                                        lk.Lock()
                                        fail++
                                        lk.Unlock()
                                        st.Shutdown()
                                        continue
                                }

                                for _, data := range buffers.Data {
                                        if data != nil {
                                                st.SendAudioData(data.Data)
                                                time.Sleep(10 * time.Millisecond)
                                        }
                                }

                                logger.Println("send audio done")
                                ready, err = st.Stop()
                                if err != nil {
                                        lk.Lock()
                                        fail++
                                        lk.Unlock()
                                        st.Shutdown()
                                        continue
                                }

                                err = waitReady(ready, logger)
                                if err != nil {
                                        lk.Lock()
                                        fail++
                                        lk.Unlock()
                                        st.Shutdown()
                                        continue
                                }

                                logger.Println("Sr done")
                                st.Shutdown()
                        }
                }(i)
        }

        wg.Wait()
}

func main() {
        coroutineId := flag.Int("num", 1, "coroutine number")
        flag.Parse()
        log.Default().Printf("start %d coroutines", *coroutineId)

        c := make(chan os.Signal, 1)
        signal.Notify(c, os.Interrupt)
        go func() {
                for range c {
                        lk.Lock()
                        log.Printf(">>>>>>>>REQ NUM: %d>>>>>>>>>FAIL: %d", reqNum, fail)
                        lk.Unlock()
                        os.Exit(0)
                }
        }()
        testMultiInstance(*coroutineId)
}