Android Prensentation API

Android的Presentation API 是一个基于Dialog的概念实现的，它允许应用在外部显示器（如外接屏幕、投影仪或者HDMI显示器、电视）上呈现内容。

Presentation API 的实现原理依赖于以下几个关键组件和概念：

• DisplayManager: Android中的DisplayManager服务负责管理设备上的不同显示器。通过DisplayManager，应用可以查询系统上的显示器列表，包括内置屏幕和外接屏幕。
• Display: Display类代表了一个显示器，它可以是设备的内置屏幕或者外接显示器。Display对象包含了有关显示器的各种信息，例如尺寸、分辨率、刷新率等。
• Context: 在Android中，Context是一个抽象类，它为应用提供了与系统服务交互的接口，包括启动Activity、发送广播、接收Intent等。Context也用于访问DisplayManager和创建Presentation对象。
• Presentation: Presentation类是Dialog的一个子类，它用于创建和管理在特定显示器上的内容。

Presentation的一个实例会关联一个Display对象，这意味着Presentation是针对这个特定显示器创建的。

• WindowManager: WindowManager是一个系统服务，它用于在屏幕上放置和管理窗口。

Presentation在特定Display上的展现是通过WindowManager来控制的。

Display

内容是如何呈现到不同外部显示器上的？例如一个支持Miracast协议的电视上。这里的关键是Display类。

在Android操作系统中，Display类代表着一个可以显示UI元素的屏幕。无论是设备的内置屏幕还是通过各种方法连接的外部屏幕（例如，通过HDMI，MHL，Miracast或WiDi等），Display类为它们提供了抽象表示。

当一个应用程序请求一个Display对象时，它通常通过DisplayManager来获取。DisplayManager返回的Display对象包含了与该显示器相关的信息，比如尺寸、分辨率、刷新率等信息。然后应用程序可以使用这些信息来调整其UI的布局和渲染。

在内部，Display对象与特定的资源和硬件组件关联，这些资源和组件由Android系统服务和底层驱动程序管理。Display提供的API抽象了这些细节，使得开发者可以在不同类型和配置的屏幕上呈现内容，而无需关心背后的复杂机制。

总之，我们只要提供用于呈现的内容（可以是一个View，一个内容布局），并指定要显示到哪个Display（通过DisplayManager获取），系统会处理好如何显示的细节。包括设备发现、设备连接、显示到设备等。

示例

如下是一个使用Prensentation API的简单示例。

DisplayManager displayManager = (DisplayManager) getSystemService(Context.DISPLAY_SERVICE);
Display[] displays = displayManager.getDisplays(DisplayManager.DISPLAY_CATEGORY_PRESENTATION);

if (displays.length > 0) {
    Display externalDisplay = displays[0];
    MySurfaceView contentView; // 要显示的内容可以绘制到这个SurfaceView上面
    Presentation presentation = new PresentationDemo(this, externalDisplay, contentView);
    presentation.show();
}

@TargetApi(17)
class PresentationDemo extends Presentation {
    private View mContentView;

    public PagePresentation(Context outerContext, Display display, View contentView) {
        super(outerContext, display);
        mContentView = contentView;
    }
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // Be sure to call the super class.
        super.onCreate(savedInstanceState);
        setContentView(mContentView);
    }
}