短视频已成为内容消费的核心场景,用户对“秒开、丝滑、沉浸”的体验阈值极高。本示例基于AVPlayer能力,实现短视频流畅切换,提炼出一套可复制的方案,帮助开发者交付极速、流畅的播放体验。
通过AVPlayer实现视频资源加载、播放、暂停、停止、退出操作,包含了静音播放、倍速设置和字幕挂载等功能,原理详情可参考《基于AVPlayer基础播控实践》。焦点管理、前后台感知、横竖屏切换和旋转感知等场景可参考《基于AVPlayer长视频播放实践》。
起播时延计时标准
以用户滑动屏幕后抬手、手指离屏的时刻为起点,以视频第二帧画面显示的时刻为终点。
转场动画时长建议设置为300ms。
在动画开始时使用预先准备的播放器起播,起播时延不超过230ms。
数据懒加载
冷启动时创建第一个播放器,播放当前视频时预加载下一个视频(预加载会增加用户流量消耗,需开发者自行决策)。使用XComponent的Surface类型动态渲染视频流,LazyForEach进行数据懒加载。
预加载异步在线视频
在轮播过程中,提前将下一个视频的AVPlayer切换至prepared状态。
预加载在线视频播放
滑动过程中,手指离开屏幕时,滑动动效开始播放。此时,可以调用AVPlayer的play方法进行播放。
图 1 流程图

使用视频播放框架AVPlayer可以将Audio/Video媒体资源(比如mp4/mp3/mkv/mpeg-ts等)转码为可供渲染的图像和可听见的音频模拟信号,并通过输出设备进行播放。
使用LazyForEach进行数据懒加载,设置cachedCount属性指定缓存数量,搭配组件复用能力。冷启动时创建并初始化AVPlayer到prepared阶段。
在滑块视图容器Swiper进行短视频滑动轮播过程中,会根据当前轮询滑动的窗口索引index到缓存池中找到对应的视频(prepared阶段),直接进行播放,从而提高切换性能。
图 2 异步加载示意图

在缓存池中有多个播放器实例,播放视频A时,提前预加载视频B并进入prepare状态;切换短视频时,可以立即播放已预加载的视频B,减少切换时间。手势上下滑动的时候,在动画开始时就更新当前索引值,最终实现短视频快速切换,综合起播时间≤230ms。
在Swiper组件中对播放组件AVPlayerView使用懒加载,确保每个视频有单独的Xcomponent、SurfaceID和AVPlayer播放器。
通过设置Swiper组件cachedCount属性确定缓存池大小,缓存池中的视频提前进入prepared状态;在动画开始的回调函数onAnimationStart()中就更新当前索引curIndex,而不是等动画结束更新。不使用默认的弹簧曲线(弹簧动效持续560毫秒),将曲线改为Curve.Ease,并将持续时间设置为300毫秒。
Swiper(this.swiperController) {
LazyForEach(new AVDataSource(SOURCES), (item: VideoData, index: number) => {
AVPlayerView({
curSource: item,
curIndex: this.curIndex,
index: index,
isPageShow: this.isPageShow
})
})
}
.cachedCount(3)
.vertical(true)
.loop(true)
.curve(Curve.Ease)
.duration(300)
.indicator(false)
.onAnimationStart((index: number, targetIndex: number, extraInfo: SwiperAnimationEvent) => {
Logger.info(TAG, `onAnimationStart index:${index} , targetIndex: ${targetIndex},extraInfo: ${extraInfo}`);
this.curIndex = targetIndex;
}) 使用@Watch监听当前索引curIndex值,对比当前索引curIndex和轮播索引index,仅播放索引相同的视频,缓存池其余视频均暂停。
async onIndexChange() {
if (this.curIndex !== this.index) {
this.avPlayerController.videoPause();
} else {
if (this.avPlayerController.isReady === true) {
this.avPlayerController.languageChange(AppStorage.get('currentLanguageType'))
this.avPlayerController.videoPlay();
}
}
}