前提條件

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

• SDK僅支持Python3，暫不支持Python2。

• 已安裝Python包管理工具setuptools。如果未安裝，請?jiān)诮K端執(zhí)行以下命令安裝。

  pip install setuptools

下載安裝

1. 下載Python SDK。

   從Github獲取Python SDK，或直接下載streamInputTts-github-python。

2. 安裝SDK依賴。

   進(jìn)入SDK根目錄使用如下命令安裝SDK依賴：

   python -m pip install -r requirements.txt

3. 安裝SDK。

   依賴安裝完成后使用如下命令安裝SDK：

   python -m pip install .

4. 安裝完成后通過以下代碼導(dǎo)入SDK。

   # -*- coding: utf-8 -*-
   import nls

多線程和多并發(fā)

在CPython中，由于存在全局解釋器鎖，同一時刻只有一個線程可以執(zhí)行Python代碼（雖然某些性能導(dǎo)向的庫可能會去除此限制）。如果您想更好地利用多核心計(jì)算機(jī)的計(jì)算資源，推薦您使用multiprocessing或concurrent.futures.ProcessPoolExecutor。 如果您想要同時運(yùn)行多個I/O密集型任務(wù)，則多線程仍然是一個合適的模型。

如果單解釋器有太多線程，將會在線程間切換造成更多消耗，有可能會導(dǎo)致SDK出現(xiàn)錯誤。不建議使用超過200線程，推薦使用multiprocessing技術(shù)或者手動使用腳本創(chuàng)建多個解釋器。

關(guān)鍵接口

一句話識別對應(yīng)的類為nls.NlsSpeechRecognizer，其核心方法如下：

• 返回值：Boolean類型，F(xiàn)alse為失敗，True為成功。

代碼示例

import time
import threading
import sys

import nls


URL="wss://nls-gateway-cn-shanghai.aliyuncs.com/ws/v1"
TOKEN="yourToken"   #參考http://bestwisewords.com/document_detail/450255.html獲取token
APPKEY="yourAppkey"      #獲取Appkey請前往控制臺：https://nls-portal.console.aliyun.com/applist

#以下代碼會根據(jù)音頻文件內(nèi)容反復(fù)進(jìn)行一句話識別
class TestSr:
    def __init__(self, tid, test_file):
        self.__th = threading.Thread(target=self.__test_run)
        self.__id = tid
        self.__test_file = test_file
   
    def loadfile(self, filename):
        with open(filename, "rb") as f:
            self.__data = f.read()
    
    def start(self):
        self.loadfile(self.__test_file)
        self.__th.start()

    def test_on_start(self, message, *args):
        print("test_on_start:{}".format(message))

    def test_on_error(self, message, *args):
        print("on_error args=>{}".format(args))

    def test_on_close(self, *args):
        print("on_close: args=>{}".format(args))

    def test_on_result_chg(self, message, *args):
        print("test_on_chg:{}".format(message))

    def test_on_completed(self, message, *args):
        print("on_completed:args=>{} message=>{}".format(args, message))


    def __test_run(self):
        print("thread:{} start..".format(self.__id))
        
        sr = nls.NlsSpeechRecognizer(
                    url=URL,
                    token=TOKEN,
                    appkey=APPKEY,
                    on_start=self.test_on_start,
                    on_result_changed=self.test_on_result_chg,
                    on_completed=self.test_on_completed,
                    on_error=self.test_on_error,
                    on_close=self.test_on_close,
                    callback_args=[self.__id]
                )

		print("{}: session start".format(self.__id))
		r = sr.start(aformat="pcm", ex={"hello":123})
           
		self.__slices = zip(*(iter(self.__data),) * 640)
		for i in self.__slices:
			sr.send_audio(bytes(i))
			time.sleep(0.01)

		r = sr.stop()
		print("{}: sr stopped:{}".format(self.__id, r))
		time.sleep(1)

def multiruntest(num=500):
    for i in range(0, num):
        name = "thread" + str(i)
        t = TestSr(name, "tests/test1.pcm")
        t.start()

# 設(shè)置打開日志輸出
nls.enableTrace(False)
multiruntest(1)