向CALayer添加带透明度动画的多个CATextLayer时部分字幕(常首行)随机不显示
字幕随机不显示的核心排查方向
从你贴出的实现逻辑来看,随机丢字、首行字幕高频不显示的问题,全部来自Core Animation时间机制和图层配置的逻辑冲突,对应可直接定位的问题点如下:
- 动画填充模式与初始属性的逻辑冲突
当前代码中设置opacityAnimation.fillMode = .removed,同时搭配isRemovedOnCompletion = false,这个组合无法支撑字幕在时间轴上的稳定渲染。fillMode = .removed的规则是:动画不在自身时间区间内的部分,完全不向图层提供任何属性渲染值。结合你给textLayer设置的初始opacity = 0的属性,意味着在动画beginTime触发之前,图层永远保持透明度0的状态。
首行字幕的beginTime为0,刚好卡在整个视频时间轴的起点,没有任何时间缓冲窗口。渲染管线初始化阶段,Core Animation首次同步图层树时只要存在1帧的时间延迟,取到的第一帧画面里字幕就会保持全透明,直接表现为不显示。
正确配置需要把fillMode改为.both:让动画在开始前自动应用第一帧的属性值,结束后自动保持最后一帧的属性值,才能保证时间轴偏移时字幕不会异常消失。 - 动画时间基准匹配错误
当前代码直接把字幕的startTime赋值给动画的beginTime,没有做时间坐标转换。CAAnimation的beginTime是相对于所属图层的本地时间轴的坐标值,不是视频的绝对时间。直接传绝对秒数很容易出现时间偏移,尤其是时间轴起点位置的动画,一旦偏移到渲染范围外,就会直接不显示。
正确的赋值逻辑需要通过CALayer的坐标转换方法,把视频的绝对字幕时间转换为图层本地时间后,再赋值给beginTime,保证动画时间和视频渲染时间完全对齐。 - 离屏渲染场景下的栅格化配置错误
当前代码设置textLayer.shouldRasterize = true,同时把rasterizationScale取为UIScreen.main.scale,这两个配置在视频离屏渲染场景下极易触发随机渲染异常:- 视频烧录是无界面离屏渲染流程,和屏幕显示完全无关。
UIScreen.main.scale在无渲染窗口的环境、非移动端环境下获取到的Scale值完全不符合视频像素精度要求,会导致栅格化的文本位图模糊; - 图层栅格化是异步流程,当图层刚被加入图层树、还没完成位图栅格化时就被提交渲染,会直接输出透明像素,表现为随机不显示。这类问题在图层数量多、首次提交渲染帧中出现概率极高。
针对视频字幕渲染场景,完全不需要开启shouldRasterize,把rasterizationScale设为视频本身的像素宽度/逻辑宽度值,关闭栅格化流程,即可避免异步渲染带来的丢字问题。
- 视频烧录是无界面离屏渲染流程,和屏幕显示完全无关。
- 关键帧动画的取值适配问题
当前设置的透明度关键帧值为[0.2, 1, 1, 1, 1],对应keyTimes为[0, 0.2, 0.5, 0.8, 1]。这里的初始透明度值0.2本身不是全透明,搭配之前提到的fillMode逻辑缺陷,在存在时间同步偏差的情况下,很容易因为首帧取值异常导致字幕半透明甚至完全看不见的问题。可以把淡入的初始值调整为0,和keyTimes的时间点匹配,保证淡入逻辑正常生效。
完成上述修正后,可以在渲染每帧画面时,打印对应时间点上每个textLayer的实际opacity值,确认动画是否正确命中时间轴,即可彻底解决随机丢字的问题。
内容的提问来源于stack exchange,提问作者jmrueda
相关产品推荐
相关产品推荐

