當您的內嵌內容位於不同的頁面上時,powerbi.preload API 可用來減少 Power BI 中內嵌內容的載入時間。 預先載入會使用最少的組態(僅限 type 和 embedURL),協助下載內嵌 Power BI 內容所需的腳本,,然後 您的使用者流覽至該頁面。 在顯示內嵌報表和儀錶板時,這會提供更快的體驗。 只有當 Power BI 內容位於 Web 應用程式的不同頁面上,時,才應該使用
注意
最佳做法是效能,建議您使用 啟動程式方法,而不是預先載入。
如何使用預先載入
powerbi.preload() 可用來下載必要的腳本,再內嵌您的內容。 瀏覽器會將這些腳本儲存在其快取中,讓初始呼叫 powerbi.embed() 更快。 若要使用預先載入,您必須提供Power BI的內嵌實體類型和基底 URL(內嵌 URL,而不需要任何特定的 URL 參數,例如 reportId 或 groupId)。
// Building the config object
let config = {
type: 'report',
embedUrl: 'https://app.powerbi.com/reportEmbed',
};
let element = powerbi.preload(config);
preload 事件會在預先載入完成時引發。
element.on('preloaded', function () {
...
});