播放一段声音。
语法[]
- Java版
playsound <sound> <source> <targets> [<pos>] [<volume>] [<pitch>] [<minVolume>]
- 基岩版
playsound <sound: string> [player: target] [position: x y z] [volume: float] [pitch: float] [minimumVolume: float]
参数[]
JE：<sound>：resource_location
BE：sound: string：basic_string
- 指定要播放的声音。必须为在sounds.json中被定义的一个声音项目（例如，
entity.pig.ambient）。
- 一个声音项目可被多个不同的声音关联，而实际产生的声音为从中随机挑选的结果，被选中的概率由其权重决定，与正常游戏中相同。例如，声音项目
entity.pig.ambient会随机播放多种猪音效之一，因为有多个声音关联于该项目。
- 资源包可能会向sounds.json中添加额外的声音项目；此命令可以正常播放这些项目。该命令使用的声音名称不是文件名；而是严格使用sounds.json内定义的项目（项目名称可能与实际音频文件的文件名和目录相差甚远），因此资源包在添加新声音时必须为这些音频文件定义声音事件项目（但当资源包替换原有的已被定义的音频文件时，不必为其重新定义）。
JE: <source>
- 指定播放声音所属的类别，对应于游戏选项中“音乐和声音”设置的分类。必须为以下之一：
master、music、record、weather、block、hostile、neutral、player、ambient或voice。
JE：<targets>：entity
BE：player: target：CommandSelector<Player>
- 指定播放声音的目标。
- 必须为玩家名、目标选择器或UUID。且目标选择器只允许玩家。
JE：<pos>：vec3
BE：position: x y z：CommandPositionFloat
- 指定声音发出的方位。
- 必须为三维坐标，元素为浮点数。允许波浪号与脱字号标记。
JE：<volume>：float
BE：volume: float：float
- 指定声音能被听见的距离。必须至少为0.0。对小于1.0的值，声音会相对减轻，球状可闻范围会相对小。对大于1.0的值，声音不会实际上增大，但其可闻范围（1.0时半径为16米）会与音量相乘。声音总会基于与球体中心的距离逐渐衰减至无声。默认为1.0。
- 必须为单精度浮点数。在Java版中，必须大于等于0.0。
JE：<pitch>：float
BE：pitch: float：float
- 指定声音的音调。若未指定，默认为1.0。
- 在Java版中，该数值必须在0.0至2.0间（含），而小于0.5的值与0.5等价。小于1.0的值降低音调而提升持续时间；大于1.0的值提升音调而降低持续时间。音调值是乘在声音频率上的一个倍率，因此若将0.5-1.0（含）区间内的音调值乘以2，所得的新音调便会高一个八度。
- 在基岩版中，该数字没有特别限制，但是必须要在0.0至256.0之间才有对应效果。高于256.0的值与默认值的效果相同。小于等于0.0的值会导致听不到该声音。
- 在基岩版中，此参数在调整音调时会相应地调整声音的播放速度，且播放速度相对于原音频采样速度的倍率即为此参数的值。
JE：<minVolume>：float
BE：minimumVolume: float：float
- 指定在声音可闻范围外的目标能听到的音量。若目标在可闻范围外，作为补偿，声源会被放置在距离目标较近的位置（距离小于4格），而
最小音量会决定补偿声源的音量。 - 如果此数值等于0，则正常可闻范围外的目标听不到声音。如果未指定，则默认为0.0。
- 必须为单精度浮点数。在Java版中，必须在0.0和1.0（含）之间。
效果[]
| 命令 | 触发条件 | Java版 | 基岩版 |
|---|---|---|---|
| 任意 | 参数不正确 | 无法解析 | 无法解析 |
<targets>或player: target无法解析玩家（指定的玩家必须在线） | 执行失败 | 执行失败 | |
minVolume或minimumVolume: float不大于0，且所有目标在正常可听范围之外。 | |||
| 其中至少一名玩家无法听见声音 | N/A | ||
player: target非玩家目标选择器 | |||
| 执行成功时 | 为指定玩家播放指定声音 | ||
输出[]
| 命令 | 版本 | 条件 | 成功次数 | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| 任意 | Java版 | 失败 | 0 | 0 | 0 |
| 成功 | 1 | 1 | 听见声音的玩家数量 | ||
| 基岩版 | 失败 | 0 | N/A | N/A | |
| 成功 | 目标玩家数量 | N/A | N/A |
历史[]
| Java版 | |||||
|---|---|---|---|---|---|
| 1.6.1 | pre | 加入了/playsound命令。 | |||
| 1.9 | 15w49a | /playsound命令现在命令支持Tab键自动补全。 | |||
| 16w02a | 现在/playsound命令要求source参数，指定声音所属的分类，以归入音量控制。 | ||||
| 携带版 | |||||
| 1.0.5 | 1.0.5.0 | 加入了/playsound命令。 | |||
参见[]
/stopsound— 停止一段声音。
语言