前提條件

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

下載安裝

1. 下載Python SDK。

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

2. 安裝SDK依賴。

   進入SDK根目錄使用如下命令安裝SDK依賴：

   python -m pip install -r requirements.txt

3. 安裝SDK。

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

   python -m pip install .

4. 安裝完成后通過以下代碼導入SDK。

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

多線程和多并發

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

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

關鍵接口

語音合成對應的類為NlsSpeechSynthesizer，其核心方法如下：

• 返回值：無

代碼示例

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



TEXT='大壯正想去摘取花瓣，誰知阿麗和阿強突然內訌，阿麗拿去手槍向樹干邊的阿強射擊，兩聲槍響，阿強直接倒入水中'

#以下代碼會根據上述TEXT文本反復進行語音合成
class TestTts:
    def __init__(self, tid, test_file):
        self.__th = threading.Thread(target=self.__test_run)
        self.__id = tid
        self.__test_file = test_file
   
    def start(self, text):
        self.__text = text
        self.__f = open(self.__test_file, "wb")
        self.__th.start()
    
    def test_on_metainfo(self, message, *args):
        print("on_metainfo message=>{}".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))
        try:
            self.__f.close()
        except Exception as e:
            print("close file failed since:", e)

    def test_on_data(self, data, *args):
        try:
            self.__f.write(data)
        except Exception as e:
            print("write data failed:", e)

    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))
      	tts = nls.NlsSpeechSynthesizer(url=URL,
      	      	      	      	       token=TOKEN,
      	      	      	      	       appkey=APPKEY,
      	      	      	      	       on_metainfo=self.test_on_metainfo,
      	      	      	      	       on_data=self.test_on_data,
      	      	      	      	       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 = tts.start(self.__text, voice="ailun")
      	print("{}: tts done with result:{}".format(self.__id, r))

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

nls.enableTrace(True)
multiruntest(1)