微软语音引擎小程序，基于跨浏览器的原生小程序系统-PluginOK(牛插)中间件(https://github.com/wangzuohuai/WebRunLocal)单机标准版开发，提供不限数量的文本朗读并可保存为语音文件等服务。最低可用在Chrome 41、Firefox 50、Edge 80(Chromium内核)、360极速/安全、IE 8、Opera、Electron、Vivaldi、Brave、QQ、搜狗等浏览器，也兼容运行于这些浏览器的最新版本。

1、PluginOK(牛插)中间件的安装：
1)、如果是exe的安装程序，请直接运行安装；
2)、如果是绿色版的程序包，请解压到磁盘某个目录后，双击“InstallWrl.bat”进行安装；
3)、安装完成时会启动PluginOK中间件服务，在安装目录下的Data子目录有WrlService.txt日志文件输出运行情况；
4)、此小程序不能运行在系统服务下，需要修改WrlConfig.json里的NoService为1后安装，如已生成data目录下的此配置文件，需要同步修改。

2、安装升级测试：
1、安装MSTTSApp小程序
请在测试网页输入框中，分别输入如下请求，然后点击发送，完成安装：

{"req":"Plugin_Install","rid":1,"para":{"Name":"MSTTSApp","PID":"MSTTSApp","Date":"2023-11-19","Desc":"MSTTS applet for PluginOK","DownAddr":"http://local.zorrosoft.com/Files/Plugin/MSTTSApp.pid","MD5":"F58737388593A3BBD4F311E447B248D6","Version":"1.5.12.1","Size":491520,"HideIns":0,"Type":2,"Cookie":"","Auth":"","TK":"A950DB7F228CCBD7406160BAE908D0503DE12B23EB1AA07B419463ED0472EC2ECF8AEC97325F2E0D2EB110E5EBEF41383FB6DF77CEAE848B3420F4E4CDE07B6A7BDDC2728E7F3B8A34965574C269F17DCD4BF625FC381F89484A65D4EF638E2332E56F1C5C271B46A60DD60ADD0238CF77A9A6C4BAEE034E61B0DFEC5B8237EF4A0FD43C9109BF56C49E0AB08CCF80A20F314A8911B8E995F7F983155C57D0903286F7E449EE86CF5ED6A9D07BB2B6D1D5EC1B7A4604BC56D87381891481D8FA3794D9AE9DFC5B7376C37438349B065E8BF8B01EEAEC14543021822EFDC333C08AFECEA56117DBA3D6B06A8E815CEB6BF3E6CD370B0EA78BD00F667A4B3474CB"}}

3、请求升级MSTTSApp小程序：

{"req":"Plugin_Update","rid":1,"para":{"Name":"MSTTSApp","PID":"MSTTSApp","Date":"2023-11-19","Desc":"MSTTS applet for PluginOK","DownAddr":"http://local.zorrosoft.com/Files/Plugin/MSTTSApp_Update.pid","MD5":"7E1D67DDEB02595FBE996A9C273B312A","Version":"1.5.12.1","Size":491520,"HideIns":0,"Type":2,"Cookie":"","Auth":"","TK":"89CFF9C031260020E2557CAC0DDBB903FBC166BFDC2431AB8CF7D9B9528D9DCA4C51A9CD9596EAEE6A3B436D0A0E34CE5325CD512AB7E2B9417BB5B8688B77BBCD255DA2FF6C512254E8FA348BB99F3DE0DAAAEACA27ADCBCF1C39E1F42AF8CDCD1121943523EECD28038C6D5BE624BF3CC7CC580C3D126AAC972CCEF1A38DFBA4D04A0CF21D40D03371708A39FD91D2D7487FB59622C7565984EE6C0665769FA270CE1E893D6EE2169E8B659D71383B8F0DBC25F30703685C78DC3BB43248D29FC422EE6D707E230FEF2E9DD7EF0CDDD49F0725023BDFDA4E6A096CE0F88EBA85854907491B379FA00920852C0DF132E560A9FFBF4D3379293E7F7728E2D5C5"}}

4、卸载小程序：
正式版需要添加TK校验，具体规则请参考SDK包中文档“中间件安全解决方案.pdf”，可在SDK包中的打包程序WrlPackage.exe的中间件维护生成带TK的请求。
举例：
{"req":"Plugin_Remove","rid":50,"para":{"PID":"MSTTSApp","Type":2}}

5、前端请求卸载中间件：
正式版需要添加TK校验，具体规则请参考SDK包中文档“中间件安全解决方案.pdf”，可在SDK包中的打包程序WrlPackage.exe的中间件维护生成带TK的请求。
举例：
{"req":"Wrl_Remove","rid":22,"para":{}}
说明：连接主服务后可执行；

6、PluginOK中间件升级：

{"req":"Wrl_Update","rid":1,"para":{"Name":"PluginOK中间件升级包","Date":"2023-04-11","Desc":" 1、改进中间件对高级版内嵌网页小程序全屏显示及恢复处理效果；2、中间件针对Office网页组件OLE嵌入提供代理进程支持，提升其运行性能及实现多文档操作；3、优化RTSP多引擎网页播放器对VLC4的兼容性；4、Office网页组件打开网络文档时增加下载进度显示，大幅增强OLE嵌入时文档的安全性及运行稳定性...","DownAddr":"http://local.zorrosoft.com/Files/Update/Wrl_Update.pid","MD5":"8FCB5745E1FF1D20B29610E336669F2E","Version":"1.5.10.1","Size":13205504,"HideIns":0,"Cookie":"","Auth":"","Open":"","TK":"95E3B7C6145EEBE3FD0F1C0A3E64FB6AA994AEF455F3E87AFD7D6D9D1F342355F2A0DB90CA43448E5EF995B090A64D25E439E8D0043CD6092CF2D8163903F653357BF1D85D72A53C1FFCB2C4E5CA370859EDE85C4206D444B1046D56F5624F6C2CFC90D5090B9AE65749A60634BC96D12CD0FF1BFA08255A1E7B37EAE2B2080724796A1C99DC2EA3563FD1FE8721F23C0B085CE1662B4ED652E56C91CB929D42D8AF264B51967F7886F3C68C5F37EA67C3BDFF486D72F6221A36E902A37DEE313E2A97BCEC47615D4E0CEDE83051A8B1F21FED78D1E2D415011A4EF37139234BB0DF30386795E3B215FEB5B176A1584FA60AF125B17648CC4040F0A1A483373C"}}

7、连接请求微软语音引擎小程序服务：
说明：以下功能请通过Web Socket连接后可执行，如默认侦听端口不是80(关于如何配置侦听端口，请参考SDK包中的文档“PluginOK开发者手册.pdf”)，请在连接地址中指定端口号进行连接。

HTTP网页在线测试：http://local.zorrosoft.com   HTTPS网页在线测试：https://local.zorrosoft.com
打开测试网页，输入地址：ws://localhost:83?sid=112&pid=MSTTSApp&flag=1 点击连接；

支持的协议功能如下：
A、朗读指定文本
Text为朗读内容，也可以是实际的WAV文件来播放 
Type为朗读类型(1异步，0同步)，仅对朗读文字有效，播放WAV是同步方式
指定OutFile参数时代表朗读文字时自动录音保存到wav文件中
Text及OutFile需要先做UrlEncode编码
{"req":"SAPI_Speak","rid":1,"para":{"Text":"Hello!","Type":1,"OutFile":"D:/Zorro/test.wav"}}

返回内容 {"ret":0,"rid":1,"data":{"Ret":0}} Ret代表是否成功

B、暂停朗读
{"req":"SAPI_Pause","rid":2,"para":{}}
返回内容 {"ret":0,"rid":2,"data":{"Ret":0}} Ret代表是否成功

C、恢复朗读
{"req":"SAPI_Resume","rid":3,"para":{}}
返回内容 {"ret":0,"rid":3,"data":{"Ret":0}} Ret代表是否成功

D、停止朗读
{"req":"SAPI_Stop","rid":4,"para":{}}
返回内容 {"ret":0,"rid":4,"data":{"Ret":0}} Ret代表是否成功

E、设置朗读音量 范围是 0 - 100 
{"req":"SAPI_SetVolume","rid":5,"para":{"Volume":50}}
返回内容 {"ret":0,"rid":5,"data":{"Ret":0}} Ret代表是否成功

F、获取朗读音量
{"req":"SAPI_GetVolume","rid":6,"para":{}}
返回内容 {"ret":0,"rid":6,"data":{"Volume":50}

G、设置朗读速率 范围是 -10 - 10
{"req":"SAPI_SetRate","rid":7,"para":{"Rate":1}}
返回内容 {"ret":0,"rid":7,"data":{"Ret":0}} Ret代表是否成功

H、获取朗读速率
{"req":"SAPI_GetRate","rid":8,"para":{}}
返回内容 {"ret":0,"rid":8,"data":{"Rate":0}}

I、获取当前语言引擎名称
{"req":"SAPI_GetCurToken","rid":9,"para":{}}
返回内容 {"ret":0,"rid":9,"data":{"TokenID":""}}

J、获取所有可用语言引擎名称
{"req":"SAPI_GetAllToken","rid":10,"para":{}}
返回内容 {"ret":0,"rid":10,"data":["TTS_MS_EN-US_ZIRA_11.0","TTS_MS_ZH-CN_HUIHUI_11.0"]}

K、设置当前语言引擎名称
{"req":"SAPI_SetCurToken","rid":11,"para":{"Token":"TTS_MS_EN-US_ZIRA_11.0"}}
返回内容 {"ret":0,"rid":7,"data":{"Ret":0}} Ret代表是否成功

L、指定WAV文件，转换为文字，可能多段文字，事件方式返回
{"req":"SAPI_GetWavText","rid":12,"para":{"File":"D:/Zorro/test.wav"}}

事件返回，可能多个：{"ret":0,"rid":12,"para":{"Text":"你好"}}支持的协议功能如下：
A、朗读指定文本
Text为朗读内容，也可以是实际的WAV声音文件来播放 Type为朗读类型(1异步，0同步)，仅对朗读文字有效，播放WAV是同步方式，指定OutFile参数时代表朗读文字时自动录音保存到wav文件中
{"req":"SAPI_Speak","rid":1,"para":{"Text":"你好","Type":1,"OutFile":"D:/Zorro/test.wav"}} 

返回内容 {"ret":0,"rid":1,"data":{"Ret":0}} Ret代表是否成功

B、暂停朗读
{"req":"SAPI_Pause","rid":2,"para":{}} 
返回内容 {"ret":0,"rid":2,"data":{"Ret":0}} Ret代表是否成功

C、恢复朗读
{"req":"SAPI_Resume","rid":3,"para":{}} 
返回内容 {"ret":0,"rid":3,"data":{"Ret":0}} Ret代表是否成功

D、停止朗读
{"req":"SAPI_Stop","rid":4,"para":{}} 
返回内容 {"ret":0,"rid":4,"data":{"Ret":0}} Ret代表是否成功

E、设置朗读音量 范围是 0 - 100 
{"req":"SAPI_SetVolume","rid":5,"para":{"Volume":50}} 
返回内容 {"ret":0,"rid":5,"data":{"Ret":0}} Ret代表是否成功

F、获取朗读音量
{"req":"SAPI_GetVolume","rid":6,"para":{}} 
返回内容 {"ret":0,"rid":6,"data":{"Volume":50}

G、设置朗读速率 范围是 -10 - 10
{"req":"SAPI_SetRate","rid":7,"para":{"Rate":1}} 
返回内容 {"ret":0,"rid":7,"data":{"Ret":0}} Ret代表是否成功

H、获取朗读速率
{"req":"SAPI_GetRate","rid":8,"para":{}} 
返回内容 {"ret":0,"rid":8,"data":{"Rate":0}}

I、获取当前语言引擎名称
{"req":"SAPI_GetCurToken","rid":9,"para":{}} 
返回内容 {"ret":0,"rid":9,"data":{"TokenID":""}}

J、获取所有可用语言引擎名称
{"req":"SAPI_GetAllToken","rid":10,"para":{}} 
返回内容 {"ret":0,"rid":10,"data":["TTS_MS_EN-US_ZIRA_11.0","TTS_MS_ZH-CN_HUIHUI_11.0"]} 

K、设置当前语言引擎名称
{"req":"SAPI_SetCurToken","rid":11,"para":{"Token":"TTS_MS_EN-US_ZIRA_11.0"}} 
返回内容 {"ret":0,"rid":7,"data":{"Ret":0}} Ret代表是否成功

L、指定WAV声音文件，识别为文字
{"req":"SAPI_GetWavText","rid":12,"para":{"File":"D:/Zorro/test.wav"}} 
事件返回，可能多个：{"ret":0,"rid":12,"para":{"Text":"你好"}} 

8、其它
请求参数的JSON数据包，请确保是UTF-8无签名的编码。
更多接口请求说明，请参考安装目录中的文档TestWrl.txt、SDK包中的“PluginOK开发者手册.pdf”及“PluginOK中间件安全解决方案.pdf”。
如还有疑问请直接联系客服 加微信：ZorroSoft，或加QQ群：23126938