3.0 KiB
3.0 KiB
更新版 Console 文档
Console概要
Editor内有console系统，用于执行某些方便的操作。
在编辑界面内按 ` 键（Esc键下方）可以唤出console输入框，输入完成后按Enter键执行指令。
输入框支持上下文历史记录，按上下箭头可浏览历史指令。
输入格式：
- func "abc123" 1 2 [0,1,2]
- 或 func(1,2,3,"a",[1,2,3])
- 字符串需双引号包裹（
"abc123"） - 向量需中括号包裹（
[0,0,1]）
执行失败时会在Log Window显示错误信息。部分指令依赖Inspector窗口当前选中对象，请提前选择目标对象。
命令列表
基础操作
tp(Vector3 pos)
- 将场景相机移动到指定坐标
- 示例：
tp [10,5,0]
tp()
- 将场景相机移动到当前选中对象的位置
- 需在Inspector中选中对象
ReName(string message)
- 重命名当前选中对象
- 示例：
ReName "NewTrackName"
路径生成
Lgp(int loop, Vector3 start, Vector3 end)
- 在选中的Track上生成线性路径节点
- 参数：
loop：生成节点数量start：起始坐标end：结束坐标
- 示例：
Lgp 10 [0,0,0] [5,0,5]
Spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, string axis = "y")
Spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, Vector3 dir)
- 在选中的Track上生成螺旋路径节点
- 参数：
loop：总节点数center：螺旋中心点r：螺旋半径h：螺旋高度pointsPerTurn：每圈节点数axis：主轴方向（"x"/"y"/"z"）dir：自定义方向向量
- 示例：
Spiral 20 [0,0,0] 3 10 8 "z"
数据处理
SamplerImport(string inputData)
- 导入采样器格式的音符数据
- 数据格式：
(动作类型, 轨道ID, 时间戳, X值, [Hold持续时间]) - 支持动作类型：Tap, Stay, Hold, Flick
- 示例：
SamplerImport "(Tap, Track1, 12.5, 3.2)"
音符操作
SetNoteHLInGame(bool forceSetOff = false, bool SameTheme = false)
- 全局高亮重复时间点的音符
- 参数：
forceSetOff：是否先关闭所有高亮SameTheme：是否要求音符类型相同
SetNoteHLInElement(bool forceSetOff = false, bool SameTheme = false)
- 在当前元素内高亮重复时间点的音符
- 参数同上
AttachNoteInNearestTrail()
- 将轨道上的音符吸附到最近的轨迹线
- 需选中Track对象
动画操作
swapDisplacement()
- 反转位移动画方向（正负值互换）
- 需选中Displacement元素
swapSwirl()
- 反转旋转动画方向
- 需选中Swirl元素
swapScale()
- 反转缩放动画方向
- 需选中Scale元素
对象管理
DelSameInParent()
- 删除父对象中所有同类型的兄弟元素（包括自身）
- 示例：删除当前选中类型的所有同级对象
其他
更多功能持续开发中。使用console时可参考编辑器内的自动补全提示和参数类型检查功能。