Rockchip平台双屏异显功能实现(基于Android13)

1. 异显实现方案

Rockchip SDK平台支持两种不同的异显方案：Android Presentation和Android Activity指定屏幕启动。

使用Android Presentation方案，需要在APP开发中调用相应接口以使指定视图（Presentation视图是一种特殊的对话框类型视图）在副屏上显示。

而使用Android Activity指定屏幕启动方案，APP在启动activity时可以使用display id参数直接在相应屏幕上显示，无需源代码便可以通过命令行或系统接口将第三方应用程序的activity投影到副屏上。

这两种方案主要区别在于：

Android Presentation方案需要独立开发activity并将需要显示的内容投影到副屏上，而Android Activity指定屏幕启动方案则可以不需要源代码，只需通过命令行或系统接口将第三方应用程序的activity投影到副屏上；
Android Presentation方案只有一个activity位于顶层，通过特殊的对话框将指定内容显示在副屏上，而Android Activity指定屏幕启动方案则是两个activity分别显示在主屏和副屏上。

1.1 Presentation

SDK已经提供了与该接口相关的演示demo，请进入development/samples/ApiDemos目录，使用mm编译生成相应的apk。安装apk后，点击App->Activity->Presentation选项即可进入Presentation调用界面。在该界面上，需要勾选副屏复选框选项，才能在副屏上显示相应的图片。

具体的代码位于以下路径：development/samples/ApiDemos/src/com/example/android/apis/app/PresentationActivity.java。

1.2 Android Activity 指定屏幕启动

在startActivity接口的参数中设置指定屏幕的display id，可以直接在指定屏幕上启动显示Activity。

Activity的多显示器支持需要设备支持<feature name="android.software.activities_on_secondary_displays" />。同时，应用程序或者Activity需要支持分屏属性，即在<application>或者<activity>标签下设置新的属性android:resizeableActivity="true"。这个属性在目标版本为Android N及以上时，android:resizeableActivity的默认值就是true。

ActivityOptions提供了两个新函数来支持多个显示器：

setLaunchDisplayId()：指定Activity在启动后应该显示在哪个显示器上。
getLaunchDisplayId()：返回操作组件当前启动的显示器。

使用示例：
在示例中，使用MediaRouter接口获取副屏的display id，同样地，也可以使用DisplayManager接口获取相应的display id。需要注意的是，此处只能打开其他包中的Activity，否则会提示：“App does not support launch on secondary displays”。

private void showSecondByActivity(Context context) {
    ActivityOptions options = ActivityOptions.makeBasic();
    MediaRouter mediaRouter = (MediaRouter) context.getSystemService(Context.MEDIA_ROUTER_SERVICE);
    MediaRouter.RouteInfo route = mediaRouter.getSelectedRoute(MediaRouter.ROUTE_TYPE_LIVE_VIDEO);
    if (route != null) {
        Display presentationDisplay = route.getPresentationDisplay();
        options.setLaunchDisplayId(presentationDisplay.getDisplayId());
        //options.
        Intent intent = new Intent("android.intent.action.MUSIC_PLAYER");
        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        startActivity(intent, options.toBundle());
    }
}

同时，adb shell也进行了扩展，以支持多个显示器。shell start命令现在可以用于启动操作组件，并指定目标显示器：

adb shell am start --display <display_id> <activity_name>

例如：adb shell am start --display 1 com.android.settings/.Settings（将Settings界面启动到指定的副屏）。

2. 副屏方向配置

RK3568 存在双屏和三屏的使用场景，在双屏场景下，副屏可以通过设置属性 persist.sys.rotation.einit-1（属性值为 0,1,2,3）来调整不同的方向。例如，设置命令为 setprop persist.sys.rotation.einit-1 1，可以将副屏旋转 90 度。设置完毕后，需要重启机器才能生效。

在三屏场景下，存在一个屏幕做为主屏，另外两个屏幕做为副屏。根据如下 dumpsys input 信息，系统中三个显示屏对应的 viewport 如下：

Viewport INTERNAL: displayId=0, uniqueId=local:0, port=0, orientation=0, logicalFrame=[0, 0, 1080, 1920], physicalFrame=[0, 0, 1080, 1920], deviceSize=[1080, 1920], isActive=[1]
Viewport EXTERNAL: displayId=0, uniqueId=local:1, port=1, orientation=1, logicalFrame=[0, 0, 1080, 1920], physicalFrame=[0, 0, 720, 1280], deviceSize=[720, 1280], isActive=[1]
Viewport EXTERNAL: displayId=0, uniqueId=local:2, port=2, orientation=0, logicalFrame=[0, 0, 1080, 1920], physicalFrame=[0, 0, 1440, 900], deviceSize=[1440, 900], isActive=[1]

两个副屏需要分别设置 persist.sys.rotation.einit-1 和 persist.sys.rotation.einit-2（属性值为 0,1,2,3）这两个属性来控制对应屏幕的方向。（这两个属性分别对应 port1 和 port2 两个副屏）。

此外，对于 RK3288、RK3399、PX30 和 RK3326 等芯片，副屏方向可以通过设置属性 persist.sys.rotation.einit（属性值为 0,1,2,3）来调整。例如，设置命令为 setprop persist.sys.rotation.einit 1，可以将副屏旋转 90 度。设置完毕后，同样需要重启机器才能生效。

3. 其他配置

3.1 支持输入法在副屏显示

在 device/rockchip/common/display_settings.xml 中设置相应屏幕 shouldShowIme 为 true，如下配置：

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
    <config identifier="0" />
    <display
        name="local:1"
        shouldShowIme="true"
        forcedDensity="240"/>
</display-settings>

3.2 副屏 DPI 设置

在 device/rockchip/common/display_settings.xml 中设置 forcedDensity，例如：

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
    <config identifier="0" />
    <display
        name="local:1"
        shouldShowIme="true"
        forcedDensity="240"/>
</display-settings>