小米分屏功能适配说明-APP开发

小米分屏功能适配说明

1. 前言

从 7.0 开始，Android 加入了新的特性 Multi-Window，以支持同时显示多个应用，根据不同场景及设备，细分为以下三种：

Split-Screen Mode，即分屏，用于手机和平板
Picture-in-Picture Mode，即画中画，用于电视端（Android N）及移动端（Android O）
Freeform Mode，自由模式，用于在更大尺寸的设备上自由缩放应用窗口

可以看到，分屏是 Multi-Window Mode 的其中一种，用于手机等移动设备。MIUI 从 MIUI 9 开始支持分屏，基于 Android 7.0 优化，因此开发者不用针对 MIUI 做重复的适配工作。

2. MIUI 分屏的表现

默认将窗口一分二，支持调整窗口大小。
支持横屏
支持主应用始终在前台
对于折叠屏设备，在屏幕展开状态下，分屏模式为左右分屏，而且宽度支持多档位调节

3. 分屏对开发者的好处是

如前所述，Android 7.0 的分屏允许某个应用始终可见，MIUI 会在这个基础上做更多的交互优化，以符合用户的预期。在这个背景下，分屏对于开发者来说有以下好处：

可能提升使用时长：由于应用始终可见，主流程不会被打断，有助于提升使用时长。
可能提升日均使用次数：使用分屏后，消费长内容（如长视频）的成本变低了，用户不用想着留一整段时间，也有助于提升使用次数。

随着 Android 7.0 的设备越来越多，支持分屏带来的好处将会被不断放大。加之 Android 有标准的分屏接口，大大减少了开发者的适配工作量。

4. 如何支持分屏

支持分屏的方式非常简单，只需要声明一个属性。从 7.0 开始，Android 新增了一个 Activity 属性： resizeableActivity ，以声明该 Activity 是否支持多窗口显示。

android:resizeableActivity=["true" | "false"]

如果这个属性设为 true ，Activity 就可以在分屏模式下显示；设为 false ，Activity 则不会在分屏模式下显示，而是会占满整个屏幕。因此开发者可以根据具体场景，仅让部分 Activity 支持分屏。

若开发者没有为 Activity 声明该属性，Android 会根据应用的 targetSDKVersion 及 Activity 的 screenOrientation 属性来综合判断是否可以在分屏显示。关于判断的详细逻辑，可以参考官方文档 Configuring Your App for Multi-Window Mode 或者这篇更详细的博客 Android N7.0多窗口适配开发指导。

5. 如何进一步优化分屏模式

配置 resizeableActivity 的属性，是适配分屏的最简单方式，但如果想要提供更好的使用体验，需要开发者做一定优化工作。下面是我们了解到的一些案例（测试机型：Nexus 6 Andriod 7.1），开发者可以根据自己的业务需求，做不同程度的优化。

5.1. 减少不可滑动的页面/控件

在分屏过程中，屏幕高度只有原来的一半，如果有太多的控件不响应滑动事件，那么用户将无法上下滚动应用页面，甚至无法进行下一步操作。这类页面，最常见于Splash screen、登录注册页、音乐播放页、大图区域、弹窗等。

由于用户可以自由调整分屏的窗口比例，因此开发者只要减少了不可滑动的控件，分屏的可用性就会大大提高，是性价比非常高的优化方案。

5.2. 尽可能使用相对位置，以兼容多种窗口尺寸

分屏时，屏幕的高度和宽度会发生变化，因此在书写控件布局时，尽量使用相对位置，以避免窗口大小改变时，控件无法显示或显示不全。这也是一种性价比很高的优化方案，可以保证用户在分屏时能正常使用应用。

5.3. 注意多窗口下 Activity 的生命周期

视频、直播等类别的应用需要特别关注这一点。Android 7.0 在分屏时会同时运行两个应用，其中用户最后操作的那个应用会处于 Resumed 状态，另一个则会处于 Paused 状态。

这会带来一些问题，以视频应用为例，如果开发者在 onPaused 中处理视频的「暂停/播放」，那在分屏时，就会因为用户操作另一个应用，导致视频停止播放。因此我们建议开发者在 onStart/onStop 中处理视频的「暂停/播放」，或者特殊处理分屏时的 Paused 状态。详见官方文档 Multi-Window Lifecycle。

5.4. 处理 Configuration Changes

由于分屏过程中，允许用户调整窗口的大小，这就会导致 Configuration 的改变。Android 的默认处理方式是 relaunch 整个 Activity，从而出现页面闪一下的问题。如果想避免闪一下的问题，建议开发者自己处理 Configuration 的变化。

5.5. 给内容更多空间

分屏后，屏幕空间变得非常小了，为了给内容让出更多空间，应尽量减少常驻控件。一种解决办法是在浏览内容时，隐藏底部tab等常驻控件，用户回滚时再出现，以展示更多的内容。

5.6. 为分屏定制新的布局（动态布局）

动态布局指根据当前的窗口大小，重新调整页面的布局。这是一项锦上添花的优化项，开发者可以酌情考虑是否添加此优化。

6.FAQ

6.1. MIUI 分屏支持哪些设备

搭载 Android 7.0 或以上的 MIUI 手机及平板设备均支持分屏。MIUI 也将尝试将分屏移植至 Android 6.0。因此将有数千万的新老设备支持分屏。

6.2. 如何调试

MIUI 的分屏方案完全兼容 Android 7.0，因此可以在任意运行 Android 7.x 的设备上调试，无需为 MIUI 作特别处理。同时，以上提到的案例均能在任意 Android 7.x 设备复现。调试过程中，建议开启以下设置项：「开发者选项 > 强制将活动设为可调整大小」，然后重启手机，之后系统就会强制应用进入分屏模式，以方便开发者观察应用在分屏时的表现。

6.3. 分屏是个伪需求吗，用户为什么需要分屏

分屏不仅不是伪需求，而且会是一个大众需求。我们认为分屏最主流的使用场景是：一边看视频，一边做其它事情。用手机看视频，已经成为用户的主流场景，各大视频应用的日活人数、使用次数、使用时长都可以佐证这个观点。但使用手机看视频有很多痛点，比如会被 IM 消息打断、切换至后台视频会暂停等。这些痛点都可以通过分屏较好地解决，这也是分屏能成为大众需求的潜力。

但不可否认的是，分屏也会带来很多可用性问题，尽管系统已经做了很多优化工作，仍然需要各大开发者做进一步的优化，提高分屏模式的可用性。因此非常希望各位开发者能够支持该功能，为广大用户提供更好的使用体验。再次感谢所有开发者的支持与付出！