编辑 EP.028 那期《城市夜航》的时候，我把播放头拖到 08:24，“智能文稿"里显示的是"我们开始意识到，声音不只是内容的载体……”，可波形上对应的却是两秒前嘉宾的尾音。字幕和声音之间始终差着一小段，而且越往后偏得越多——08:21 的文稿要拖到 08:24 才听到。字没打错，是整个字幕轨和波形轨在时间上错开了。
最让我警觉的是这个偏差是累积的。开头几秒还对齐，播到 18 分钟的总时长时，字幕已经漂了差不多三秒。累积型漂移，根源通常在两套时间基准不同步。波形采样走的是音频时钟，字幕时间戳走的是转录工具自己的一套对齐结果，两边速率有一丁点差异，乘上 18 分钟就放大成了几秒。
波形和字幕各自的时间轴
波形这边，界面上的"多轨时间线"有 HOST、GUEST、MUSIC 三条轨，每轨下面是一排竖条，那其实是波形按桶切出来的能量柱。音频采样率 44.1kHz，一秒就有 44100 个采样点，直接画不下，得先分桶：每 100ms 一个桶，桶内取峰值或 RMS 值，一根柱一个桶。分桶之后，波形就不再是一串采样点，而是一串等长的时间桶，桶的序号天然就是时间刻度。
字幕这边，转录出来的文稿是"时间戳 + 文本"的 cue 列表，时间戳精确到毫秒。问题在于，这两套时间刻度不是同一个原点、同一个速率。波形桶的序号靠音频采样数推算，字幕时间戳靠转录引擎对录音的断句判断，后者在长录音里会有一点可变的拉伸。
要让它俩对齐，我的做法是让字幕向波形的时间网格靠拢——波形桶保持不动，只把字幕 cue 的时间戳"吸附"到最近的桶边界上。桶网格是刚性的，字幕是柔性的，让柔性的去迁就刚性的，偏差就被钉死在半个桶的范围内。
interfaceWaveBucket{index:number// 桶序号，从 0 起startMs:number// 桶起点，毫秒endMs:numberpeak:number// 桶内采样峰值，0~1rms:number// 桶内均方根能量}interfaceTranscriptCue{id:numberspeaker:'HOST'|'GUEST'|'MUSIC'startMs:number// 转录工具给出的原始起点endMs:numbertext:string}constSAMPLE_RATE=44100constBUCKET_MS=100// 每桶 100msconstSAMPLES_PER_BUCKET=SAMPLE_RATE*BUCKET_MS/1000// 4410SAMPLES_PER_BUCKET是 4410。这里有个容易踩的数字：44100 × 0.1 = 4410 正好整除，所以桶和采样边界严丝合缝。如果哪天改成 48kHz 采样、128ms 一桶，48000 × 0.128 = 6144 也整除。但要是用了 100ms 桶配 48kHz，一桶 4800 个采样，依然整除。真正的坑在非整数的桶长，比如 33ms 一桶配 44.1kHz，一桶 1455.3 个采样，桶边界落在采样点中间，切的时候会丢半个采样，累计起来又成了新的漂移源。所以桶长我坚持选能和采样率整除的整数毫秒。
这条链路上的硬参数都列在这里，动一个就要重算其余几个：
| 参数 | 取值 | 说明 |
|---|---|---|
| SAMPLE_RATE | 44100 | 音频采样率，每秒采样点数 |
| BUCKET_MS | 100 | 桶长，必须取整数毫秒 |
| SAMPLES_PER_BUCKET | 4410 | 每桶采样数，44100 × 0.1 正好整除 |
| 吸附误差 | ±50ms | 四舍五入到最近桶边界的最大偏差 |
| scale 夹断区间 | 0.99~1.01 | 超出区间放弃纠偏，只做吸附 |
| 18 分钟总轨 | 10800 桶 | 1080000ms 除以 100ms |
采样率、桶长、总轨长这三个数看着是常识，真出事都出在他们身上。我最怕的就是后来人把桶长改成 96ms 图个整齐——44100 × 0.096 = 4233.6，不整除，桶边界掉进采样点中间，前期对齐全对，十八分钟后又开始漂，而且这种漂移查都没法查，因为每处都只偏半个采样。
分桶和能量提取
把采样缓冲切进桶，每个桶算峰值和 RMS。峰值决定波形柱的顶点，RMS 决定"这里到底有没有人说话"——峰值会被一个单独的爆音拉高，RMS 更接近人耳的响度感知。做字幕对齐，我只信 RMS。
functionbucketize(samples:Float32Array):WaveBucket[]{constbuckets:WaveBucket[]=[]constcount=Math.floor(samples.length/SAMPLES_PER_BUCKET)for(leti=0;i<count;i++){conststart=i*SAMPLES_PER_BUCKETletpeak=0letsumSq=0for(letj=0;j<SAMPLES_PER_BUCKET;j++){constv=samples[start+j]constabs=Math.abs(v)if(abs>peak)peak=abs sumSq+=v*v}buckets.push({index:i,startMs:i*BUCKET_MS,endMs:(i+1)*BUCKET_MS,peak,rms:Math.sqrt(sumSq/SAMPLES_PER_BUCKET)})}returnbuckets}内层那个for循环 4410 次，一条 18 分钟的轨有 10800 个桶，全串行跑一遍要遍历 4700 万个采样点。在 UI 线程里做，界面会卡。所以分桶我放进了异步任务，切成块让出主线程。
桶切好了，接下来把字幕时间戳往这层网格上贴，吸附和纠偏都在这步。
对齐的核心就一个函数：把一个毫秒时间戳四舍五入到最近的桶边界。
functionsnapToBucket(ms:number):number{constidx=Math.round(ms/BUCKET_MS)returnidx*BUCKET_MS}functionalignCue(cue:TranscriptCue):TranscriptCue{constsnappedStart=snapToBucket(cue.startMs)constsnappedEnd=snapToBucket(cue.endMs)return{...cue,startMs:snappedStart,endMs:Math.max(snappedEnd,snappedStart+BUCKET_MS)// 至少占一个桶，避免空字幕}}Math.round四舍五入把吸附误差控制在 50ms 内，人耳对这个量级的偏差基本无感，字幕和声音就算对齐了。但光吸附还不够，前面说的是累积漂移——如果字幕整体比声音慢了三秒，每个 cue 吸附到最近的桶，得到的还是一个整体慢三秒的字幕。吸附解决的是"网格对齐"，不是"速率对齐"。
速率对齐要另外做一次线性纠偏。做法是找两个锚点：音频开头静音后的第一声（起点锚），和结尾音乐前的最后一句（终点锚），用转录引擎标出这两处的时间，和波形桶对应的时间比，算出一个缩放系数。
interfaceDriftCorrection{scale:number// 字幕时间 -> 波形时间的缩放系数offsetMs:number// 平移量}functioncomputeDrift(transAnchor:{start:number,end:number},// 转录引擎给出的锚点waveAnchor:{start:number,end:number}// 波形桶里测出的真实锚点):DriftCorrection{consttransLen=transAnchor.end-transAnchor.startconstwaveLen=waveAnchor.end-waveAnchor.startconstscale=waveLen/transLenconstoffsetMs=waveAnchor.start-transAnchor.start*scalereturn{scale,offsetMs}}scale理想情况是 1.0。EP.028 那次算出来是 1.00028，看着几乎没差，乘到 18 分钟（1080000ms）上就是 302ms 的漂移，和我在 08:24 观察到的那段差量对得上。找到这个系数之后，字幕时间戳先乘 scale 再平移 offset，然后再做桶吸附，两步一起做，漂移和网格误差一起消掉。
锚点不是手工填的数，两头各自从数据里提。buildTimeline里引用的anchorFromCues和anchorFromBuckets长这样：
functionanchorFromCues(cues:TranscriptCue[]):{start:number,end:number}{// 起点锚：第一条非空 cue 的起点；终点锚：最后一条非空 cue 的终点constvalid=cues.filter(c=>c.text.trim().length>0)if(valid.length===0){return{start:0,end:0}}return{start:valid[0].startMs,end:valid[valid.length-1].endMs}}functionanchorFromBuckets(buckets:WaveBucket[]):{start:number,end:number}{// 起点锚：第一个 RMS 超过静音阈值的桶；终点锚：最后一个超阈值的桶constSILENCE=0.02letstart=-1letend=-1for(leti=0;i<buckets.length;i++){if(buckets[i].rms>SILENCE){if(start<0)start=buckets[i].startMs end=buckets[i].endMs}}return{start:start<0?0:start,end:end<0?0:end}}functionapplyDrift(cue:TranscriptCue,d:DriftCorrection):TranscriptCue{return{...cue,startMs:cue.startMs*d.scale+d.offsetMs,endMs:cue.endMs*d.scale+d.offsetMs}}静音阈值 0.02 是看着 EP.028 的 RMS 分布定的：人声段基本在 0.05 以上，底噪在 0.01 以下，中间空着一大段，阈值取 0.02 还是 0.03 结果都一样。真正要小心的是终点锚——如果结尾音乐起得早，anchorFromBuckets会把音乐的尾声也当成人声锚点，终点偏晚，scale 被压低，字幕整体变快。这种情况没有自动解法，只能人工确认，所以面板里这两个锚点值是直接展示出来的，改之前看得见。
异步解码和失败分支
分桶的输入是解码后的 PCM 采样，解码这一步在@ohos.media里做。解码会失败——文件损坏、编码格式不认识、时长对不上，都得接住。
import{media}from'@kit.MediaKit'asyncfunctiondecodeToPcm(uri:string):Promise<Float32Array>{try{constavPlayer=awaitmedia.createAVPlayer()// ... 设置 fdSrc、prepare、seek 到 0，这里略去初始化细节constsamples=newFloat32Array(0)// 示意：实际从解码回调里累积 PCMreturnsamples}catch(e){// 解码失败不能静默吞掉，得让上层知道这条轨坏了thrownewError(`decode${uri}failed:${e}`)}}上层接住这个异常时的处理：单条轨解码失败，把那条轨标记成"无波形"，字幕对齐降级成只靠转录时间戳，不做桶吸附——因为吸附的参照物（波形桶）没了。三轨里 MUSIC 轨解码失败最常见，它是片尾导入的一段素材，偶尔格式不标准。
asyncfunctionbuildTimeline(uri:string,cues:TranscriptCue[]):Promise<AlignedTimeline>{letbuckets:WaveBucket[]=[]try{constsamples=awaitdecodeToPcm(uri)buckets=bucketize(samples)}catch(e){console.warn(`track${uri}decode failed, align by transcript only:${e}`)buckets=[]// 降级：没有波形，字幕退回原始时间戳}if(buckets.length===0){return{cues:cues.map(c=>({...c,aligned:false})),drift:null}}// 正常路径：锚点 -> 纠偏 -> 吸附constdrift=computeDrift(anchorFromCues(cues),anchorFromBuckets(buckets))constaligned=cues.map(c=>alignCue(applyDrift(c,drift)))return{cues:aligned,drift}}降级分支很重要：没有波形的时候，字幕依然要能显示，只是精度退回转录工具的原始水平。用户看到的是"字幕略微不准"，而不是一片空白，这比直接不显示体面得多。
把整条链路按时间顺一遍，每一步数据长什么样：
解码 → 一条 Float32Array 的 PCM 采样，44.1kHz，18 分钟约 4700 万个点 → 分桶 → 10800 个 WaveBucket，每桶 4410 个采样压成 peak/rms 两个数 → 提锚点 → cue 侧拿到 12.4s 和 1074.2s，桶侧拿到 12.7s 和 1074.5s → 纠偏 → scale 1.00028、offset -3.5ms，乘到尾部正好消掉 302ms 漂移 → 吸附 → 每条 cue 的时间戳归到 100ms 网格，误差锁在 ±50ms → 上屏 → 播放头停在桶 5040，字幕取吸附后 startMs 落在 504000ms 到 504100ms 之间的那一条。
每一步只做一件事，数据形态也从"采样点"一步步退化成"桶索引"。退到最后一层，界面里就只剩查表，没有计算——这也是这套对齐敢放在主线程里调用的原因。降级路径不走这条链：解码一失败，buckets 是空数组，buildTimeline直接返回，cue 带着转录工具的原始时间戳上屏，精度退回出厂水平，但字幕一行不少。
目录树和落地
模块结构：
entry/src/main/ets/ ├── pages/ │ └── Index.ets # 剪辑台 UI：素材篮 + 多轨时间线 + 智能文稿 + 声道条 ├── service/ │ ├── WaveBucket.ets # 分桶 + 峰值/RMS 提取 │ ├── CueAligner.ets # 吸附、纠偏、对齐主流程 │ └── AudioDecoder.ets # 封装 @ohos.media 解码 + 失败降级 └── model/ └── AlignTypes.ets # WaveBucket / TranscriptCue / DriftCorrection对齐完之后，字幕 cue 和波形桶之间是强绑定的：播放头在桶 5040 处，字幕就显示吸附到 5040×100ms = 8 分 24 秒的那句。拖播放头的时候，文稿区跟着桶索引走，而不是跟着原始毫秒走，这样不管怎么拖，两者永远在同一根时间轴上。
边界必须说死：这套对齐依赖两个锚点的准确度，如果音频前段有大段静音、或者转录引擎把开头的人声漏掉了，锚点会选偏，纠偏系数跟着错，字幕反而比不纠偏更歪。所以computeDrift算出来的 scale 我加了夹断：超出 0.99~1.01 区间就放弃纠偏，只做吸附，宁可留一点小漂移也不做错误的线性拉伸。另外解码整条 18 分钟的 PCM 会占不少内存——44100×4 字节×1080 秒约 190MB，所以分桶是按块流式做的，解完一块丢一块，别一次性把整轨 PCM 全部驻留内存，低端设备上会直接 OOM。
