TEXT_DISPLAY_SYNC_TRACK - 轨道同步文本显示

概述

使文本显示跟随指定轨道的变换（位置、旋转、缩放）。

技术规格

属性	值
效果类型	TEXT_DISPLAY_SYNC_TRACK
Java 枚举	EffectType.TEXT_DISPLAY_SYNC_TRACK
实现类	TextDisplaySyncTrackEffect

JSON 格式

{
  "eventType": "TEXT_DISPLAY_SYNC_TRACK",
  "beat": 4.0,
  "properties": {
    "id": "text_display_id",
    "track": 0,
    "duration": 5000
  }
}

字段说明

字段	类型	必需	默认值	说明
eventType	string	是	-	固定为 "TEXT_DISPLAY_SYNC_TRACK"
beat	double	是	-	效果触发的拍数
id	string	是	-	文本显示唯一标识符
track	int	是	-	轨道 ID
duration	long	否	31536000000L	持续时间（毫秒）

使用示例

跟随轨道 0

{
  "eventType": "TEXT_DISPLAY_SYNC_TRACK",
  "beat": 4.0,
  "properties": {
    "id": "moving_text",
    "track": 0,
    "duration": 10000
  }
}

配合 TEXT_DISPLAY 使用

[
  {
    "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": 8000
    }
  }
]

相关效果

• TEXT_DISPLAY - 创建文本显示
• TEXT_DISPLAY_DESYNC_TRACK - 停止轨道同步

相关文档

• 效果系统总览