退出 Wear 上的全屏活动

用户可以通过从左向右滑动来退出 Wear OS 活动。如果应用具有水平滚动，则用户可以通过导航到内容边缘，然后从左向右滑动来退出。按下电源按钮也会将用户返回到表盘。

滑动以关闭手势

用户从左向右滑动以关闭当前屏幕。因此，我们建议您使用以下方法

• 垂直布局
• 内容容器

我们还建议您的应用中不包含水平滑动手势。

关闭活动

活动自动支持滑动以关闭。从左向右滑动活动会导致活动关闭，并且应用沿 后退栈 导航。

关闭片段

要在片段中支持滑动以关闭，您必须将包含片段的视图包装在 SwipeDismissFrameLayout 类中。在决定是否使用片段时请考虑这一点。如以下示例所示，使用 SwipeDismissFrameLayout 类

class SwipeDismissFragment : Fragment() {
    private val callback = object : SwipeDismissFrameLayout.Callback() {
        override fun onSwipeStarted(layout: SwipeDismissFrameLayout) {
            // Optional
        }

        override fun onSwipeCanceled(layout: SwipeDismissFrameLayout) {
            // Optional
        }

        override fun onDismissed(layout: SwipeDismissFrameLayout) {
            // Code here for custom behavior, such as going up the
            // back stack and destroying the fragment but staying in the app.
        }
    }

    override fun onCreateView(
            inflater: LayoutInflater,
            container: ViewGroup?,
            savedInstanceState: Bundle?
    ): View =
            SwipeDismissFrameLayout(activity).apply {

                // If the fragment should fill the screen (optional), then in the layout file,
                // in the androidx.wear.widget.SwipeDismissFrameLayout element,
                // set the android:layout_width and android:layout_height attributes
                // to "match_parent".

                inflater.inflate(
                        R.layout.swipe_dismiss_frame_layout,
                        this,
                        false
                ).also { inflatedView ->
                    addView(inflatedView)
                }
                addCallback(callback)
            }
}

public class SwipeDismissFragment extends Fragment {
  private final Callback callback =
    new Callback() {
      @Override
        public void onSwipeStart() {
          // Optional
        }

        @Override
        public void onSwipeCancelled() {
          // Optional
        }

        @Override
        public void onDismissed(SwipeDismissFrameLayout layout) {
          // Code here for custom behavior, such as going up the
          // back stack and destroying the fragment but staying in the app.
        }
      };

  @Override
  public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    SwipeDismissFrameLayout swipeLayout = new SwipeDismissFrameLayout(getActivity());

    // If the fragment should fill the screen (optional), then in the layout file,
    // in the androidx.wear.widget.SwipeDismissFrameLayout element,
    // set the android:layout_width and android:layout_height attributes
    // to "match_parent".

    View inflatedView = inflater.inflate(R.layout.swipe_dismiss_frame_layout, swipeLayout, false);
    swipeLayout.addView(inflatedView);
    swipeLayout.addCallback(callback);

    return swipeLayout;
    }
}

水平可滚动视图

在某些情况下，例如在包含支持平移的地图的视图中，用户界面无法阻止水平滑动。在这种情况下，有两种选择。

• 如果返回栈较短，用户可以通过按电源按钮关闭应用并返回到手表表盘主屏幕。
• 如果希望用户向下遍历返回栈，则可以使用 SwipeDismissFrameLayout 对象包装视图，该对象支持边缘滑动。当视图或其子级从 canScrollHorizontally() 调用返回 true 时，将启用边缘滑动。边缘滑动允许用户通过从屏幕最左侧的 10% 滑动来关闭视图，而不是在视图中的任何位置。

以下示例显示了如何将视图包装在 SwipeDismissFrameLayout 对象中。

<androidx.wear.widget.SwipeDismissFrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/swipe_dismiss_root" >

    <TextView
        android:id="@+id/test_content"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:text="Swipe me to dismiss me." />
</androidx.wear.widget.SwipeDismissFrameLayout>

activity?.findViewById<SwipeDismissFrameLayout>(R.id.swipe_dismiss_root)?.apply {
    addCallback(object : SwipeDismissFrameLayout.Callback() {

        override fun onDismissed(layout: SwipeDismissFrameLayout) {
            layout.visibility = View.GONE
        }
    })
}

SwipeDismissFrameLayout testLayout =
    (SwipeDismissFrameLayout) activity.findViewById(R.id.swipe_dismiss_root);
testLayout.addCallback(new SwipeDismissFrameLayout.Callback() {
    @Override
    public void onDismissed(SwipeDismissFrameLayout layout) {
        layout.setVisibility(View.GONE);
    }
  }
);

不推荐：禁用滑动关闭

我们通常不建议禁用滑动关闭，因为用户期望通过滑动关闭任何屏幕。在特殊情况下，您可以在 样式资源 中扩展默认主题并将 android:windowSwipeToDismiss 属性设置为 false，如下面的代码示例所示。

<resources>
  <style name="AppTheme" parent="@android:style/Theme.DeviceDefault">
    <item name="android:windowSwipeToDismiss">false</item>
  </style>
</resources>

然后，您可以在用户首次使用您的应用时告知他们，他们可以通过按电源按钮退出应用。

使用电源按钮关闭

按下物理电源按钮会发送电源键事件。因此，您不能将电源按钮用作后退按钮或用于一般的导航。

按下电源按钮会将用户返回到手表表盘主屏幕。有两个例外情况。

• 如果用户位于输入法编辑器 (IME) 中，例如手写识别屏幕，则按下按钮会关闭 IME 并将用户返回到应用。
• 如果用户位于手表表盘，则按下硬件按钮会打开应用启动器。

注意，当按下电源按钮时， isFinishing() 方法（Activity 类）不会返回 true，并且您无法拦截按键事件。