SuperAPI AI 工具集

unity-timeline

通用与其它

查看项目

更新于 10-15 17:25

技能介绍

用途:在 Unity 编辑器中创建和修改 Timeline 资产,搭建过场与序列内容,包括创建 Timeline、添加类型化轨道、在轨道上放置片段、绑定对象、设置时长与 wrap 模式,以及通过 PlayableDirector 预览播放、暂停、停止。

主要能力(技能):

  • timeline_create:创建新的 Timeline 资产与 Director 实例,可指定 name(必填)、folder(默认 "Assets/Timelines")。
  • 添加轨道:timeline_add_animation_track、timeline_add_audio_track、timeline_add_activation_track、timeline_add_control_track、timeline_add_signal_track。均支持 name、instanceId、path 定位带 PlayableDirector 的 GameObject,以及 trackName;动画轨道还可传 bindingObjectName。
  • timeline_remove_track:按 trackName 移除轨道(Delete 类操作)。
  • timeline_list_tracks:列出全部轨道,返回 name、type、muted、clipCount。
  • timeline_add_clip:向指定 trackName 的轨道添加片段,可设 start(秒,默认 0)和 duration(秒,默认 1)。
  • timeline_set_duration:设置 Timeline 资产时长与 wrapMode(Hold/Loop/None)。
  • timeline_play:以 Editor 预览方式 play/pause/stop,不进入 Play mode。
  • timeline_set_binding:为轨道设置绑定对象。

用法与权限:调用前应先通过 GET /skills/recommend?includeSchema=true 或 GET /skills/schema 获取参数定义,避免按名称猜测参数。Approval 模式下查询类 timeline_list_tracks 直接执行,其余变更/播放类需用户 grant;Auto/Bypass 模式下未被禁用列表拦截的技能直接执行。timeline_remove_track 属 Delete 操作,仅在 Bypass 模式或加入 Allowlist 后可调用。

常见误区:不存在 timeline_create_animation、timeline_add_track、timeline_add_keyframe;应使用上述类型化轨道技能,片段用 timeline_add_clip 添加,timeline_set_duration 设置的是资产时长而非单个片段时长。Animator 参数/状态请用 animator 模块,运行时动画播放请用 editor_play 或通过 script 模块编写 C#。

限制:资料未提供具体版本兼容、定价或平台要求信息。