使用預先載入來減少載入時間

當您的內嵌內容位於不同的頁面上時,powerbi.preload API 可用來減少 Power BI 中內嵌內容的載入時間。 預先載入會使用最少的組態(僅限 typeembedURL),協助下載內嵌 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 () {
    ...
});