video.tracked-callout

运动跟随标注

Tracked Callout

仅本次打开有效

Live preview

真实渲染预览

查看引用 ↓

Purpose

这个动效用来做什么

用显式源画面轨迹和可见区间，让标注锚点持续跟随视频中的移动部件。

Tracked Callout with deterministic replaceable local media inputs.

范围: 镜头
复杂度: 高级
建议时长: 8s
画幅: 16:9 · 9:16

视频文字

解释聚焦

产品演示教程知识视频

Inputs

可替换参数

settings必填 · object

完整结构化本地媒体输入；使用 remotion/default.json。路径相对于 public/。

展开完整输入示例（JSON）

{
  "video": "p3/source-r5/float.mp4",
  "videoOffset": 0,
  "trajectory": [
    {
      "time": 0,
      "x": 0.69844,
      "y": 0.51719
    },
    {
      "time": 1,
      "x": 0.7125,
      "y": 0.42812
    },
    {
      "time": 2,
      "x": 0.71016,
      "y": 0.43984
    },
    {
      "time": 3,
      "x": 0.69922,
      "y": 0.48984
    },
    {
      "time": 4.5,
      "x": 0.67969,
      "y": 0.46719
    },
    {
      "time": 5.5,
      "x": 0.61016,
      "y": 0.45469
    },
    {
      "time": 6.5,
      "x": 0.55781,
      "y": 0.42969
    },
    {
      "time": 8,
      "x": 0.53203,
      "y": 0.45859
    }
  ],
  "visible": [
    [
      0,
      8
    ]
  ],
  "label": "右侧头梁连接位",
  "side": "left",
  "focal": {
    "x": 0.5,
    "y": 0.5
  },
  "duration": 8,
  "accent": "#e45d36"
}

Motion timeline

归一化动作时间线

所有事件都使用 0 到 1 的归一化进度：0 是镜头开始，1 是镜头结束；事件可以重叠，适配器再把相同比例映射到秒或帧。

effect.enteropacity.fade

0.03–0.40

effect.holdstate.hold

0.55–1.00

Copy to Agent

复制执行上下文

预览与引用使用同一个引擎选择。上下文保留共享机器标记与对应 Adapter 路由。

正在加载当前 Recipe 的上下文…

Engine implementations

引擎实现

frame-based

Remotion

已验证

Composition: TrackedCalloutRecipe
入口文件: TrackedCalloutRecipe.tsx
确定性: 是

typecheck通过
build通过
render通过

Source, reference & rights

来源与使用边界

再分发状态: original
来源说明: Original procedural P3 media and implementation authored for ghost / Motion Registry; dependency licenses remain separate.
Recipe 文件: recipes/video/tracked-callout/recipe.yaml

参考

无外部参考；该 Recipe 与测试素材为项目原创。

Verification

验收标准

real-input

Default and two materially different local-media input sets render in both verified orientations.

distinct-motion

用显式源画面轨迹和可见区间，让标注锚点持续跟随视频中的移动部件。

bounded-layout

Landscape and portrait outputs preserve the reviewed action, safe areas and stable reading hold.

1 个实现已通过真实渲染理解验证模型