diff --git a/docs/Advanced_development/zh/QuecPythonSub/TTS.md b/docs/Advanced_development/zh/QuecPythonSub/TTS.md index 230177f9a874651857da3fef5e53c9b01518226c..17d2d71fea4144b03ed0b94f6ad5416cd97c99a0 100644 --- a/docs/Advanced_development/zh/QuecPythonSub/TTS.md +++ b/docs/Advanced_development/zh/QuecPythonSub/TTS.md @@ -1,40 +1,44 @@ -# QuecPython TTS模块开发使用说明 +# QuecPython TTS模块开发 本文主要介绍QuecPython Audio模块中TTS模块的使用。 TTS是语音合成应用的一种,它将储存于电脑中的文件,如帮助文件或者[网页](https://baike.baidu.com/item/网页/99347)转换成自然语音输出。TTS不仅能帮助有[视觉障碍](https://baike.baidu.com/item/视觉障碍/5582072)的人阅读计算机上的信息,更能增加[文本文档](https://baike.baidu.com/item/文本文档/557654)的可读性。TTS应用包括语音驱动的邮件以及声音敏感系统,并常与声音识别程序一起使用。 + ## api介绍 -移远通信为您提供的TTS API 支持音量设置、播放语速设置等,包含的API有: +移远通信为您提供的TTS API 支持音量设置、播放语速设置等。 +具体的API 详解请参考[QuecPython-audio - 音频播放-TTS](https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonClasslib?id=tts) -- **tts = audio.TTS(device)** +本文档适用于移远通信如下模块: -- **tts.close()** +- EC100Y-CN +- EC600S-CN -- **tts.play(priority, breakin, mode, str)** -- **tts.setCallback(usrFun)** +## 使用TTS播放声音 -- **tts.getVolume()** +本文所示代码使用的硬件版本为 EC600S-CN V1.1。 开发板播放声音需要外接喇叭。 -- **tts.setVolume(vol)** -- **tts.getSpeed()** -- **tts.setSpeed(speed)** -- **tts.getState()** -- **tts.stop()** +淘宝链接: + -具体的API 详解请参考[QuecPython-audio - 音频播放-TTS](https://python.quectel.com/wiki/api/#tts) +![QuecPython_Sub_TTS02](media\QuecPython_Sub_TTS02.png) -本文档适用于移远通信如下模块: -- EC100Y-CN -- EC600S-CN +## 硬件连接 +参考 [EC600S V1.1开发板原理图.pdf](https://python.quectel.com/download) +![QuecPython_Sub_TTS01](media\QuecPython_Sub_TTS01.png) -## 使用TTS播放声音 +VOP : Positive Amplifier Output 正 + +VON : Negative Amplifier Output 负 -本文所示代码使用的硬件版本为 EC600S-CN V1.1。 开发板播放声音需要外接喇叭, 具体的喇叭参数以及连接方法请参考《音频播放实验》。 +将J7的1号引脚连接功放正极。 +2号引脚连接负极。由于本次使用的外接喇叭。 在EC600S V1.1 版本上面需要使能GPIO11引脚。 + +Pin(Pin.GPIO11, Pin.OUT, Pin.PULL_PD, 1) 。 才可以播放音频。 ## 交互小实验 @@ -44,49 +48,46 @@ ```python import audio from machine import Pin +# 创建TTS对象 tts = audio.TTS(0) +# 使能GPIO引脚 Pin(Pin.GPIO11, Pin.OUT, Pin.PULL_PD, 1) +# TTS语音播放 tts.play(1, 1, 2, '1111111111111111') ``` - ### 设置音量 ```python import audio from machine import Pin tts=audio.TTS(0) +# 设置TTS音量大小 tts.setVolume(5) Pin(Pin.GPIO11, Pin.OUT, Pin.PULL_PD, 1) tts.play(1, 1, 2, '12345') ``` - ### 设置播放语速 ```python import audio from machine import Pin tts=audio.TTS(0) +# 设置TTS播放速度 tts.setSpeed(9) Pin(Pin.GPIO11, Pin.OUT, Pin.PULL_PD, 1) tts.play(1, 1, 2, '12345') ``` - ## 实验代码 分别尝试使用不同的声音和语速播放。 ```python -''' -Author: chengzhu.zhou -LastEditTime: 2021-01-16 12:23:44 -Description: Copyright 2020 - 2020 quectel -''' import audio import utime as time @@ -100,8 +101,6 @@ def play(tts, strList): tts.play(1, 1, 2, Str) pass -# https://python.quectel.com/wiki/#/zh-cn/api/?id=audio-%e9%9f%b3%e9%a2%91%e6%92%ad%e6%94%be - def test_tts_base(): ''' @@ -129,7 +128,8 @@ if __name__ == "__main__": ``` + ## 配套代码 - - 下载代码 \ No newline at end of file + * [下载代码](code/example_tts_base.py) + \ No newline at end of file diff --git a/docs/Advanced_development/zh/QuecPythonSub/code/example_tts_base.py b/docs/Advanced_development/zh/QuecPythonSub/code/example_tts_base.py index 6cbe2c37c9065346d7abc371193d9ce6790d5f9f..88221d0459990db113a61716523dec7797c787ff 100644 --- a/docs/Advanced_development/zh/QuecPythonSub/code/example_tts_base.py +++ b/docs/Advanced_development/zh/QuecPythonSub/code/example_tts_base.py @@ -1,5 +1,3 @@ - - import audio import utime as time from machine import Pin @@ -12,8 +10,6 @@ def play(tts, strList): tts.play(1, 1, 2, Str) pass -# https://python.quectel.com/wiki/#/zh-cn/api/?id=audio-%e9%9f%b3%e9%a2%91%e6%92%ad%e6%94%be - def test_tts_base(): ''' @@ -37,4 +33,4 @@ def test_tts_base(): if __name__ == "__main__": - test_tts_base() + test_tts_base() \ No newline at end of file diff --git a/docs/Advanced_development/zh/QuecPythonSub/media/QuecPython_Sub_TTS01.png b/docs/Advanced_development/zh/QuecPythonSub/media/QuecPython_Sub_TTS01.png new file mode 100644 index 0000000000000000000000000000000000000000..b08531abf55836a85715f71d178f810645513917 Binary files /dev/null and b/docs/Advanced_development/zh/QuecPythonSub/media/QuecPython_Sub_TTS01.png differ diff --git a/docs/Advanced_development/zh/QuecPythonSub/media/QuecPython_Sub_TTS02.png b/docs/Advanced_development/zh/QuecPythonSub/media/QuecPython_Sub_TTS02.png new file mode 100644 index 0000000000000000000000000000000000000000..b7dce5eec226770e64a143c76a69e8a503cb7980 Binary files /dev/null and b/docs/Advanced_development/zh/QuecPythonSub/media/QuecPython_Sub_TTS02.png differ