首屏即时渲染
首屏即时渲染(Instant First-Frame Rendering,IFR)用于在再次打开页面时提前显示初始界面。页面资源就绪且有可用的首屏快照时,可以先显示固定标题、布局或占位内容,再等本次业务数据返回。
Warning
以下两种情况,即使开启 IFR,也无法立即显示主要内容。
- 打开页面时,渲染所需的资源还要异步加载。 例如,页面模板和样式仍在下载或读取。即使有首屏快照,Nova 也要等这些资源就绪后才能绘制页面。
- 首屏的主要内容依赖异步数据。 例如,页面需要先请求设备列表,或建立连接后才能显示实时画面。如果页面资源和首屏快照可用,Nova 可以先绘制初始界面,主要内容仍需等本次数据返回。若整页都依赖这些结果,开启 IFR 也无法提前展示有用的内容。
渲染原理
- 首次打开时,页面按正常流程加载资源并完成首次渲染。启用该能力后,支持首屏即时渲染的 App 可以保存这次渲染所用的初始数据,供后续打开时使用。这份数据称为首屏快照。
- 再次打开时,如果页面资源已加载且有可用的首屏快照,Nova 可以在本次页面初始化完成前先绘制初始界面。本次的初始数据就绪后,Nova 用它更新已显示的界面,后续请求和设备状态更新照常进行。没有可用快照时,页面按正常流程渲染。
哪些页面适合启用
例如,设备详情页可以先显示固定标题和分区,等拿到本次打开的设备状态和权限后再显示具体内容。若整页必须先通过授权或连接设备才有内容可展示,建议保持默认关闭。内容随设备、账号或路由参数变化时,等本次页面确认这些信息后再渲染相应部分。
启用与使用
首屏即时渲染默认关闭,仅用于 Nova 页面。确认目标 App 支持后,在页面配置中启用。
Ray 的 index.config.ts
原生小程序的页面 JSON
把固定内容保留在页面初始状态里,等本次请求返回后再显示设备数据。例如,设备控制按钮先置为不可用,取得设备状态和权限后再开放操作。会自动加载的网页或播放器,可以等本次页面取得地址或连接参数后再创建。
验证效果
在目标 App 上分别试用首次打开和退出后重进。重进时可用慢网验证哪些内容能先显示,以及主要操作何时可用。再从不同设备或不同参数的入口打开页面,确认提前显示的内容是否仍适用,数据返回后是否切换到本次设备的状态,播放器是否只在取得连接参数后启动。