Skip to content

UIWindowScene ​

UIWindowScene 表示 App 界面的一个实例,称为场景。App 的每个窗口都属于某个场景,场景决定这些窗口显示在哪块屏幕上、此刻在前台还是后台。

场景是界面的前提。窗口(UIWindow)要建在场景上才能显示,页面和视图又要放进窗口才能显示。没有场景时 App 的代码照常运行,但屏幕上显示不出任何东西。

场景由系统创建,也由系统销毁,App 不能自己创建。系统创建好一个场景后,在 application 上派发 sceneconnect 事件,事件对象的 scene 属性就是这个场景;收回时派发 scenedisconnect。场景接入之后也能从 application.scenes 读到它。

每个场景有一个会话 UISceneSession,从 session 读到。场景对象可能被系统销毁后重新创建,会话存在的时间比场景对象长,可以用它存这个场景的数据。

继承关系:EventTarget → NSObject → UIResponder → UIScene → UIWindowScene

UIScene 是场景的基类,本身没有可用的成员,也不能构造:new UIScene() 抛 TypeError: Illegal constructor: UIScene cannot be constructed。

场景被销毁之后界面怎么重建、数据存在哪里,见指南建窗口和处理场景。

构造函数 ​

不能用 new 创建。new UIWindowScene() 抛 TypeError: Illegal constructor: UIWindowScene is created by the runtime, not by new。拿到场景的途径只有两个:sceneconnect 事件的 e.scene,和 application.scenes。场景也不能被继承,见原生类:不能继承。

实例属性 ​

属性说明
activationState 只读这个场景此刻是否显示、能否交互
session 只读这个场景的会话:场景的持久身份
traitCollection 只读整个场景的外观特征,比如系统设置里是深色还是浅色
isFullScreen 只读场景是否占满整个屏幕
screen 只读这个场景显示在哪块屏幕上
effectiveGeometry 只读此刻的几何信息:界面的方向、是不是锁着
statusBarManager 只读状态栏此刻的样子
title多任务切换器的卡片上显示的标题
subtitle多任务切换器的卡片上显示的副标题

实例方法 ​

方法说明
openURL()让系统打开一个 URL:跳到 Safari、拨号、跳到别的 App
requestGeometryUpdateWithPreferences()请求把界面转到某个方向

事件 ​

事件什么时候派发
inactive这个场景即将失去活跃:即将进后台,或者被临时打断
background这个场景已经进入后台
foreground这个场景即将回到前台
active这个场景已经变为活跃,用户可以交互
traitchange场景的外观特征变了
geometrychange界面转了方向。当场派发,监听器在转屏动画里执行
  • 事件不能取消。回调不是在状态变化的那一刻同步执行,而是稍后执行,见运行时怎么工作。
  • 场景上也可以监听和派发自定义名字的事件,用法和普通的 EventTarget 一样。
  • 场景的接入和断开不在这张表里:它们是 application 上的 sceneconnect 和 scenedisconnect。

场景的数量 ​

一个 App 同时有几个场景,取决于设备:

设备场景数量
iPhone一个。连接了外接显示器时可能多一个
iPad用户可以给同一个 App 打开多个窗口,每个窗口是一个场景。各场景的界面和前后台状态互相独立

App 是否允许同时有多个场景,读 application.supportsMultipleScenes。iPad 上的多场景未在模拟器验证。

什么时候没有场景 ​

以下情况下 App 的代码在运行,但没有可用的场景:

  • App 刚启动,脚本顶层执行时。 系统在脚本执行完之后才创建场景,这时 application.scenes 是空数组。所以建界面的代码不能写在顶层,要写在 sceneconnect 的回调里。
  • 场景被系统销毁之后。 App 进入后台后,系统为了回收内存可以销毁场景,这时在 application 上派发 scenedisconnect。
  • 用户关掉了窗口。 在 iPad 上,用户可以从多任务界面关闭 App 的某个窗口,对应的场景被销毁。

后两种情况未在模拟器验证:验收过程中系统没有销毁过场景。

场景被销毁之后 ​

场景被销毁不等于 App 重新启动。App 的进程还在,JS 里的变量、数据、没完成的网络请求都还在。被销毁的只有这个场景和它上面的界面。

销毁之后依次发生这些事:

  1. 系统在 application 上派发 scenedisconnect,事件对象的 scene 是被销毁的那个场景。
  2. 运行时不再保管这个场景。如果 App 的代码也没有保存它,这个场景连同它的窗口、页面和所有视图都会被回收,内存还给系统。
  3. 用户回到 App 时,系统创建一个新的场景对象,再派发一次 sceneconnect。

新场景和旧场景是两个不同的对象。它们的 session 表示同一份界面:session.persistentIdentifier 相同,session.userInfo 里存的数据还在。以上过程来自运行时的代码和 iOS 的定义,未在模拟器验证。

如果 App 的代码把场景保存在了回调外面的变量里,或者挂在了 application 这类一直存在的对象上:

  • 旧场景不会被释放。 它的窗口、页面和所有视图也都留在内存里。
  • 旧场景已经不能用了。 屏幕上不再显示它的窗口。在它上面新建窗口也不会显示。读它的 activationState 得到 'unattached'。
  • 不会报错。 读写旧场景的属性不抛异常,所以这种错误不容易发现。

挂在 application 上的后果最重:application 在 App 运行期间一直存在,挂在它上面的场景永远不会被释放。场景每被销毁重建一次,就多留下一份。这几条未在模拟器验证。

场景的状态和 App 的状态 ​

前后台有两套读法和两套事件:

说的是谁读状态事件
场景级这一个场景scene.activationStatescene 上的 active / inactive / foreground / background
App 级所有场景合起来application.stateapplication 上的同名事件

只有一个场景时,两套事件成对出现。两套状态更新的时刻不同。同样是 inactive 事件,实测回调里读到的值:

事件回调里读到
scene 的 inactivescene.activationState 是 'foregroundInactive',已经是新值
application 的 inactiveapplication.state 是 'active',还是旧值

要在事件回调里判断「现在是什么状态」,读 scene.activationState。

同一个场景永远是同一个对象 ​

同一个场景,不管从哪里拿到,在 JS 里都是同一个对象,可以用 === 比较。所以挂在场景上的事件监听不会丢失。场景上也可以挂自定义属性,从别处读到的是同一份,见原生类:可以挂自定义属性。

示例 ​

监听场景的状态变化 ​

从空白 App 开始:拿到场景,在场景上建窗口和页面,然后监听场景的状态变化,每次变化在控制台输出一行。

js
application.addEventListener('sceneconnect', (e) => {
  const scene = e.scene;

  const win = new UIWindow(scene);
  const page = new UIViewController();
  page.view.backgroundColor = 'systemBackground';
  win.rootViewController = page;
  win.makeKeyAndVisible();

  for (const type of ['active', 'inactive', 'foreground', 'background']) {
    scene.addEventListener(type, (ev) => {
      console.log('场景事件:', ev.type, '| 状态:', scene.activationState);
    });
  }
});

效果

  • 屏幕上出现一个空白页面,底色是系统背景色(浅色模式下是白色)。
  • 用户按 Home 回到桌面,控制台依次输出 inactive、background 两条。
  • 用户再切回 App,控制台依次输出 foreground、active 两条。

第一条的完整内容是 场景事件: inactive | 状态: foregroundInactive(实测);其余三条里状态的值未在模拟器验证。inactive → background → foreground → active 这个顺序,在 application 的同名事件上实测过;场景事件的先后顺序未在模拟器验证。App 启动时,场景接入之后是否也会输出 foreground 和 active,未在模拟器验证。

这段代码没有作为一个整体在模拟器运行过。其中用到的每个 API 都在验收用例里运行过。

对应的 iOS API ​

ObjCJS
scene:willConnectToSession:options: / UISceneWillConnectNotificationapplication.addEventListener('sceneconnect', (e) => { e.scene })
sceneDidDisconnect: / UISceneDidDisconnectNotificationapplication.addEventListener('scenedisconnect', …)
sceneDidBecomeActive: / UISceneDidActivateNotificationscene.addEventListener('active', …)
sceneWillResignActive: / UISceneWillDeactivateNotificationscene.addEventListener('inactive', …)
sceneWillEnterForeground: / UISceneWillEnterForegroundNotificationscene.addEventListener('foreground', …)
sceneDidEnterBackground: / UISceneDidEnterBackgroundNotificationscene.addEventListener('background', …)
UIApplication.sharedApplication.connectedScenesapplication.scenes
scene.activationState == UISceneActivationStateForegroundActivescene.activationState === 'foregroundActive'
[[UIWindow alloc] initWithWindowScene:scene]new UIWindow(scene)
scene.fullScreenscene.isFullScreen
scene.title = @"收件箱"scene.title = '收件箱'
[scene openURL:url options:nil completionHandler:^(BOOL ok){}]await scene.openURL(url)
scene.session.persistentIdentifierscene.session.persistentIdentifier
scene.session.userInfo = @{ @"kind": @"mailDetail" }scene.session.userInfo = { kind: 'mailDetail' }

参见 ​

  • 建窗口和处理场景:推荐的做法、数据存在哪里、前后台、会话
  • UISceneSession:场景的会话
  • application:sceneconnect / scenedisconnect 事件、scenes 属性和 App 级的前后台事件
  • UIWindow:在场景上建窗口,让界面显示出来
  • 原生类:哪些类能构造、不能继承、能挂自定义属性