在 Wear 上退出全屏 Activity

用户可通过从左向右滑动来退出 Wear OS Activity。如果应用支持水平滚动(例如,包含地图的应用中提供的那种滚动),那么用户可通过导航到内容的边缘而后从左向右滑动来退出。

按电源按钮会让用户返回表盘主题。

请参阅以下相关资源:

滑动关闭手势

用户从左向右滑动即可关闭当前屏幕。因此,建议您利用以下资源:

此外,还建议不要让您的应用包含水平滑动手势。

Activity 关闭

Activity 自动支持滑动关闭。从左向右滑动 Activity 会使 Activity 关闭,并且应用会沿着返回栈逐层返回。

Fragment

您可以在 SwipeDismissFrameLayout 类中封装一个包含 Fragment 的视图,如下所示:

Kotlin

    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 android.support.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)
                }
    }
    

Java

    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 android.support.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 类取代了穿戴式设备支持库中的一个与其类似且已弃用的类。

水平可滚动视图

在某些情况下(如在包含的地图支持平移的视图中),界面不会阻止水平滑动。在这种情况下,有两种选择:

  • 如果返回栈较短,用户可通过按电源按钮来关闭应用并返回主屏幕(表盘主题)。
  • 如果您希望用户沿着返回栈逐层返回,可以将视图封装在一个支持边缘滑动的 SwipeDismissFrameLayout 对象中。当视图或其子视图从 canScrollHorizontally() 调用返回 true 时,系统会启用边缘滑动。借助边缘滑动,用户不仅可在视图中的任意位置滑动来关闭视图,而且还能从屏幕最左侧(目前设为屏幕宽度的 10%)滑动来关闭视图。

要将视图封装在 SwipeDismissFrameLayout 对象中,请查看以下示例:

布局文件的 XML

    <android.support.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." />
    </android.support.wear.widget.SwipeDismissFrameLayout>
    

代码段

Kotlin

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

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

Java

    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>
    

然后您就可以通知用户(在他们首次使用您的应用时),他们可通过按电源按钮来退出应用。

Wear 2.0 之前的关闭行为

在 Wear 2.0 之前,DismissOverlayView 类用于实现供用户用来关闭应用的长按。不应再使用 DismissOverlayView 类。

此外,不再建议通过长按来关闭应用。请勿实现用来关闭全屏 Activity(平移或沉浸式 Activity,如 Google 地图)的长按。

通过电源按钮关闭

按电源(硬件)按钮会发送电源按键事件。因此,您不能将电源按钮用作返回按钮或将其用于一般导航。

按电源按钮会让用户返回主屏幕(表盘主题)。有两种例外情况:

  • 如果用户正在使用 IME(输入法,例如手写识别屏幕),按该按钮会关闭 IME 并让用户返回应用。
  • 如果用户在表盘主题屏幕上,按硬件按钮会打开应用启动器。

请注意,按电源按钮时,Activity 类的 isFinishing() 方法不会返回 true(您也无法拦截按键事件)。