Files
PA_horn_speaker/README.md
T

155 lines
5.4 KiB
Markdown
Raw Normal View History

2026-05-27 11:08:14 +00:00
# PA_horn_speaker
2026-05-28 18:09:36 +08:00
Web广播系统 - 吆喝用的喇叭(i人专用)
通过Web界面输入文字,利用 edge-tts 将文本转化为语音并播放,支持循环播放和语音文件管理。
## 功能特点
- **文本转语音**:输入文字即可生成语音
- **多种声音选择**:支持多种音色,包括普通话、方言、香港、台湾口音
- **循环播放**:支持设置间隔时间的循环播放模式
- **语音文件管理**:播放历史、收藏、重命名、删除
- **主题切换**:支持深色/浅色主题
- **状态条与日志**:一条状态随时说明喇叭在做什么(待机 / 正在合成 / 正在播报 / 上次没成功),需要时展开看完整日志
2026-05-28 18:09:36 +08:00
## 支持的声音
| 声音名称 | 类型 |
|---------|------|
| 晓晓(温暖女声) | 普通话 |
| 晓伊(活泼女声) | 普通话 |
| 云健(激情男声) | 普通话 |
| 云希(阳光男声) | 普通话 |
| 云夏(可爱男声) | 普通话 |
| 云扬(新闻男声) | 普通话 |
| 辽宁-小贝 | 方言 |
| 陕西-小妮 | 方言 |
| 香港-晓佳 | 粤语 |
| 香港-晓曼 | 粤语 |
| 香港-云龙 | 粤语 |
| 台湾-晓陈 | 台语 |
| 台湾-晓雨 | 台语 |
| 台湾-云哲 | 台语 |
## 安装依赖
```bash
# 安装 Python 依赖
pip install flask edge-tts
# 安装音频播放工具
sudo apt-get install mpg123
# 修复 edge-tts 的 403(微软 2026-10 更换了端点,不修则合成不出语音)
python3 patch_edge_tts_403.py
2026-05-28 18:09:36 +08:00
```
## 界面
控制界面按「极简一页」来组织:一屏只做一件事——写内容、点广播,音频文件与日志收在下方可展开的行里;
宽屏(≥1000px)时这两块自动变成右侧常显的一栏。
配色遵循一条规则:**颜色只表示喇叭是否在响**。待机时整个界面是无彩的(只有灰绿中性色),
只有正在播报时才会出现唯一的朱红——页面顶端一条横线、状态点、以及变成「停止广播」的主按钮。
深浅两套主题,右上角切换,首次打开跟随系统。
2026-05-28 18:09:36 +08:00
## 使用方法
### 启动服务
```bash
python app.py
```
服务将在 `http://localhost:5000` 启动。
### 访问方式
打开浏览器访问 `http://你的IP:5000`
### 使用步骤
1. 在文本框中输入广播内容(最多500字)
2. 选择喜欢的声音
3. 可选:勾选"循环播放"并设置间隔时间
4. 点击"开始广播"按钮
5. 播放完成的语音会自动保存到历史列表
## 技术栈
- **后端**:Flask
- **语音合成**:edge-tts
- **音频播放**:mpg123
- **前端**:HTML + CSS + JavaScript
## 项目结构
```
PA_horn_speaker/
├── app.py # Flask 应用主文件
├── player.sh # 循环播放脚本
├── patch_edge_tts_403.py # 修复 edge-tts 合成 403 的补丁脚本
2026-05-28 18:09:36 +08:00
├── templates/
│ └── index.html # 前端页面模板
├── static/
│ └── style.css # 样式文件
├── cache/ # 语音文件缓存目录
│ └── metadata.json # 文件元数据
├── LICENSE # 许可证
└── README.md # 项目说明
```
## API 接口
| 接口 | 方法 | 说明 |
|-----|------|------|
| `/` | GET | 首页 |
| `/speak` | POST | 生成并播放语音 |
| `/stop` | GET | 停止播放 |
| `/files` | GET | 获取语音文件列表 |
| `/play-file` | POST | 播放已保存的语音文件 |
| `/rename-file` | POST | 重命名文件 |
| `/toggle-favorite` | POST | 收藏/取消收藏 |
| `/delete-file` | POST | 删除文件 |
| `/status` | GET | 查询喇叭是否正在播报、播的哪一条、循环间隔 |
## 已知问题:合成语音报 403(2026-10)
**现象**:输入文字后点「开始广播」没有声音,日志中 `edge_tts` 报
`WSServerHandshakeError: 403, message='Invalid response status'`。
**原因**:微软在 2026 年 10 月把 Edge Read Aloud 的合成端点从
`speech.platform.bing.com` 迁到了 `api.msedgeservices.com`。旧端点在
2026-10-10 起于多数地区开始返回 403,2026-10-12 起全球(含美国)全线 403。
edge-tts 7.2.8 尚未跟进,因此这不是本机、网络或时钟的问题——可以这样确认:
`--list-voices` 仍然正常返回、系统时钟已 NTP 同步、换一台机器同样 403。
**修复**:
```bash
python3 patch_edge_tts_403.py # 打补丁
python3 patch_edge_tts_403.py --verify # 实际合成一段音频确认
```
补丁会把 `edge_tts/constants.py` 里的 `WSS_URL` 指向新端点,运行前会自动备份原文件。
注意:**重新安装或升级 edge-tts 会覆盖 `constants.py`,补丁随之丢失,重跑一次脚本即可。**
其它参数:`--check` 只看当前状态,`--revert` 还原成官方原始端点。
上游进展见 [rany2/edge-tts#490](https://github.com/rany2/edge-tts/issues/490),
对应修复 PR 为 [#491](https://github.com/rany2/edge-tts/pull/491)。
2026-05-28 18:09:36 +08:00
## 注意事项
1. 需要联网使用(edge-tts 需要访问 Microsoft 服务)
2. 音频输出使用 ALSA 设备 `plughw:audiocodec,0`,可根据实际设备调整
3. 缓存目录最多保存10个文件,收藏的文件不会被自动清理
4. 合成失败会自动重试 3 次(新端点对同一 IP 有限流),仍失败则返回错误提示,不会再把空音频文件当成正常广播;缓存里已损坏(0 字节)的文件也不会被播放
2026-05-28 18:09:36 +08:00
## APK 文件
项目包含 Android 端 APK 文件:`小喇叭_1.0.0.apk`
---
Made with ❤️ for 社恐人士