| | |
|---|
| | | | SET_VOLUME | `{"level": 50}` | 设置音量 0–100 | |
|---|
| | | | SET_POWER | `{"state": "wake"}` | 唤醒 / `sleep` 休眠 | |
|---|
| | | | SET_CLOCK | `{"ts": 1718365200}` | 同步 Unix 时间戳 | |
|---|
| | | | PLAY_MEDIA | `{"items":[{"path":"courses/course01/chapter01/resources/001.mp3","volume":50,"speed":1.25,"loop":false}]}` | 保存并播放本地 MP3 清单；只保留一份清单，后续覆盖；speed 可选，仅支持 0.5/0.75/1.0/1.25/1.5/2.0，非 1.0 会变调；ttl 和 loop 忽略 | |
|---|
| | | | PLAY_MEDIA | `{"items":[{"path":"courses/course01/chapter01/resources/001.mp3","volume":50,"speed":1.05,"loop":false}]}` | 保存并播放本地 MP3 清单；只保留一份清单，后续覆盖；speed 可选，范围 0.5～2.0 任意浮点（默认 1.0，超出夹紧），非 1.0 会变调；ttl 和 loop 忽略 | |
|---|
| | | | STOP_MEDIA | `{}` | 停止播放 | |
|---|
| | | | SET_ALARM | `{"id": "alarm_01", "time": "07:00", "repeat": [1,2,3,4,5], "action": "add"}` | 设置闹钟 | |
|---|
| | | | UNSET_ALARM | `{"id": "alarm_01"}` | 删除闹钟 | |
|---|
| | |
|---|
| | | |
|---|
| | | **PLAY_MEDIA 清单行为：** |
|---|
| | | |
|---|
| | | - `payload.items` 为播放清单数组，每项 `path` 必填，`volume` 和 `speed` 可选。 |
|---|
| | | - `payload.items` 为播放清单数组，每项 `path` 必填，`volume` 和 `speed` 可选。`speed` 范围 0.5～2.0（默认 1.0，超出夹紧），不是离散档。 |
|---|
| | | - 收到清单后终端保存到 SD 卡本地，仅保留一份；后续新清单会覆盖旧清单。 |
|---|
| | | - 每播放完一首，终端会在本地清单中标记该项完成，并通过 `rpt/progress` 上报进度。 |
|---|
| | | - `ttl` 和每项 `loop` 当前忽略。 |
|---|
