provider.interface.ts.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292
  1. <!doctype html>
  2. <html lang="en">
  3. <head>
  4. <title>Code coverage report for modules/tts/provider.interface.ts</title>
  5. <meta charset="utf-8" />
  6. <link rel="stylesheet" href="../../prettify.css" />
  7. <link rel="stylesheet" href="../../base.css" />
  8. <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
  9. <meta name="viewport" content="width=device-width, initial-scale=1" />
  10. <style type='text/css'>
  11. .coverage-summary .sorter {
  12. background-image: url(../../sort-arrow-sprite.png);
  13. }
  14. </style>
  15. </head>
  16. <body>
  17. <div class='wrapper'>
  18. <div class='pad1'>
  19. <h1><a href="../../index.html">All files</a> / <a href="index.html">modules/tts</a> provider.interface.ts</h1>
  20. <div class='clearfix'>
  21. <div class='fl pad1y space-right2'>
  22. <span class="strong">0% </span>
  23. <span class="quiet">Statements</span>
  24. <span class='fraction'>0/0</span>
  25. </div>
  26. <div class='fl pad1y space-right2'>
  27. <span class="strong">0% </span>
  28. <span class="quiet">Branches</span>
  29. <span class='fraction'>1/1</span>
  30. </div>
  31. <div class='fl pad1y space-right2'>
  32. <span class="strong">0% </span>
  33. <span class="quiet">Functions</span>
  34. <span class='fraction'>1/1</span>
  35. </div>
  36. <div class='fl pad1y space-right2'>
  37. <span class="strong">0% </span>
  38. <span class="quiet">Lines</span>
  39. <span class='fraction'>0/0</span>
  40. </div>
  41. </div>
  42. <p class="quiet">
  43. Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
  44. </p>
  45. <template id="filterTemplate">
  46. <div class="quiet">
  47. Filter:
  48. <input type="search" id="fileSearch">
  49. </div>
  50. </template>
  51. </div>
  52. <div class='status-line low'></div>
  53. <pre><table class="coverage">
  54. <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
  55. <a name='L2'></a><a href='#L2'>2</a>
  56. <a name='L3'></a><a href='#L3'>3</a>
  57. <a name='L4'></a><a href='#L4'>4</a>
  58. <a name='L5'></a><a href='#L5'>5</a>
  59. <a name='L6'></a><a href='#L6'>6</a>
  60. <a name='L7'></a><a href='#L7'>7</a>
  61. <a name='L8'></a><a href='#L8'>8</a>
  62. <a name='L9'></a><a href='#L9'>9</a>
  63. <a name='L10'></a><a href='#L10'>10</a>
  64. <a name='L11'></a><a href='#L11'>11</a>
  65. <a name='L12'></a><a href='#L12'>12</a>
  66. <a name='L13'></a><a href='#L13'>13</a>
  67. <a name='L14'></a><a href='#L14'>14</a>
  68. <a name='L15'></a><a href='#L15'>15</a>
  69. <a name='L16'></a><a href='#L16'>16</a>
  70. <a name='L17'></a><a href='#L17'>17</a>
  71. <a name='L18'></a><a href='#L18'>18</a>
  72. <a name='L19'></a><a href='#L19'>19</a>
  73. <a name='L20'></a><a href='#L20'>20</a>
  74. <a name='L21'></a><a href='#L21'>21</a>
  75. <a name='L22'></a><a href='#L22'>22</a>
  76. <a name='L23'></a><a href='#L23'>23</a>
  77. <a name='L24'></a><a href='#L24'>24</a>
  78. <a name='L25'></a><a href='#L25'>25</a>
  79. <a name='L26'></a><a href='#L26'>26</a>
  80. <a name='L27'></a><a href='#L27'>27</a>
  81. <a name='L28'></a><a href='#L28'>28</a>
  82. <a name='L29'></a><a href='#L29'>29</a>
  83. <a name='L30'></a><a href='#L30'>30</a>
  84. <a name='L31'></a><a href='#L31'>31</a>
  85. <a name='L32'></a><a href='#L32'>32</a>
  86. <a name='L33'></a><a href='#L33'>33</a>
  87. <a name='L34'></a><a href='#L34'>34</a>
  88. <a name='L35'></a><a href='#L35'>35</a>
  89. <a name='L36'></a><a href='#L36'>36</a>
  90. <a name='L37'></a><a href='#L37'>37</a>
  91. <a name='L38'></a><a href='#L38'>38</a>
  92. <a name='L39'></a><a href='#L39'>39</a>
  93. <a name='L40'></a><a href='#L40'>40</a>
  94. <a name='L41'></a><a href='#L41'>41</a>
  95. <a name='L42'></a><a href='#L42'>42</a>
  96. <a name='L43'></a><a href='#L43'>43</a>
  97. <a name='L44'></a><a href='#L44'>44</a>
  98. <a name='L45'></a><a href='#L45'>45</a>
  99. <a name='L46'></a><a href='#L46'>46</a>
  100. <a name='L47'></a><a href='#L47'>47</a>
  101. <a name='L48'></a><a href='#L48'>48</a>
  102. <a name='L49'></a><a href='#L49'>49</a>
  103. <a name='L50'></a><a href='#L50'>50</a>
  104. <a name='L51'></a><a href='#L51'>51</a>
  105. <a name='L52'></a><a href='#L52'>52</a>
  106. <a name='L53'></a><a href='#L53'>53</a>
  107. <a name='L54'></a><a href='#L54'>54</a>
  108. <a name='L55'></a><a href='#L55'>55</a>
  109. <a name='L56'></a><a href='#L56'>56</a>
  110. <a name='L57'></a><a href='#L57'>57</a>
  111. <a name='L58'></a><a href='#L58'>58</a>
  112. <a name='L59'></a><a href='#L59'>59</a>
  113. <a name='L60'></a><a href='#L60'>60</a>
  114. <a name='L61'></a><a href='#L61'>61</a>
  115. <a name='L62'></a><a href='#L62'>62</a>
  116. <a name='L63'></a><a href='#L63'>63</a>
  117. <a name='L64'></a><a href='#L64'>64</a>
  118. <a name='L65'></a><a href='#L65'>65</a>
  119. <a name='L66'></a><a href='#L66'>66</a>
  120. <a name='L67'></a><a href='#L67'>67</a>
  121. <a name='L68'></a><a href='#L68'>68</a>
  122. <a name='L69'></a><a href='#L69'>69</a>
  123. <a name='L70'></a><a href='#L70'>70</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
  124. <span class="cline-any cline-neutral">&nbsp;</span>
  125. <span class="cline-any cline-neutral">&nbsp;</span>
  126. <span class="cline-any cline-neutral">&nbsp;</span>
  127. <span class="cline-any cline-neutral">&nbsp;</span>
  128. <span class="cline-any cline-neutral">&nbsp;</span>
  129. <span class="cline-any cline-neutral">&nbsp;</span>
  130. <span class="cline-any cline-neutral">&nbsp;</span>
  131. <span class="cline-any cline-neutral">&nbsp;</span>
  132. <span class="cline-any cline-neutral">&nbsp;</span>
  133. <span class="cline-any cline-neutral">&nbsp;</span>
  134. <span class="cline-any cline-neutral">&nbsp;</span>
  135. <span class="cline-any cline-neutral">&nbsp;</span>
  136. <span class="cline-any cline-neutral">&nbsp;</span>
  137. <span class="cline-any cline-neutral">&nbsp;</span>
  138. <span class="cline-any cline-neutral">&nbsp;</span>
  139. <span class="cline-any cline-neutral">&nbsp;</span>
  140. <span class="cline-any cline-neutral">&nbsp;</span>
  141. <span class="cline-any cline-neutral">&nbsp;</span>
  142. <span class="cline-any cline-neutral">&nbsp;</span>
  143. <span class="cline-any cline-neutral">&nbsp;</span>
  144. <span class="cline-any cline-neutral">&nbsp;</span>
  145. <span class="cline-any cline-neutral">&nbsp;</span>
  146. <span class="cline-any cline-neutral">&nbsp;</span>
  147. <span class="cline-any cline-neutral">&nbsp;</span>
  148. <span class="cline-any cline-neutral">&nbsp;</span>
  149. <span class="cline-any cline-neutral">&nbsp;</span>
  150. <span class="cline-any cline-neutral">&nbsp;</span>
  151. <span class="cline-any cline-neutral">&nbsp;</span>
  152. <span class="cline-any cline-neutral">&nbsp;</span>
  153. <span class="cline-any cline-neutral">&nbsp;</span>
  154. <span class="cline-any cline-neutral">&nbsp;</span>
  155. <span class="cline-any cline-neutral">&nbsp;</span>
  156. <span class="cline-any cline-neutral">&nbsp;</span>
  157. <span class="cline-any cline-neutral">&nbsp;</span>
  158. <span class="cline-any cline-neutral">&nbsp;</span>
  159. <span class="cline-any cline-neutral">&nbsp;</span>
  160. <span class="cline-any cline-neutral">&nbsp;</span>
  161. <span class="cline-any cline-neutral">&nbsp;</span>
  162. <span class="cline-any cline-neutral">&nbsp;</span>
  163. <span class="cline-any cline-neutral">&nbsp;</span>
  164. <span class="cline-any cline-neutral">&nbsp;</span>
  165. <span class="cline-any cline-neutral">&nbsp;</span>
  166. <span class="cline-any cline-neutral">&nbsp;</span>
  167. <span class="cline-any cline-neutral">&nbsp;</span>
  168. <span class="cline-any cline-neutral">&nbsp;</span>
  169. <span class="cline-any cline-neutral">&nbsp;</span>
  170. <span class="cline-any cline-neutral">&nbsp;</span>
  171. <span class="cline-any cline-neutral">&nbsp;</span>
  172. <span class="cline-any cline-neutral">&nbsp;</span>
  173. <span class="cline-any cline-neutral">&nbsp;</span>
  174. <span class="cline-any cline-neutral">&nbsp;</span>
  175. <span class="cline-any cline-neutral">&nbsp;</span>
  176. <span class="cline-any cline-neutral">&nbsp;</span>
  177. <span class="cline-any cline-neutral">&nbsp;</span>
  178. <span class="cline-any cline-neutral">&nbsp;</span>
  179. <span class="cline-any cline-neutral">&nbsp;</span>
  180. <span class="cline-any cline-neutral">&nbsp;</span>
  181. <span class="cline-any cline-neutral">&nbsp;</span>
  182. <span class="cline-any cline-neutral">&nbsp;</span>
  183. <span class="cline-any cline-neutral">&nbsp;</span>
  184. <span class="cline-any cline-neutral">&nbsp;</span>
  185. <span class="cline-any cline-neutral">&nbsp;</span>
  186. <span class="cline-any cline-neutral">&nbsp;</span>
  187. <span class="cline-any cline-neutral">&nbsp;</span>
  188. <span class="cline-any cline-neutral">&nbsp;</span>
  189. <span class="cline-any cline-neutral">&nbsp;</span>
  190. <span class="cline-any cline-neutral">&nbsp;</span>
  191. <span class="cline-any cline-neutral">&nbsp;</span>
  192. <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/**
  193. * TTS Provider 统一接口
  194. *
  195. * 所有语音合成供应商必须实现此接口。
  196. * synthesize 方法签名统一为 (text, voice, params, outputPath),返回本地文件路径或 cloud:URL。
  197. */
  198. &nbsp;
  199. import { VoiceParams } from '../../types';
  200. &nbsp;
  201. /** TTS 模型配置(来自 models.json 中 input 含 'tts' 的模型条目) */
  202. export interface TtsModelConfig {
  203. /** 模型 ID(如 'speech-2.8-hd', 'qwen3-tts-instruct-flash') */
  204. id: string;
  205. /** 模型显示名 */
  206. name: string;
  207. /** API 路径(如 '/t2a_async_v2'),可选 */
  208. apiPath?: string;
  209. /** 是否启用 */
  210. enabled: boolean;
  211. }
  212. &nbsp;
  213. export interface ITtsProvider {
  214. /** Provider 唯一标识(如 'minimax-tts', 'bailian-tts') */
  215. readonly name: string;
  216. /** 所属供应商 key(与 models.json 中 vendors 的 key 对应,如 'minimax', 'bailian') */
  217. readonly vendor: string;
  218. /** 合成模式:'async' 异步轮询 | 'sync' 同步返回 | 'stream' 流式 | 'mock' 模拟 */
  219. readonly mode: 'async' | 'sync' | 'stream' | 'mock';
  220. /** 单次调用最大文本长度(字符),超过会触发分段 */
  221. readonly maxTextLength: number;
  222. /** 并发上限(1 = 串行, 2+ = 并行) */
  223. readonly concurrency: number;
  224. /** 默认 TTS 模型 ID(从 models.json 读取) */
  225. readonly modelId: string;
  226. /** TTS API 基础路径(从 models.json vendor 的 ttsApiPath 读取) */
  227. readonly ttsApiPath: string;
  228. &nbsp;
  229. /**
  230. * 语音合成
  231. * @param text 要合成的文本
  232. * @param voice 音色标识(如 'Cherry', 'audiobook_male_1')
  233. * @param params 语音参数(语速、音调、音量)
  234. * @param outputPath 输出文件路径(.mp3)
  235. * @returns 返回本地文件路径(如 '/path/to/output.mp3')
  236. * 或云端 URL 标记(如 'cloud:https://...')
  237. */
  238. synthesize(
  239. text: string,
  240. voice: string,
  241. params: VoiceParams,
  242. outputPath: string,
  243. ): Promise&lt;string&gt;;
  244. &nbsp;
  245. /**
  246. * 健康检查(可选)
  247. * @returns true = Provider 可用,false = 不可用
  248. */
  249. healthCheck?(): Promise&lt;boolean&gt;;
  250. }
  251. &nbsp;
  252. /** TTS 合成结果 */
  253. export interface SynthesizeResult {
  254. /** 本地文件路径 或 云端URL */
  255. path: string;
  256. /** 是否来自云端(需下载) */
  257. isCloud: boolean;
  258. /** 所属 Provider */
  259. provider: string;
  260. }
  261. &nbsp;</pre></td></tr></table></pre>
  262. <div class='push'></div><!-- for sticky footer -->
  263. </div><!-- /wrapper -->
  264. <div class='footer quiet pad2 space-top1 center small'>
  265. Code coverage generated by
  266. <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
  267. at 2026-05-19T14:27:48.313Z
  268. </div>
  269. <script src="../../prettify.js"></script>
  270. <script>
  271. window.onload = function () {
  272. prettyPrint();
  273. };
  274. </script>
  275. <script src="../../sorter.js"></script>
  276. <script src="../../block-navigation.js"></script>
  277. </body>
  278. </html>