plugin.preloadResourceVideo

我的收藏

使用限制

同一时间最多支持 5 个预取 Task

资源缓存有效期为 30 分钟，之后失效。

版本校验

video-player 和 plugin.preloadResourceVideo 只在抖音 23.8 及以上版本支持。

属性说明

属性名	类型	默认值	必填	说明	最低支持版本
album-id	string	无	是	原片 ID	短剧插件
episode-id	string	无	是	剧集 ID	短剧插件
cloud-type	number	无	是	使用cdn类型，1: 抖音云 2: 三方云。	短剧插件
version	string	无	是	废弃字段。为了兼容老版本，请传 1 。	短剧插件
size	number	无	是	预加载大小，单位 Byte，取值范围 0 ～ 1M	短剧插件
success	function		否	接口调用成功的回调函数	短剧插件
fail	function		否	接口调用失败的回调函数	短剧插件
complete	function		否	接口调用结束的回调函数	短剧插件

支持格式

抖音支持的视频首帧预加载封装格式和编码格式如下所示。

格式	iOS	Android
mp4	√	√
mpd	√	√
mov	√	√
m4v	X	X
3gp	X	X
avi	√	√
m3u8	X	X
flv	√	√
webm	X	X
mpegts	X	√
hls	X	X
dash	√	√

代码示例

index.ttml

index.js

index.json

<video-player 
  tt:if="{{playletshow}}" 
  albumId="{{albumId}}" 
  episodeId="{{episodeId}}" 
  id="{{id}}" 
  data-city="beijing" 
  cloud-type="{{cloudType}}" 
  version="{{version}}" 
  binderror="cptEventAssert" 
  bindplay="cptEventAssert"
>
</video-player>

Bug & Tip

•

解决锚点进入的首帧耗时问题：通过 query 获取 aid 和 eid 后，可在 onload 事件中调用此 API 实现当前页面视频资源的预缓存。

•

解决翻页的下页视频首帧耗时问题：翻页的时候，可以监听播放变化时长bindtimeupdate，距离结束还有一定时长，比如1min的时候，提前获取下一页的aid eid，然后调用该api，从而提前缓存下一页需要渲染的视频资源；