PR 脚本坑
· Leave a comment以下是专属于 Premiere Pro 脚本开发的血泪教训总结,建议直接收藏,下次开新对话可以直接贴给我作为“避坑指南”。
⏱️ 1. 时间与时长坑(最致命)
· 改 start 必须同步改 end:脚本给 clip.start 赋新值后,PR 不会自动移动 end。如果只改 start,片段时长会被直接拉长,导致后面所有素材错位。
· 图片的 1 小时(3600秒)偏移:静态图片素材底层入点默认在 3600 秒。给图片加关键帧时,传入的时间必须是 (目标时间 - 片段起点) + 3600。直接传全局时间或 0 会导致关键帧跑到几万秒外或直接无效。
· 必须“先快照,再计算,最后应用”:如果一边修改时间一边用 clip.end - clip.start 算时长,拿到的数据会被污染。必须先把所有原始 start、end、dur 存入数组,算好最终结果,最后统一写入时间线。
🎞️ 2. 关键帧与特效坑
· 原生组件加不了关键帧:直接在图片的原生“不透明度”或“运动”属性上 addKey,大概率不报错但 UI 没反应(numKeys 返回 undefined)。
· 用特效组件做跳板:必须先用 QE 给图片加上“变换”或“方向模糊”等特效,然后对特效里的属性打关键帧,才能成功且可见。
· 没有贝塞尔手柄控制权:PR 脚本里没有 KeyframeEase,setInterpolationTypeAtKey 虽然能设贝塞尔,但无法修改手柄曲率(切线/速度)。视觉上和线性没区别。只能用“密集关键帧 + 数学公式(如 smoothstep)”来模拟缓动。
🛠️ 3. 标准 API 的“功能残缺”
· 不能加轨道:标准 API 没有 add 方法,只能用 app.enableQE() 开启 QE DOM 后,用 qeSeq.addTracks(n)。代价是每次加视频轨都会强制附赠一条音频轨。
· 不能垂直移轨:clip.moveToTrack 不存在。只能“在目标轨道用 overwriteClip 复制,再删掉原轨道上的片段”。
· 不能加特效:标准 API 无 addVideoEffect,必须借助 QE:qeClip.addVideoEffect("AE.ADBE Transform")。
· 读不到图片尺寸:getVideoFrameSize() 在图片上大概率失效。必须加载 XMP 库,读取元数据 Column.Intrinsic.VideoInfo 并截取 "宽x高" 字符串。
🔀 4. 排序与冲突坑
· 全局按时间排序会错乱:如果做过交错动画(比如 V3 偶数图提前了 0.3 秒),按整个时间线 start 排序会导致图片顺序错乱。必须分轨道独立排序,再按规则交错合并。
· 同轨道重叠会报错:如果新时间导致同轨道片段重叠,clip.start 赋值会静默失败或部分失败。写入时间必须“从后往前”倒序遍历,先处理后面的片段,腾出空间。
🚫 5. 撤销与容错坑
· 脚本操作无法撤销(Ctrl+Z 无效):ExtendScript 修改不进入撤销栈。任何脚本运行前,必须 Ctrl+S 或另存为副本,出错了直接关闭不保存。
🌐 6. 环境命名坑
· 中英文属性名要兼容:displayName 受语言包影响。代码里必须写 "不透明度" || "Opacity"、"运动" || "Motion" 这种兼容写法,否则换台电脑或切个语言就崩了。