Skip to content

UIScreen:referencedisplaymodestatuschange 事件 ​

referencedisplaymodestatuschange 事件在屏幕的参考显示模式的状态变了时派发。

语法 ​

screen.addEventListener('referencedisplaymodestatuschange', (event) => { })

事件对象 ​

Event。type 是 'referencedisplaymodestatuschange',target 是这块屏幕。事件对象不带新的值,在回调里读屏幕的属性。不能取消,event.cancelable 是 false。

什么时候派发 ​

referenceDisplayModeStatus 变了时派发:用户在系统设置里打开或关闭参考显示模式,或者设备过热、电量不足让它暂时做不到准确显示。不支持参考显示模式的屏幕不会派发。未在模拟器验证。

  • 回调不是在变化的那一刻同步执行,而是稍后执行,见运行时怎么工作。
  • 没有监听器时没有开销。

示例 ​

js
application.addEventListener('sceneconnect', (e) => {
  const screen = e.scene.screen;
  screen.addEventListener('referencedisplaymodestatuschange', () => {
    console.log(screen.referenceDisplayModeStatus, screen.potentialEDRHeadroom);
  });
});

效果:状态变了时,输出新的状态和最多能有的亮度余量。未在模拟器验证。

对应的 iOS API ​

UIScreenReferenceDisplayModeStatusDidChangeNotification。

参见 ​