允许玩家控制音乐。
语法[]
music play <trackName: string> [volume: float] [fadeSeconds: float] [repeatMode: MusicRepeatMode]
- 播放音乐。
music queue <trackName: string> [volume: float] [fadeSeconds: float] [repeatMode: MusicRepeatMode]
- 将音乐添加到队列中。
music stop [fadeSeconds: float]
- 停止播放音乐。
music volume <volume: float>
- 调整音乐音量。
参数[]
trackName: string
:basic_string
- 指定播放音乐名。
- 必须是单个单词(不含空格)或带引号的字符串。
- 必须为音乐名或为Json路径指向的 <a_resource_pack>/sounds/sound_definitions.json 文件中的
"record.<music_name>"
或"music.game.<music_name>"
(例如使用record.cat
来播放 "Cat" 唱片)
volume: float
:float
- 调整音乐音量
- 必须为浮点数,最小值为0,最大值为1.00。
fadeSeconds: float
:float
- 调整音乐淡入/淡出时间
- 必须为浮点数,最小值为0,最大值为10。
repeatMode: MusicRepeatMode
- 指定是否循环播放音乐,默认为
play_once
。 - 所取值必须为
loop
与play_once
中的一个。
执行结果[]
命令 | 触发条件 | 基岩版 |
---|---|---|
任意 | 没有正确输入参数 | 执行失败 |
/music play ... | 淡入/淡出时间超过10秒 | |
音量大于1.00 | ||
/music queue ... | 正在播放的音乐被设置为 loop | |
音量大于1.00 | ||
淡入/淡出时间超过10秒 | ||
/music stop ... | 没有正在播放的音乐 | |
淡入/淡出时间超过10秒 | ||
/music volume ... | 音量大于1.00 | |
任意 | 执行成功时 | 播放、插入播放队列、停止播放或调整音量. |
输出[]
命令 | 版本 | 条件 | 成功次数 |
---|---|---|---|
任意 | 基岩版 | 失败 | 0 |
成功 | 1 |
示例[]
循环播放Pigstep唱片
/music play record.pigstep 0.5 0 loop
将Stal唱片添加到播放列表且仅播放一次
/music queue record.stal 0.5 0 play_once
历史[]
关于“命令/music”的历史,请见各版本页面。
关于“命令/music”的历史,请见各版本页面。
关于“命令/music”的历史,请见各版本页面。
语言