播放声音 1.21.4

学习如何播放声音事件（SoundEvent）。

WARNING

本页面适用于 1.21.4 版本。 针对旧版本的文档可能不完整。

Minecraft 有大量的声音供您选择。 查看 SoundEvents 类以查看 Mojang 提供的所有原版声音事件实例。

在您的模组中使用声音

使用声音时请确保在逻辑服务端执行 playSound() 方法。

在此示例中，自定义交互项的 interactLivingEntity() 和 useOn() 方法用于播放“放置铜块”和掠夺者声音。

@Override
public InteractionResult interactLivingEntity(ItemStack stack, Player user, LivingEntity entity, InteractionHand hand) {
	// As stated above, don't use the playSound() method on the client side
	// ... it won't work!
	if (!entity.level().isClientSide()) {
		// Play the sound as if it was coming from the entity.
		entity.playSound(SoundEvents.PILLAGER_AMBIENT, 2f, 0.7f);
	}

	return super.interactLivingEntity(stack, user, entity, hand);
}

playerSound() 方法与 LivingEntity 对象一起使用。 只需要指定 SoundEvent、音量（volume）和音高（pitch）。 播放声音事件（SoundEvent） 只需要指定 SoundEvent、音量（volume）和音高（pitch）。 playerSound() 方法与 LivingEntity 对象一起使用。 只需要指定 SoundEvent、音量（volume）和音高（pitch）。 您还可以使用世界实例中的 playSound() 方法以获得更高级别的控制。

@Override
public InteractionResult useOn(UseOnContext context) {
	if (!context.getLevel().isClientSide()) {
		// Play the sound and specify location, category and who made the sound.
		// No entity made the sound, so we specify null.
		context.getLevel().playSound(null, context.getClickedPos(),
				SoundEvents.COPPER_PLACE, SoundSource.PLAYERS,
				1f, 1f);
	}

	return super.useOn(context);
}

声音事件与声音组（SoundCategory）

声音事件定义了播放哪个声音。 播放声音事件（SoundEvent） 声音事件定义了播放哪个声音。 您也可以注册您自己的声音事件以包含您自己的声音。

Minecraft 在游戏设置中有多个音频滑块。 SoundSource 枚举类用于确定哪个滑块可以调整您声音的音量。

音量和音调

音量参数可能有些误导。 在 0.0f - 1.0f 的范围内可以改变声音的实际音量。 如果数字大于这个范围，将使用 1.0f 的音量，并且仅调整声音能听到的距离。 通过 volume * 16 可以粗略算出方块距离。

音高参数会增加或减少音高数值，还会改变声音的持续时间。 在 (0.5f - 1.0f) 范围内，音高和速度会减小，而较大的数字会增加音高和速度。 0.5f 以下的数字将保持 0.5f。