Android N App分屏模式完全解析(下)

上篇中,介绍了什么是App分屏模式,以及如何设置我们的App来进入分屏模式。这次我们看一下,作为开发者,我们应该如何让自己的App进入分屏模式,当App进入分屏模式时,我们注意哪些问题。

简单地说,我认为除了保证分屏时App功能、性能正常以外,我们需要重点学习 如何在分屏模式下打开新的Activity 以及 如何实现跨App/Activity的拖拽功能

用分屏模式运行你的App

Android N中新增了一些方法来支持App的分屏模式。同时在分屏模式下,也禁用了App一些特性。

分屏模式下被禁用的特性

分屏模式的通知回调、查询App是否处于分屏状态

最新的Android N SDK中,Activity类中增加了下面的方法。

注意:画中画模式其实是一个特殊的分屏模式,如果mActivity.inPictureInPicture()返回true,那么mActivity.inMultiWindow()一定也是返回true

Fragment类中,同样增加了以上支持分屏模式的方法,例如Fragment.inMultiWindow()

如何进入画中画模式

调用Activity类的enterPictureInPicture()方法,可以使得我们的App进入画中画模式。如果运行的设备不支持画中画模式,调用这个方法将不会有任何效果。更多画中画模式的资料,请参考picture-in-picture

在分屏模式下打开新的Activity

当你打开一个新的Activity时,只需要给Intent添加Intent.FLAG_ACTIVITY_LAUNCH_TO_ADJACENT,系统将尝试将它设置为与当前的Activity共同以分屏的模式显示在屏幕上。

注意:这里只是尝试,但这不一定是100%生效的,前一篇博客里也说过,假如新打开的Activity的android:resizeableActivity属性设置为false,就会禁止分屏浏览这个Activity。所以系统只是尝试去以分屏模式打开一个新的Activity,如果条件不满足,将不会生效!此外,我实际用Android N Preview SDK实践的时候发现这个FLAG实际得值是FLAG_ACTIVITY_LAUNCH_ADJACENT,并非是FLAG_ACTIVITY_LAUNCH_TO_ADJACENT

当满足下面的条件,系统会让这两个Activity进入分屏模式:

此时,给新打开的Activity,设置 intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT | Intent.FLAG_ACTIVITY_NEW_TASK); 才会有效果。

two-acts

建议参考官方的Sample:MultiWindow Playground Sample

那么为何还需要添加FLAG_ACTIVITY_NEW_TASK?看一下官方解释:

注意:在同一个Activity返回栈中,打开一个新的Activity时,这个Activity将会继承上一个Activity所有和分屏模式有关的属性。如果你想要在一个独立的窗口以分屏模式打开一个新的Activity,那么必须新建一个Activity返回栈。

此外,如果你的设备支持自由模式(官方名字叫freeform,暂且就这么翻译它,其实我认为这算也是一种尺寸更自由的分屏模式,上一篇博客里提到过如果设备厂商支持用户可以自由改变Activity的尺寸,那么就相当于支持自由模式,这将比普通的分屏模式更加自由),打开一个Activity时,还可通过ActivityOptions.setLaunchBounds()来指定新的Activity的尺寸和在屏幕中的位置。同样,这个方法也需要你的Activity已经处于分屏模式时,调用它才会生效。

支持拖拽

上一篇博客里也提到过,现在我们可以实现在两个分屏模式的Activity之间拖动内容了。Android N Preview SDK中,View已经增加支持Activity之间拖动的API。具体的类和方法,可以参考N Preview SDK Reference,主要用到下面几个新的接口:

下面是我自己写的一个demo,实现了在分屏模式下,把一个Activity中ImageView中保存的内容到另外一个Activity中进行显示。实际应用中,可以还可以传递图片的url或者Bitmap对象。

drag-drop

上图是一个最基本的例子,实现了把MainActivity中的图片保存的内容,拖拽到SecondActivity中。实现步骤如下:

在MainActivity中,发起拖拽。

// 1.首先我们在分屏模式下,打开自己App中的SecondActivity
findViewById(R.id.launch_second_activity).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Intent intent = new Intent(MainActivity.this, SecondActivity.class);
                intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT | Intent.FLAG_ACTIVITY_NEW_TASK);
                startActivity(intent);
            }
        });
        
// 2.然后我们在MainActivity中发出拖拽事件
imageView = (ImageView) findViewById(R.id.img);
        /** 拖拽的发送方Activity和ImageView */
        imageView.setTag("I'm a ImageView from MainActivity");
        imageView.setOnTouchListener(new View.OnTouchListener() {

            public boolean onTouch(View view, MotionEvent motionEvent) {
                if (motionEvent.getAction() == MotionEvent.ACTION_DOWN) {
                    /** 构造一个ClipData,将需要传递的数据放在里面 */
                    ClipData.Item item = new ClipData.Item((CharSequence) view.getTag());
                    String[] mimeTypes = {ClipDescription.MIMETYPE_TEXT_PLAIN};
                    ClipData dragData = new ClipData(view.getTag().toString(), mimeTypes, item);
                    View.DragShadowBuilder shadow = new View.DragShadowBuilder(imageView);
                    /** startDragAndDrop是Android N SDK中的新方法,替代了以前的startDrag,flag需要设置为DRAG_FLAG_GLOBAL */
                    view.startDragAndDrop(dragData, shadow, null, View.DRAG_FLAG_GLOBAL);
                    return true;
                } else {
                    return false;
                }
            }
        });

SecondActivity中,接收这个拖拽的结果,在ACTION_DROP事件中,把结果显示出来。

dropedText = (TextView) findViewById(R.id.text_drop);
        dropedText.setOnDragListener(new View.OnDragListener() {
            @Override
            public boolean onDrag(View view, DragEvent dragEvent) {
                switch (dragEvent.getAction()) {
                    case DragEvent.ACTION_DRAG_STARTED:
                        Log.d(TAG, "Action is DragEvent.ACTION_DRAG_STARTED");
                        break;

                    case DragEvent.ACTION_DRAG_ENTERED:
                        Log.d(TAG, "Action is DragEvent.ACTION_DRAG_ENTERED");
                        break;

                    case DragEvent.ACTION_DRAG_EXITED:
                        Log.d(TAG, "Action is DragEvent.ACTION_DRAG_EXITED");
                        break;

                    case DragEvent.ACTION_DRAG_LOCATION:
                        break;

                    case DragEvent.ACTION_DRAG_ENDED:
                        Log.d(TAG, "Action is DragEvent.ACTION_DRAG_ENDED");
                        break;

                    case DragEvent.ACTION_DROP:
                        Log.d(TAG, "ACTION_DROP event");
                        /** 3.在这里显示接收到的结果 */
                        dropedText.setText(dragEvent.getClipData().getItemAt(0).getText());
                        break;

                    default:
                        break;
                }

                return true;
            }
        });

这里实现的关键在新增加的startDragAndDrop方法,看下官方的API文档:

start-drag

清楚地提到了,发出的DragEvent能够被所有可见的View对象接收到,所以在分屏模式下,SecondActivity可以监听View的onDrag事件,于是我们监听它!

接着,我们看下DragEvent.ACTION_DROP事件发生的条件:

drop-event

当被拖拽的View的阴影进入到接收方View的坐标区域,如果此时用户松手,那么接收方View就可以接收到这个Drop事件。一目了然,我们通过拖拽ImageView到图上的灰色区域,松手,便可以触发DragEvent.ACTION_DROP,把数据传到SecondActivity中了。

其实还有更复杂的一些情况,需要调用requestDropPermissions,后续我再进一步实践一下。

这个demo的地址在这里,先分享出来,后面我再接着完善它。

在分屏模式下测试你的App

无论你是否将自己的App适配到了Android N,或者是支持分屏模式,都应该找个Android N的设备,来测试一下自己的App在分屏模式下会变成什么样。

设置你的测试设备

如果你有一台运行Android N的设备,它是默认支持分屏模式的。

如果你的App不是用Android N Preview SDK打包的

如果你的App是用低于Android N Preview SDK打包的,且你的Activity支持横竖屏切换。那么当用户在尝试使用分屏模式时,系统会强制将你的App进入分屏模式。(我在第一篇博客里提到过这个,Android N Preview的介绍视频中,很多Google家的App都可以进入分屏模式,但是打开它们的xml一看,其实targetSDKVersion = 23

因此,如果你的App/Activity支持横竖屏切换,那么你应该尝试一下让自己的App分屏,看看当系统强制改变你的App尺寸时,用户是否还可以接受这种体验。如果你的App/Activity不支持横竖屏切换,那么你可以确认一下,看看当尝试进入分屏时,你的App是不是仍然能够保持全屏模式。

如果你给App设置了支持分屏模式

如果你使用了Android N Preview SDK来开发自己的App,那么应该按照下面的要点检查一下自己的App。

这两点在上一篇博客中介绍过,让自己的App进入分屏模式有三种方法。第三种方法,就是在打开自己的App时,用手指从右下角的小方块向上滑动,这样也可以使得正在浏览的App进入分屏模式。这种方法目前属于实验性功能,正式版不一定保留。

这几项测试,其实主要强调的是,我们的App可以顺利的进入/退出分屏模式,且改变App的尺寸时,UI依然可以也非常顺滑。

这里我想多说一句,如果进入了分屏模式,要注意下App弹出的对话框,因为屏幕被两个App分成两块之后,对话框也是可以弹出两个的。这时对话框上的UI元素可能就会变得比较小了,如果我们的代码是写死的大小,例如对话框是一个WebView,就需要特别注意了,搞不好显示出来就缺了一块了,这里需要我们做好适配。

测试清单

关于功能、性能方面测试,还可以按照下面的操作来进行。

这几项测试,其实主要是说当App在分屏模式下运行时,仍然可以保持性能的稳定,不会Crash也不会OOM。

如果你给App设置了禁止分屏模式

如果你给App/Activity设置了android:resizableActivity="false",你应该试试当用户在Android N的设备上,尝试分屏浏览你的App时,它是否仍然能保持全屏模式。

以上就是参考Google最新的multi-window进行的实践,总结下,我认为有3点比较重要:

  1. 如何让自己的App/Activity顺利的进入和退出分屏模式,可以参考处理运行时改变这一章。
  2. 如何在分屏模式下打开新的Activity,可以参考Google官方的MultiWindow Playground Sample
  3. 如何实现跨App/Activity的拖拽功能,可以参考Drag and Drop这一章。

关于App分屏模式的学习就到这里了,欢迎大家一起交流。我们还发挥更多的想象力,比如是否可以利用跨应用拖拽实现更方便操作,更好的用户体验。