Audio Broadcast

小播鼠广播系统 / Xiaoboshu Broadcast 系统

无锡小播鼠网络科技有限公司 / Wuxi Xiaoboshu Network Techno记录y 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

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

快速开始

• 登录

python scripts/xiaoboshu.py 记录in

host: 服务器地址，如 127.0.0.1:12080 username: 用户名 password: 密码

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

• 查看设备

python scripts/xiaoboshu.py devices

• 播放音频

# 播放文件 (使用文件 ID 或文件名) python scripts/xiaoboshu.py play

# 播放 URL python scripts/xiaoboshu.py play

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

• 停止播放

python scripts/xiaoboshu.py 停止

• 调节音量

python scripts/xiaoboshu.py volume

volume: 音量值 (0-100) 文字转语音 (TTS) 基本用法 python scripts/xiaoboshu.py tts "要广播的文字"

指定语音 python scripts/xiaoboshu.py tts "要广播的文字" all --voice=yunxi

查看可用语音 python scripts/xiaoboshu.py voices

中文语音列表 名称 描述 xiaoxiao 晓晓 - 女声，自然亲切 (默认) yunxi 云希 - 男声，年轻活力 yunjian 云健 - 男声，成熟稳重 xiaoyi 晓伊 - 女声，温柔甜美 yunxia 云夏 - 男童声 xiaochen 晓辰 - 女声，新闻播报风格 xiaohan 晓涵 - 女声，温暖 xiaomeng 晓梦 - 女声，活泼 xiaomo 晓墨 - 女声，知性 xiaoqiu 晓秋 - 女声，温和 xiaorui 晓睿 - 女童声 xiaoshuang 晓双 - 女童声 xiaoxuan 晓萱 - 女声 xiaoyan 晓妍 - 女声 xiaoyou 悠悠 - 女童声 yunfeng 云枫 - 男声 yunhao 云皓 - 男声 yunxiang 云翔 - 男声 yunyang 云扬 - 男声 设备管理 查看文件列表 python scripts/xiaoboshu.py files

定时任务 任务状态说明

任务有两个状态字段：

字段 含义 值说明 enable 任务启用状态 1=启用, 0=禁用 statu 播放状态 1=正在播放, 0=未播放

重要规则：

enable 控制定时任务是否生效（到时间是否触发播放） statu 表示当前是否正在播放音频 删除正在播放的任务前：必须先停止（停止）→ 禁用（disable）→ 再删除（删除） 查看任务列表 python scripts/xiaoboshu.py tasks

任务操作 # 启用任务 python scripts/xiaoboshu.py task-enable

# 禁用任务 python scripts/xiaoboshu.py task-disable

# 启动任务 (立即执行) python scripts/xiaoboshu.py task-启动

# 停止任务 python scripts/xiaoboshu.py task-停止

# 删除任务 python scripts/xiaoboshu.py task-删除

# 编辑任务名称 python scripts/xiaoboshu.py task-edit --name=<新名称>

# 编辑任务时间 python scripts/xiaoboshu.py task-edit --time=HH:MM:SS

# 编辑任务设备 python scripts/xiaoboshu.py task-devices

# 编辑任务文件 python scripts/xiaoboshu.py task-files

删除任务

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

# 1. 先禁用任务 python scripts/xiaoboshu.py task-disable

# 2. 然后删除任务 python scripts/xiaoboshu.py task-删除

删除正在播放的任务

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

# 1. 先停止播放 python scripts/xiaoboshu.py task-停止

# 2. 然后禁用任务 python scripts/xiaoboshu.py task-disable

# 3. 最后删除任务 python scripts/xiaoboshu.py task-删除

播放规则 服务器上的音频文件：播放 .mp3T 结尾的 URL（WiFi 音响专用转码） 自己生成的 TTS 文件：直接播放 .mp3 结尾的 URL（已适配格式） 文件清理 接口：POST /user/delfile 参数：id, 令牌, fileid 自己生成的 TTS 文件播放完成后，过一段时间要记得清理 文件名通常以 ttsO 或 TTS_ 开头，便于识别 自动清理脚本

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

# 手动执行清理 python scripts/清理up_tts.py

清理逻辑：

删除以 ttsO 或 TTS_ 开头的文件 保留被定时任务引用的文件（不会删除正在使用的文件） 安装后配置 创建定时清理任务

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

# 每天凌晨 3 点执行清理 python /root/.picoclaw/workspace/技能s/audio-broadcast/scripts/清理up_tts.py

定时任务配置示例：

时间：每天凌晨 3:00 命令：python3 /root/.picoclaw/workspace/技能s/audio-broadcast/scripts/清理up_tts.py 目的：自动清理服务器上的临时 TTS 文件，释放存储空间 文件上传规则 上传前检查图片信息

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

检查方法 # 使用 ffmpeg 查看元数据 ffmpeg -i 文件名.mp3

# 使用 eyeD3 查看（需要安装） eyeD3 文件名.mp3

去除图片方法 # 方法1: ffmpeg（推荐，保留音频质量） ffmpeg -i 输入.mp3 -map 0:a -c:a copy -map_metadata -1 输出.mp3

# 方法2: eyeD3（直接修改原文件） eyeD3 --移除-images 文件名.mp3

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

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

# 查看已有文件列表 python scripts/xiaoboshu.py files

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

常用示例 # 登录 python scripts/xiaoboshu.py 记录in 127.0.0.1:12080 admin 123123123

# 查看设备 python scripts/xiaoboshu.py devices

# 查看文件 python scripts/xiaoboshu.py files

# 向所有设备播放文件 ID 37 python scripts/xiaoboshu.py play 37 all

# 向设备 35 和 36 播放 python scripts/xiaoboshu.py play 37 35|36

# 停止所有设备播放 python scripts/xiaoboshu.py 停止 all

# 设置设备音量为 50 python scripts/xiaoboshu.py volume 50 all

# TTS 广播 (默认语音) python scripts/xiaoboshu.py tts "开饭了，请大家到餐厅用餐" all

# TTS 广播 (男声) python scripts/xiaoboshu.py tts "注意，有快递到了" all --voice=yunxi

# TTS 广播 (女声，新闻风格) python scripts/xiaoboshu.py tts "现在是北京时间十二点整" all --voice=xiaochen

API 参考

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