用途:在 Pireel Studio 中管理字幕层。字幕是从语音转录稿生成的全局预设层,一个设置作用于整条视频,不是逐块编辑;一次 set_captions 调用即可全局开启、换样式或改位置,剪辑后会自动重新铺设字幕,无需手动修补。视频内的关键词花字属于叠加块(经 compose_block_brief → apply_block),与字幕层不同。
主要能力与用法:set_captions {preset?, yPct?, scale?} 开启或换样式;preset 取自下表样式 id,传入会依据转录稿重建字幕层并在关闭时自动开启,若无转录稿会先自动运行 ASR,不要自造 id。yPct 为基线距顶部百分比,越小越靠上;scale 为尺寸倍数,1 为预设默认值。只传 yPct/scale 可仅移动或缩放;remove_captions 关闭整层,但不影响关键词块。set_caption_translations {items?, shotId?, clear?} 用于双语字幕:先用 read_script 取带编号的转录行,自行翻译后一次性批量提交 items(index 为行号,每句一句、不带时间戳);该功能不消耗积分,字幕关闭时会提示,可再 set_captions 开启。翻译附着在转录稿上,剪辑与换样式后保留,重新转录新文件会丢失;插入片段需用其 shotId 再调用一次。单行可用 {index,text} 修正,text:"" 删除单行,{clear:true} 清空全部;翻译行继承预设外观,更小且无逐词动画,无独立样式开关。
18 种预设分两类:emphasis(逐词强调)整句常驻、所读词高亮,含 em-yellow、em-green、em-purple-black、em-serif-black、em-underline、em-blue-line、em-box-purple、em-box-blue、em-pink、em-gold-serif;line(整句字幕)逐行淡入无逐词动画,含 ln-clean、ln-black、ln-navy、ln-white、ln-orange、ln-yellow、ln-red、ln-mint。无样式偏好时默认选干净的整句预设(ln-clean);高能口播或要求“朗读时高亮单词”时用 emphasis(无颜色偏好选 em-yellow);可按画面主题配色匹配,不要超出目录自行改造。位置尺寸默认多可满足,与图形或人脸冲突时再调。
限制:译文由用户自行翻译,工具只做存储;样式仅限既定目录,命名未提供的信息暂未提供。