1# * coding: UTF8 *
2"""
3Tts模块具体接口和参数如下所示。
4
5========================================================================================================
6
7"""
8
9def create():
10   """
11   创建TTS引擎。
12
13   :param 空:
14   :returns: 0: 成功，其他: 失败
15   :raises OSError: 空
16   """
17   pass
18
19def release():
20   """
21   释放TTS引擎。
22
23   :param 空:
24   :returns: 0: 成功，其他: 失败
25   :raises OSError: EINVAL
26   """
27   pass
28
29def callback(type, cbfun):
30   """
31   设置TTS的回调类型及回调函数。示例::
32
33      def cb_url(test):
34         print("receive info with url %s" %(test))
35
36      t0.callback(t0.CB_ENUM_URL, cb_url)
37
38   :param type(int): 回调类型，通过设置回调类型接收关心的TTS引擎信息，取值为CB_ENUM_URL, CB_ENUM_DATA或者CB_ENUM_EVENT
39   :param cbfun(function): 回调函数
40   :returns: 0: 成功，其他: 失败
41   :raises OSError: EINVAL
42   """
43   pass
44
45def init(aicloud_type, config):
46   """
47   初始化Tts引擎配置，详细信息参考 `语音合成接口说明 <https://help.aliyun.com/document_detail/84435.html?spm=a2c4g.11186623.6.581.16a75275MJHPrH>`_ 。示例::
48
49      t0.init(0, {'app_key': 'xxxxx',
50                  'token': 'xxxxxxxx',
51                  'format': 3,
52                  'sample_rate': 16000,
53                  'voice': 'siqi',
54                  'volume': 80,
55                  'speech_rate': 0,
56                  'pitch_rate':0,
57                  'text_encode_type': 1})
58
59   :param aicloud_type(int): 目前可选值仅为0;
60   :param config(dictionary): Tts引擎的配置信息;
61   :returns: 0: 成功，其他: 失败
62   :raises OSError: EINVAL
63   """
64   pass
65
66def request(text, recv_type):
67   """
68   发起Tts语音合成请求。
69
70   :param text(str): 需要语音合成的文本信息
71   :param recv_type(int): 语音合成后返回到端上的格式类型： 0表示返回URL，1表示返回数据
72   :returns: 0: 成功，其他: 失败
73   :raises OSError: ENXIO
74   """
75   pass
76
77def stop():
78   """
79   停止Tts语音合成请求。
80
81   :param 空:
82   :returns: 0: 成功，其他: 失败
83   :raises OSError: EINVAL
84   """
85   pass
86
87