LogoArcartX Doc
Shimmer工具集函数

Sound:音效控制

Sound音效控制工具集

关于那些无法言说的事物,我们必须保持沉默

音效播放

Sound.play(identifier, x, y, z, category, distance, pitch, duration)

  • 在指定位置播放3D音效
  • 参数
    • identifier: 字符串类型(音效标识符)
    • x: 整数类型(X坐标)
    • y: 整数类型(Y坐标)
    • z: 整数类型(Z坐标)
    • category: 字符串类型(音效类别)
    • distance: 整数类型(音效传播距离)
    • pitch: 双精度浮点数类型(音调)
    • duration: 整数类型(持续时间)
  • 调用示例
Sound.play("minecraft:block.note_block.harp", 100, 64, 100, "music", 16, 1.0, 20)

Sound.entityPlay(identifier, target, category, distance, pitch, duration)

  • 为指定实体播放3D音效
  • 参数
    • identifier: 字符串类型(音效标识符)
    • target: 字符串类型(目标实体UUID,使用"self"表示玩家自身)
    • category: 字符串类型(音效类别)
    • distance: 整数类型(音效传播距离)
    • pitch: 双精度浮点数类型(音调)
    • duration: 整数类型(持续时间)
  • 调用示例
Sound.entityPlay("minecraft:entity.player.levelup", "self", "player", 16, 1.0, 20)

注意事项:

  • 音效标识符需要使用Minecraft的资源标识符格式
  • 音效类别可以是:master, music, record, weather, block, hostile, neutral, player, ambient, voice
  • 确保目标实体UUID正确,否则音效将不会播放
  • 当世界未加载时,entityPlay方法可能无法正常工作

On this page