使用预加载减少加载时间

powerbi.preload API 用于在嵌入内容位于其他页面上时减少 Power BI 中嵌入内容的加载时间。 预加载使用最少的配置(仅 ),以帮助下载在 用户导航到该页面之前嵌入 Power BI 内容 所需的脚本。 这在显示嵌入式报表和仪表板时提供更快的体验。 仅当 Power BI 内容位于 Web 应用程序的其他页面上时,才应使用 预加载。

注意

作为性能的最佳做法,我们建议使用 启动方法 而不是预加载。

如何使用预加载

powerbi.preload() 用于在嵌入内容之前下载必要的脚本。 浏览器将这些脚本存储在其缓存中,从而更快地调用 powerbi.embed()。 若要使用预加载,必须为 Power BI 提供嵌入实体的类型和基 URL(嵌入 URL,而无需任何特定的 URL 参数,如 reportIdgroupId)。

// Building the config object
let config = {
    type: 'report',
    embedUrl: 'https://app.powerbi.com/reportEmbed',
};

let element = powerbi.preload(config);

预加载完成后,preload 事件将触发。

element.on('preloaded', function () {
    ...
});