TITLE - 标题显示效果

概述

在屏幕中央显示主标题和副标题。

技术规格

属性	值
效果类型	TITLE
Java 枚举	EffectType.TITLE
实现类	TitleEffect

JSON 格式

{
  "eventType": "TITLE",
  "beat": 4.0,
  "properties": {
    "title": "主标题",
    "subtitle": "副标题",
    "fadeIn": 20,
    "stay": 60,
    "fadeOut": 20
  }
}

字段说明

字段	类型	必需	说明
eventType	string	是	固定为 "TITLE"
beat	double	是	效果触发的拍数
title	string	是	主标题文本
subtitle	string	否	副标题文本
fadeIn	int	是	淡入时间（tick）
stay	int	是	停留时间（tick）
fadeOut	int	是	淡出时间（tick）

使用示例

基本标题

{
  "eventType": "TITLE",
  "beat": 4.0,
  "properties": {
    "title": "Level 1",
    "subtitle": "开始游戏",
    "fadeIn": 20,
    "stay": 60,
    "fadeOut": 20
  }
}

只有主标题

{
  "eventType": "TITLE",
  "beat": 8.0,
  "properties": {
    "title": "完美！",
    "fadeIn": 10,
    "stay": 30,
    "fadeOut": 10
  }
}

长时间显示

{
  "eventType": "TITLE",
  "beat": 12.0,
  "properties": {
    "title": "恭喜通关",
    "subtitle": "最终得分：1000000",
    "fadeIn": 30,
    "stay": 120,
    "fadeOut": 30
  }
}

时间计算示例

假设 fadeIn=20, stay=60, fadeOut=20：

时间点	动画状态
beat + 0 tick	开始淡入
beat + 20 tick	完全显示
beat + 80 tick	开始淡出
beat + 100 tick	完全消失

注意事项

1. 时间单位: 使用 tick 而不是毫秒
2. 屏幕位置: 标题固定在屏幕中央
3. 覆盖: 新的标题会覆盖之前的标题
4. 性能: 标题效果性能开销小，可以频繁使用

相关效果

• MESSAGE - 聊天消息
• TEXT_DISPLAY - 3D 文本显示

相关文档

• 效果系统总览