跳到主要内容

TEXT_DISPLAY_DESYNC_TRACK - 停止轨道同步

概述​

停止文本显示与轨道的同步，使文本固定在空间中。

技术规格​

属性值
效果类型TEXT_DISPLAY_DESYNC_TRACK
Java 枚举EffectType.TEXT_DISPLAY_DESYNC_TRACK
实现类TextDisplayDesyncTrackEffect

JSON 格式​

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

字段说明​

字段类型必需说明
eventTypestring是固定为 "TEXT_DISPLAY_DESYNC_TRACK"
beatdouble是效果触发的拍数
idstring是文本显示唯一标识符

使用示例​

停止轨道同步​

{
  "eventType": "TEXT_DISPLAY_DESYNC_TRACK",
  "beat": 20.0,
  "properties": {
    "id": "moving_text"
  }
}

配合轨道同步使用​

[
  {
    "eventType": "TEXT_DISPLAY",
    "beat": 0.0,
    "properties": {
      "id": "sync_text",
      "text": "跟随轨道",
      "position": [0.0, 1.5, 0.0],
      "rotation": [0.0, 0.0, 0.0],
      "scale": [1.0, 1.0, 1.0]
    }
  },
  {
    "eventType": "TEXT_DISPLAY_SYNC_TRACK",
    "beat": 2.0,
    "properties": {
      "id": "sync_text",
      "track": 0,
      "duration": 10000
    }
  },
  {
    "eventType": "TEXT_DISPLAY_DESYNC_TRACK",
    "beat": 12.0,
    "properties": {
      "id": "sync_text"
    }
  }
]

注意事项​

  1. ID 必须匹配: 要停止同步的文本显示 ID 必须与创建时使用的 ID 匹配
  2. 同步效果: 只会移除 TEXT_DISPLAY_SYNC_TRACK 效果，不会移除文本显示本身
  3. 时机: 确保在轨道同步效果激活后才执行停止同步

相关效果​

相关文档​