用途:当用户想播放音乐、控制播放或查看正在播放的内容时使用这组工具。
主要能力:music_play 在音箱上播放艺术家、专辑、曲目、播放列表或流派;music_control 执行暂停、继续、跳过、音量、随机、循环;music_search 按名称查找艺术家、专辑、曲目、播放列表和流派,空查询返回曲库内容;music_now_playing 查看当前播放;music_players 列出可用音箱。
使用方式:搜索匹配的是名称而非情绪,如“soft acoustic morning music”找不到结果。要按情绪播放,可先选一个流派并作为 media 传入,例如 music_play(media="Folk") 会播放该流派的无限随机混音。music_search(query="") 会列出曲库中的流派(含曲目数)和随机若干艺术家。不要凭空编造音箱名称;省略 player 即使用默认音箱,若用户指定了具体音箱,先调用 music_players。参数名需注意:music_play 用 media(不是 uri/query);music_control 用 action(不是 command)。来自 music_search 的 uri 放入 media,例如 music_play(media="library://track/123")。
播放模式:play 替换队列并开始播放(默认);next 插入到当前曲目之后;add 追加到队列末尾;replace 替换队列但不开始;replace_next 替换后续曲目并保留当前曲目。
限制:按情绪选流派时,优先选曲目较多的流派,曲目过少的流派会很快重复;每次调用只传一个名称,不要把情绪词拼成查询。资料未提供收费、平台支持范围等更多信息。