首屏即时渲染

首屏即时渲染(Instant First-Frame Rendering,IFR)用于在再次打开页面时提前显示初始界面。页面资源就绪且有可用的首屏快照时,可以先显示固定标题、布局或占位内容,再等本次业务数据返回。

Warning

以下两种情况,即使开启 IFR,也无法立即显示主要内容。

  • 打开页面时,渲染所需的资源还要异步加载。 例如,页面模板和样式仍在下载或读取。即使有首屏快照,Nova 也要等这些资源就绪后才能绘制页面。
  • 首屏的主要内容依赖异步数据。 例如,页面需要先请求设备列表,或建立连接后才能显示实时画面。如果页面资源和首屏快照可用,Nova 可以先绘制初始界面,主要内容仍需等本次数据返回。若整页都依赖这些结果,开启 IFR 也无法提前展示有用的内容。

渲染原理

  • 首次打开时,页面按正常流程加载资源并完成首次渲染。启用该能力后,支持首屏即时渲染的 App 可以保存这次渲染所用的初始数据,供后续打开时使用。这份数据称为首屏快照。
  • 再次打开时,如果页面资源已加载且有可用的首屏快照,Nova 可以在本次页面初始化完成前先绘制初始界面。本次的初始数据就绪后,Nova 用它更新已显示的界面,后续请求和设备状态更新照常进行。没有可用快照时,页面按正常流程渲染。

哪些页面适合启用

例如,设备详情页可以先显示固定标题和分区,等拿到本次打开的设备状态和权限后再显示具体内容。若整页必须先通过授权或连接设备才有内容可展示,建议保持默认关闭。内容随设备、账号或路由参数变化时,等本次页面确认这些信息后再渲染相应部分。

启用与使用

首屏即时渲染默认关闭,仅用于 Nova 页面。确认目标 App 支持后,在页面配置中启用。

Ray 的 index.config.ts

export default {
  renderer: 'nova',
  enableIFR: true,
};

原生小程序的页面 JSON

{
  "renderer": "nova",
  "enableIFR": true
}

把固定内容保留在页面初始状态里,等本次请求返回后再显示设备数据。例如,设备控制按钮先置为不可用,取得设备状态和权限后再开放操作。会自动加载的网页或播放器,可以等本次页面取得地址或连接参数后再创建。

验证效果

在目标 App 上分别试用首次打开和退出后重进。重进时可用慢网验证哪些内容能先显示,以及主要操作何时可用。再从不同设备或不同参数的入口打开页面,确认提前显示的内容是否仍适用,数据返回后是否切换到本次设备的状态,播放器是否只在取得连接参数后启动。