# 定时任务配置格式 | XiaoMusic
XiaoMusic doc

Skip to content

# 定时任务配置格式 ​

支持采用 crontab 的格式配置定时任务，已经支持下面的任务类型:

- stop 关机
- play 播放歌曲
- play_music_list 播放列表
- tts 文字转语音
- refresh_music_list 刷新播放列表
- set_volume 设置音量
- set_play_type 设置播放类型，单曲循环 0 , 全部循环 1 , 随机播放 2 , 单曲播放 3 , 顺序播放 4

### 示例 ​

json

    [
        {
            "expression": "0 8 * * 0-4",
            "name": "play",
            "did": "123456789",
            "arg1": "周杰伦晴天"
        },
        {
            "expression": "10 8 * * 0-4",
            "name": "stop",
            "did": "123456789"
        },
        {
            "expression": "0 9 * * *",
            "name": "play",
            "did": "123456789",
            "arg1": "周杰伦晴天"
        },
        {
            "expression": "0 10 * * *",
            "name": "play_music_list",
            "did": "123456789",
            "arg1": "周杰伦"
        },
        {
            "expression": "30 10 * * *",
            "name": "play_music_list",
            "did": "123456789",
            "arg1": "周杰伦|晴天"
        },
        {
            "expression": "0 7 * * *",
            "name": "tts",
            "did": "123456789",
            "arg1": "早上好！该起床了！"
        },
        {
            "expression": "0 3 * * *",
            "name": "refresh_music_list"
        },
        {
            "expression": "* * * * *",
            "name": "set_volume",
            "did": "123456789",
            "arg1": "25"
        },
        {
            "expression": "* * * * *",
            "name": "set_play_type",
            "did": "123456789",
            "arg1": "2"
        }
    ]

示例中的意思是：

- 周一到周五每天 8 点播放歌曲 "周杰伦晴天"
- 周一到周五每天 8 点 10 分执行关机指令
- 每天 9 点播放歌曲 "周杰伦晴天"
- 每天 10 点播放列表 "周杰伦"
- 每天 10 点 30 分播放列表 "周杰伦" 里的 "晴天"
- 每天 7 点发出语音 "早上好！该起床了！"
- 每天 3 点刷新播放列表，用于自动更新目录下的歌曲到播放列表里。
- 每分钟设置音量为 25
- 每分钟设置为随机播放

> 注意星期一是0，星期二是1，星期日是6。 (0-6 or mon,tue,wed,thu,fri,sat,sun) The first weekday is always monday.

### 参数意思 ​

- expression 的格式是标准的 crontab 的格式，用于配置任务的执行时机，如何配置可以直接用下面的 crontab ai 工具生成
  - https://cronly.app/ai
  - https://cronify.zimo.li/
- name 是任务名，目前只支持上面那几种。
- did 是小爱音箱的设备ID，就是设置页面的音箱型号后面的那串数字。
- arg1 根据任务不同而不同。
  - play 的 arg1 表示要播放的歌曲名。
  - play_music_list 的 arg1 表示要播放的播放目录名，可以加 `|` 符合加上目录下面的歌曲名，也可不加。
  - tts 的 arg1 表示要说的语音文字。

## 评论 ​

### 评论 1 - hanxi ​

0.3.38版本功能。

链接到 GitHub Issue