data
一个描述了所有要预加载的资源详情的合集,它的 key 定义如下:
data
:类型 array
,array
内部每个 item 对应一个资源。每个 item 内的 key 定义如下
uri
:类型 string
,表示资源的 CDN 地址。type
:类型 string
,表示资源的类型,支持的资源类型定义如下
image
:图片资源(iOS 需要打开 Image 组件的 trailNewImage 开关才能预加载图片)video
:视频资源audio
:音频资源params
(可选):资源预加载的自定义控制参数,支持的参数如下
priority
(可选):仅用于 image
类型的资源。表示网络请求优先级。如果请求优先级为 high,那么在图片库预加载这些图片时,其他的图片的请求会被阻塞等待,可能导致其他图片的展示变慢。所以如果预加载的这些图片如果不是马上需要展示的,可以把优先级调低。支持的选项如下
high
:高优先级medium
:中优先级low
:低优先级,这是默认值cacheTarget
(可选):仅用于 image
类型的资源。表示资源保存的形式。支持的选项如下
disk
:资源预加载完成后保存于磁盘,这是默认值。bitmap
:资源预加载后解码成 bitmap 保存于内存。(** 注:现在 Android bitmap 缓存暂不能生效 **)preloadKey
:仅用于 video
, audio
类型的资源。表示标识该资源的唯一的 key。渲染 <view-engine> 组件时,需要为其指定这个 key,这样组件才能找到预加载的资源缓存。必选参数。size
(可选):仅用于 video
类型的资源。表示预加载的尺寸大小,默认值为 500 * 1024(字节)API 执行完成或失败后调用的回调函数。它的回参内部定义如下:
code
:类型 number
,状态码,它可能取值如下
0
:成功11001
:参数错误msg
:类型 string
,全局错误信息details
:类型 array
,里面每个 detail 表示一个资源的预加载状态详情,detail 内部定义如下
code
:类型 number
,状态码,它可能取值如下
0
:成功11001
:参数错误msg
:类型 string
,错误信息uri
:类型 string
,表示资源的 CDN 地址。type
:类型 string
,表示资源的类型,资源类型定义如下
image
:图片资源video
:视频资源audio
:音频资源无(undefined
)。
code
会返回 11001
错误码,并且在 msg
中有详细错误信息。native | web | ||
---|---|---|---|
Used to request the prefetch of resource. |
Tip: you can click/tap on a cell for more information.