netease-modsdk-wiki/docs/wiki/commands/playsound.md

title, category, mentions, tags

title	category	mentions	tags
播放音效	命令	BedrockCommands zheaEvyline jordanparki7	信息

播放音效

简介

由 Bedrock Commands 社区 Discord 提供

你可以使用/playsound命令在世界任意位置为玩家播放音效。

语法

/playsound <sound> [player] [position] [volume] [pitch] [minimumVolume]

参数定义

sound

• 需要播放的音效ID
• 当前可用音效列表可参考：
  • https://www.digminecraft.com/lists/sound_list_pe.php

player

• 可选参数
• 目标选择器参数（接收音效的玩家）@a, @r, @p, Technoblade 等

position

• 可选参数
• 音效播放的坐标 x y z，即音效可听范围的圆心坐标

volume

• 可选参数
• 决定音效可听范围的半径
  • 最小值是 0.0
• 该值越大，音效传播范围越广
  • 音量 1 对应半径16方块的球形范围
  • 音量 4 对应半径64方块的球形范围

pitch

• 可选参数
• 控制音效的音调高低
• 取值范围 0.0 至 256.0
  • 数值越高音调越尖锐
  • 数值小于等于 0.0 时音效不可闻

注意：音调参数会影响音频播放速度。例如音调 0.5 表示以 0.5 倍速播放音频

minimumVolume

• 可选参数
• 设置可听范围外的最小音量
• 取值范围 0.0 至 1.0

使用示例

::: code-group

# 对最近的玩家播放随机爆炸音效
/playsound random.explode @p

# 为所有玩家在其当前位置播放随机经验球音效（音量范围10000）
/execute as @a at @s playsound random.orb @s ~ ~ ~ 10000

:::

注意：由于播放音效命令具有位置依赖性，在特殊场景（如使用/tp传送后）建议采用第二个示例中的execute命令结构来避免音效中断。当需要覆盖远距离时，可以适当增大音量参数来确保播放效果。

（推荐）延伸阅读：声音系统