/playsound

/playsound

来源：Commands/playsound；原文修订 ID：3844881。

权限等级：Java 版为 2，基岩版为 1；基岩版需要启用作弊。

在指定位置、以指定音量和音调向玩家播放声音。

语法

  • Java 版：playsound <sound> [<source>] [<targets>] [<pos>] [<volume>] [<pitch>] [<minVolume>]。
  • 基岩版：playsound <sound: string> [player: target] [position: x y z] [volume: float] [pitch: float] [minimumVolume: float]。

参数

sound

sound（resource_location）／sound: string（basic_string）：要播放的声音。基岩版应为 sound_definitions.json 中的声音定义，例如 mob.pig.say；Java 版应为 sounds.json 中的声音事件，例如 entity.pig.ambient。

声音事件可以关联多个声音，实际播放哪个声音会像游戏正常处理一样按权重随机选择。例如 entity.pig.ambient 关联多个声音，因而会随机播放其中一种猪叫。

资源包可以在 sounds.json 添加事件，本命令可成功播放。命令不使用文件名，而严格使用事件名；事件名甚至可能与文件原名和路径没有相似之处。因此，添加新声音文件的资源包必须为其定义事件；若只是替换已有事件关联的旧声音，则不必另设事件。

source（仅 Java 版）

声音所属的音乐类别及选项，必须为 master、music、record、weather、block、hostile、neutral、player、ambient、voice 或 ui。省略时为 master。

其他参数

  • targets（entity）／player: target（CommandSelector<Player>）：接收声音的一个或多个玩家，省略时为执行命令的玩家。
  • pos（vec3）／position: x y z（CommandPositionFloat）：播放声音的位置。
  • volume／volume: float：决定可听距离，默认 1。小于 1 时音量降低；大于 1 时声音实际上不会更响，而是将可听范围（值为 1 时半径为 16 方块）乘以此值。声音始终随距球心距离增大而渐渐衰减至无声。小于等于 0 时没有玩家能听到。Java 版要求浮点数且不小于 0.0；基岩版为浮点数。
  • pitch／pitch: float：音调与播放速度，默认 1。Java 版参数范围为 0.0–2.0，低于 0.5 的值等同 0.5；低于 1 会降低音调并延长声音，高于 1 则提高音调并缩短声音。该值是频率乘数，在 0.5–1 范围内将其翻倍会升高一个八度。其他音程换算见音符盒用法，但并非所有音效的值 1 都对应升 F。基岩版只有 0–256 的值有效，超过 256 等同默认值，低于 0 默认为 1，等于 0 则无法听见；音调值也直接充当速度乘数，例如 2 表示双倍音调及双倍速度。基岩版修改音调必然同时修改播放速度。
  • minVolume／minimumVolume: float：正常可听球体之外目标的音量。目标在球体外时，声音改为在其附近（相距 2 方块）发出，此参数控制该声音音量。值不大于 0 时，球体外目标无法听见；默认为 0.0。Java 版要求范围 0.0–1.0 的浮点数；基岩版为浮点数。

结果

命令不完整或任意参数不正确时无法解析。基岩版目标选择器不是玩家类型时失败；目标未解析到在线玩家，或没有人能听见声音（最小音量不大于 0.0，且全部目标都在正常可听球体外）时失败。基岩版有任意指定玩家无法听见声音时也会失败，原文标记这一行为仍需测试。其他情况成功。

输出

Java 版失败时成功次数、success、result 均为 0；成功时成功次数和 success 为 1，result 为能听见声音的玩家数量。基岩版失败时成功次数为 0，成功时为目标玩家数量。

示例

在最近玩家身后 3 方块处播放苦力怕嘶嘶声：

  • Java 版：/execute as @p at @s run playsound entity.creeper.primed hostile @s ^ ^ ^-3 1 0.5。
  • 基岩版：/execute as @p at @s run playsound note.creeper @s ^ ^ ^-3 1 0.5。

另见

/stopsound：停止声音。

外部链接

中文翻译/改编自 Minecraft Wiki 原条目，原文作者可由页面历史查看；译文遵循 CC BY-NC-SA 3.0（署名、非商业性使用、相同方式共享）。