跳到主要内容

TEXT_DISPLAY_REMOVE - 移除文本显示

概述​

移除之前创建的文本显示。

技术规格​

属性值
效果类型TEXT_DISPLAY_REMOVE
Java 枚举EffectType.TEXT_DISPLAY_REMOVE
实现类TextDisplayRemoveEffect

JSON 格式​

{
  "eventType": "TEXT_DISPLAY_REMOVE",
  "beat": 20.0,
  "properties": {
    "id": "text_display_id"
  }
}

字段说明​

字段类型必需说明
eventTypestring是固定为 "TEXT_DISPLAY_REMOVE"
beatdouble是效果触发的拍数
idstring是要移除的文本显示 ID

使用示例​

移除文本显示​

{
  "eventType": "TEXT_DISPLAY_REMOVE",
  "beat": 20.0,
  "properties": {
    "id": "score_display"
  }
}

配合 TEXT_DISPLAY 使用​

[
  {
    "eventType": "TEXT_DISPLAY",
    "beat": 0.0,
    "properties": {
      "id": "temp_text",
      "text": "临时文本",
      "position": [0.0, 2.0, 0.0],
      "rotation": [0.0, 0.0, 0.0],
      "scale": [1.0, 1.0, 1.0]
    }
  },
  {
    "eventType": "TEXT_DISPLAY_REMOVE",
    "beat": 5.0,
    "properties": {
      "id": "temp_text"
    }
  }
]

注意事项​

  1. ID 必须匹配: 要移除的文本显示 ID 必须与创建时使用的 ID 匹配
  2. 资源释放: 移除后文本显示资源会被回收
  3. 时机: 确保在文本显示创建后才执行移除操作

相关效果​

相关文档​