手势导航和无边框体验  

在 Android 10 或更高版本中，导航手势以一种新模式的形式受到支持。这让您的应用能够使用整个屏幕，并提供更具沉浸感的显示体验。当用户从屏幕底部边缘向上滑动时，会转到 Android 主屏幕。当用户从左侧或右侧边缘向内滑动时，则会转到上一个屏幕。

借助这两个手势，您的应用可以充分利用屏幕底部的空间。但是，如果您的应用使用手势，或在系统手势区域放置了控件，则可能会与系统手势产生冲突。

本 Codelab 旨在向您介绍如何使用边衬区来避免手势冲突。此外，还会介绍如何针对需要放在手势区域的控件（如拖动手柄）使用 Gesture Exclusion API。

本 Codelab 旨在确保您的应用与系统手势兼容。对于不相关的概念，我们仅会略作介绍；对于不相关的代码，我们会予以提供，以便您复制和粘贴。

Universal Android Music Player (UAMP) 是一个使用 Kotlin 编写的示例 Android 版音乐播放器应用。您将为 UAMP 设置手势导航。

Universal Android Music Player (UAMP) 是一个使用 Kotlin 编写的示例 Android 版音乐播放器应用。此应用支持后台播放、音频焦点处理等功能，集成了Google 助理，并且可在 Wear、电视和 Auto 等多个平台上使用。

图 1：UAMP 中的流程

UAMP 从远程服务器加载音乐目录，可让用户浏览专辑和歌曲。用户点按一首歌曲，该歌曲便会通过连接的音响设备或头戴式耳机播放。此应用与系统手势不兼容。因此，当您在搭载 Android 10 或更高版本的设备上运行 UAMP 时，一开始会遇到一些问题。

如需获取示例应用，请从 GitHub 克隆代码库，然后切换到 starter 分支：

或者，您也可以下载 ZIP 文件形式的代码库，将其解压缩并在 Android Studio 中打开。

下载 ZIP 文件

请完成以下步骤：

如果您运行使用 API 级别 29 的新模拟器实例，手势导航可能默认处于未启用状态。如需启用手势导航，请依次选择 System settings > System > System Navigation > Gesture Navigation。

如果您在已启用手势导航的情况下运行应用并开始播放歌曲，则可能会注意到，播放器控件非常靠近主屏幕手势区域和返回手势区域。

在搭载 Android 10 或更高版本的设备上运行的应用可以提供无边框屏幕体验，无论设备启用了手势导航还是按钮导航，您都可以提供该体验。为了提供无边框体验，您的应用必须在透明的导航栏和状态栏后绘制。

若要让应用在导航栏下方呈现内容，您必须先将导航栏背景设为透明，然后将状态栏设为透明。这样，您的应用在显示时就可以占据屏幕的整个高度。

注意：对于搭载 Android 10 或更高版本的设备，强烈建议您实现无边框体验。对于搭载较低 Android 版本的设备，无边框体验是可选项，但建议您实现。

如要更改导航栏和状态栏的颜色，请执行以下操作：

查看以下 res/values-29/styles.xml 代码示例：

您还必须设置系统界面可见性标志，以告知系统在系统栏下方进行应用布局。您可以使用 View 类上的 systemUiVisibility API 设置各种标志。请执行以下步骤：

查看以下 MainActivity.kt 代码示例：

当您同时设置这些标志时，会告知系统您希望应用全屏显示，就像没有导航栏和状态栏一样。请执行以下步骤：

应用现在会无边框绘制，但存在应用控件冲突和重叠的易用性问题，这些问题必须得到解决。

WindowInsets 会告知应用系统界面会显示在内容上方的什么位置，以及在哪些屏幕区域系统手势的优先级高于应用内手势。边衬区用 Jetpack 中的 WindowInsets 类和 WindowInsetsCompat 类表示。强烈建议您使用 WindowInsetsCompat，以便在所有 API 级别中具有一致的行为。

以下边衬区 API 是最常用的边衬区类型：

使用边衬区移动应用控件

现在您已详细了解边衬区 API，可以按照以下步骤修正应用控件：

查看以下 NowPlayingFragment.kt 代码示例：

查看 activity_main.xml 的以下代码示例：

应用控件现在可与手势导航配合使用，但控件的移动幅度超出了预期。您必须解决此问题。

如果您在未关闭应用的情况下切换到其他应用或转到主屏幕，然后又返回应用，将注意到播放器控件每次都会向上移动。

这是因为每次 activity 启动时，应用都会触发 requestApplyInsets()。即使没有此调用，WindowInsets 也可以在视图的生命周期内随时多次分派。

当您首次为 activity_main.xml 中声明的应用底部内边距值增加边衬区底部值时，playerView 上的当前 InsetListener 会正常工作。不过，后续调用会继续为已更新视图的底部内边距增加边衬区底部值。

如需解决此问题，请执行以下步骤：

查看以下 NowPlayingFragment.kt 代码示例：

查看以下 NowPlayingFragment.kt 代码示例：

播放器的进度条过于靠近底部手势区域，这意味着用户在完成水平滑动时可能会意外触发主屏幕手势。进一步增加内边距可以解决这一问题，但也可能会导致播放器移动的高度超过所需高度。

使用边衬区可以解决手势冲突问题，但有时只需在设计上进行小幅改动，就可以完全避免手势冲突。如需重新设计播放器控件，以避免手势冲突，请执行以下步骤：

查看以下 fragment_nowplaying.xml 代码示例：

这类设计上的细微改动可以极大地改进您的应用。

播放器控件在主屏幕手势区域的手势冲突问题已得到解决。返回手势区域也可能会产生与应用控件的冲突。下面的屏幕截图展示了播放器进度条目前同时位于右侧和左侧返回手势区域：

SeekBar 会自动处理手势冲突。但您可能需要使用其他会触发手势冲突的界面组件。在这类情况下，您可以使用 Gesture Exclusion API 部分停用返回手势。

注意：Gesture Exclusion API 在每侧最多可以停用 200 dp 内的返回手势，仅在必要的情况下使用。如果您在视图或应用的部分区域中停用返回手势，则会与系统和其他应用不一致。

如要创建手势排除区域，请使用一组 rect 对象在视图上调用 setSystemGestureExclusionRects()。这些 rect 对象对应排除的矩形区域的坐标。必须在视图的 onLayout() 或 onDraw() 方法中完成此调用。为此，请执行以下步骤：

查看以下 MySeekBar.kt 代码示例：

查看以下 MySeekBar.kt 代码示例：

查看以下 MySeekBar.kt 代码示例：

查看以下 MySeekBar.kt 代码示例：

查看以下 MySeekBar.kt 代码示例：

查看以下 MySeekBar.kt 代码示例：

查看以下 fragment_nowplaying.xml 代码示例：

查看以下 NowPlayingFragment.kt 代码示例：

恭喜！您已了解如何避免和解决系统手势冲突问题！

当您延伸至屏幕边缘并使用边衬区将应用控件移出手势区域后，便为应用实现了全屏体验。您还了解了如何为应用控件停用系统返回手势。

现在您已了解让应用与系统手势兼容所需的主要步骤！