跳到主要内容

REMOVE_HOLOGRAM - 移除全息图效果

概述​

移除之前创建的全息图。

技术规格​

属性值
效果类型REMOVE_HOLOGRAM
Java 枚举EffectType.REMOVE_HOLOGRAM
实现类RemoveHologramEffect

JSON 格式​

{
  "eventType": "REMOVE_HOLOGRAM",
  "beat": 4.0,
  "properties": {
    "id": "RhyMCGameHologram_1234567890"
  }
}

字段说明​

字段类型必需说明
eventTypestring是固定为 "REMOVE_HOLOGRAM"
beatdouble是效果触发的拍数
idstring是要移除的全息图 ID

使用示例​

移除特定全息图​

{
  "eventType": "REMOVE_HOLOGRAM",
  "beat": 10.0,
  "properties": {
    "id": "score_display"
  }
}

配合 HOLOGRAM 使用​

[
  {
    "eventType": "HOLOGRAM",
    "beat": 4.0,
    "properties": {
      "location": [0.0, 2.0, 0.0],
      "id": "temp_message",
      "contents": ["Get Ready!"],
      "duration": 3000
    }
  },
  {
    "eventType": "REMOVE_HOLOGRAM",
    "beat": 7.0,
    "properties": {
      "id": "temp_message"
    }
  }
]

ID 匹配规则​

全息图 ID 的匹配规则：

  1. 完整 ID: 游戏实例GUID_用户ID
  2. 部分匹配: 系统会自动处理 ID 前缀

示例​

如果创建时使用 "id": "score_display"，实际全息图 ID 为：

{游戏实例GUID}_score_display

移除时只需要提供 "id": "score_display"，系统会自动添加前缀。

注意事项​

  1. ID 必须匹配: 要移除的全息图 ID 必须与创建时使用的 ID 匹配
  2. 自动前缀: 系统会自动添加游戏实例 GUID 前缀
  3. 不存在的全息图: 如果全息图不存在，调用删除不会报错
  4. 时机: 确保在全息图创建后才执行移除操作

相关效果​

相关文档​