/**
|
* 通用预加载素材描述。
|
*
|
* 仅支持 `image` 与 `font`——微信 `wx.preloadAssets` 目前只支持这两类，
|
* **不支持视频**（视频无法通过该 API 预热，转场视频仅能预热其封面图）。
|
*/
|
export type PreloadAsset = { type: 'image' | 'font'; src: string };
|
|
/** 判断当前是否为微信小程序环境。 */
|
const isWeapp = (): boolean => process.env.TARO_ENV === 'weapp';
|
|
/**
|
* 通用预加载方法：图片、字体统一走 `wx.preloadAssets` 为视图层预热媒体资源。
|
*
|
* ## 特性
|
* - 仅在微信小程序环境执行；非 weapp / 低版本（无 `wx.preloadAssets`）静默跳过。
|
* - image / font 合批调用一次 `wx.preloadAssets`，组件仍用同一 CDN URL，命中缓存即秒开。
|
* - **预加载失败不报错**：整体 try/catch + `fail` 空回调兜底。
|
*
|
* 参考：https://developers.weixin.qq.com/miniprogram/dev/api/base/performance/wx.preloadAssets.html
|
* （基础库 2.22.1+ 支持，功能描述：为视图层预加载媒体资源文件，目前支持 font、image）
|
*
|
* @param assets 待预加载素材列表
|
*/
|
export const preloadAssets = (assets: PreloadAsset[]): void => {
|
try {
|
if (!isWeapp() || !Array.isArray(assets) || assets.length === 0) {
|
return;
|
}
|
// @ts-ignore 微信基础库 2.22.1+ 能力，低版本走 typeof 兜底跳过
|
if (typeof wx === 'undefined' || typeof wx.preloadAssets !== 'function') {
|
return;
|
}
|
|
const data = assets
|
.filter((asset) => asset && asset.src && (asset.type === 'image' || asset.type === 'font'))
|
.map((asset) => ({ type: asset.type, src: asset.src }));
|
|
if (data.length === 0) {
|
return;
|
}
|
|
// @ts-ignore
|
wx.preloadAssets({
|
data,
|
fail: () => { /* 预加载失败不报错，静默忽略 */ },
|
});
|
} catch (e) {
|
console.error('[preloadAssets] 预加载素材异常：', e);
|
// 兜底：绝不抛出
|
}
|
};
|
|
export default preloadAssets;
|
