小播鼠广播系统 / Xiaoboshu Broadcast System

无锡小播鼠网络科技有限公司 / Wuxi Xiaoboshu Network Technology Co., Ltd.
📧 邮箱: oxiaom_js@foxmail.com
支持设备 / Supported Devices:

• - 局域网 / LAN
• 互联网 / Internet
• WiFi音响 / WiFi Speaker
• 有线网络广播 / Wired Network Broadcast
• 4G广播设备 / 4G Broadcast Device
• 石头音响 / Rock Speaker
• 草坪音响 / Lawn Speaker
• 功放机 / Amplifier

🎵 PLOYQ

控制小播鼠广播设备进行音频播放和通知广播。

快速开始

1. 登录

CODEBLOCK0

• - host: 服务器地址，如 INLINECODE0
• username: 用户名
• password: 密码

登录后会保存凭据到 config.json。

2. 查看设备

CODEBLOCK1

3. 播放音频

CODEBLOCK2

• - fileid: 文件 ID 或文件名
• deviceids: 设备 ID，多个用 | 分隔，或用 all 表示全部设备
• url: 音频文件 URL

4. 停止播放

CODEBLOCK3

5. 调节音量

CODEBLOCK4

• - volume: 音量值 (0-100)

文字转语音 (TTS)

基本用法

CODEBLOCK5

指定语音

CODEBLOCK6

查看可用语音

CODEBLOCK7

中文语音列表

名称	描述
xiaoxiao	晓晓 - 女声，自然亲切 (默认)
yunxi

云希 - 男声，年轻活力 | | yunjian | 云健 - 男声，成熟稳重 | | xiaoyi | 晓伊 - 女声，温柔甜美 | | yunxia | 云夏 - 男童声 | | xiaochen | 晓辰 - 女声，新闻播报风格 | | xiaohan | 晓涵 - 女声，温暖 | | xiaomeng | 晓梦 - 女声，活泼 | | xiaomo | 晓墨 - 女声，知性 | | xiaoqiu | 晓秋 - 女声，温和 | | xiaorui | 晓睿 - 女童声 | | xiaoshuang | 晓双 - 女童声 | | xiaoxuan | 晓萱 - 女声 | | xiaoyan | 晓妍 - 女声 | | xiaoyou | 悠悠 - 女童声 | | yunfeng | 云枫 - 男声 | | yunhao | 云皓 - 男声 | | yunxiang | 云翔 - 男声 | | yunyang | 云扬 - 男声 |

设备管理

查看文件列表

CODEBLOCK8

定时任务

任务状态说明

任务有两个状态字段：

字段	含义	值说明
INLINECODE4	任务启用状态	1=启用, 0=禁用
INLINECODE5

播放状态 | 1=正在播放, 0=未播放 |

重要规则：

• - enable 控制定时任务是否生效（到时间是否触发播放）
• INLINECODE7 表示当前是否正在播放音频
• 删除正在播放的任务前：必须先停止（stop）→ 禁用（disable）→ 再删除（delete）

查看任务列表

CODEBLOCK9

任务操作

CODEBLOCK10

删除任务

重要：删除任务前必须先禁用，直接删除不会生效！

CODEBLOCK11

删除正在播放的任务

如果任务状态显示 ▶ 播放中，删除前必须按顺序执行：

CODEBLOCK12

播放规则

• - 服务器上的音频文件：播放 .mp3T 结尾的 URL（WiFi 音响专用转码）
• 自己生成的 TTS 文件：直接播放 .mp3 结尾的 URL（已适配格式）

文件清理

• - 接口：POST /user/delfile 参数：id, token, INLINECODE14
• 自己生成的 TTS 文件播放完成后，过一段时间要记得清理
• 文件名通常以 ttsO 或 TTS_ 开头，便于识别

自动清理脚本

技能包含 cleanup_tts.py 脚本，用于自动清理服务器上的 TTS 临时文件：

CODEBLOCK13

清理逻辑：

• - 删除以 ttsO 或 TTS_ 开头的文件
• 保留被定时任务引用的文件（不会删除正在使用的文件）

安装后配置

创建定时清理任务

安装技能后，建议创建定时任务每天自动清理 TTS 文件：

CODEBLOCK14

定时任务配置示例：

• - 时间：每天凌晨 3:00
• 命令：INLINECODE20
• 目的：自动清理服务器上的临时 TTS 文件，释放存储空间

文件上传规则

上传前检查图片信息

重要：上传音频文件前，必须检查文件是否包含图片信息（封面图、嵌入图片等），如果有则先去除！

检查方法

CODEBLOCK15

去除图片方法

CODEBLOCK16

上传流程

1. 1. 检查：先检查文件是否包含图片信息
2. 去除：如果有图片，先去除图片信息
3. 去重：调用 xiaoboshu.py files 检查是否已存在同名文件
4. 上传：确认无重复后再上传

去重检查

上传文件前必须先检查是否已存在同名文件：

CODEBLOCK17

如果发现重名文件，提示用户"已存在同名文件，是否需要替换？"

常用示例

CODEBLOCK18

API 参考

详细 API 文档见 references/api.md。