HIDE_NOTES - 隐藏音符效果

概述

隐藏或显示指定类型和轨道的音符。

技术规格

属性	值
效果类型	HIDE_NOTES
Java 枚举	EffectType.HIDE_NOTES
实现类	HideNoteEffect

JSON 格式

{
  "eventType": "HIDE_NOTES",
  "beat": 4.0,
  "properties": {
    "noteTypes": ["TAP", "LOOK"],
    "tracks": [0, 1],
    "hidden": true
  }
}

字段说明

字段	类型	必需	默认值	说明
eventType	string	是	-	固定为 "HIDE_NOTES"
beat	double	是	-	效果触发的拍数
noteTypes	string[]	否	所有类型	要隐藏的音符类型
tracks	int[]	否	所有轨道	要隐藏的轨道 ID
hidden	boolean	是	-	true=隐藏，false=显示

音符类型

类型	说明
TAP	点击音符
LOOK	观察音符
HOLD	长押音符
DODGE	躲避音符

使用示例

隐藏所有音符

{
  "eventType": "HIDE_NOTES",
  "beat": 4.0,
  "properties": {
    "hidden": true
  }
}

隐藏特定类型音符

{
  "eventType": "HIDE_NOTES",
  "beat": 8.0,
  "properties": {
    "noteTypes": ["TAP", "LOOK"],
    "hidden": true
  }
}

隐藏特定轨道音符

{
  "eventType": "HIDE_NOTES",
  "beat": 12.0,
  "properties": {
    "tracks": [0, 1],
    "hidden": true
  }
}

显示音符

{
  "eventType": "HIDE_NOTES",
  "beat": 16.0,
  "properties": {
    "hidden": false
  }
}

注意事项

1. 默认行为: 不指定 noteTypes 或 tracks 时影响所有
2. 隐藏逻辑: 音符在视觉上隐藏，但判定逻辑仍然存在
3. 持续时间: 效果会持续直到被其他 HIDE_NOTES 效果覆盖
4. 性能影响: 隐藏音符可以提高性能

相关效果

• GLOW_COLOR - 发光颜色

相关文档

• 效果系统总览
• 音符类型