安卓投屏之createVirtualDisplay相关flags参数的实战介绍

原创 已于 2024-10-30 15:28:06 修改 · 1.9k 阅读 · 31 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#android #framework #车机车载 #投屏

于 2024-06-12 23:58:36 首次发布

背景：

在做android投屏时候，如果知识简单的是实现一下类似scrcpy同屏幕大小传递，其实根本不需要深入了解啥VirtualDisplay相关源码的探索。但是现在车载投屏，手机游戏小窗投屏等高大上功能出现后，这个时候就不得不认认真真学习一下创建VirtualDisplay相关的知识。在这里插入图片描述在这里插入图片描述

createVirtualDisplay方法介绍

/**
 * Creates a virtual display.
 *
 * @see #createVirtualDisplay(String, int, int, int, Surface, int,
 * VirtualDisplay.Callback, Handler)
 */
public VirtualDisplay createVirtualDisplay(@NonNull String name,
        int width, int height, int densityDpi, @Nullable Surface surface, int flags) {
    return createVirtualDisplay(name, width, height, densityDpi, surface, flags, null, null);
}

  /**
     * Creates a virtual display.
     * <p>
     * The content of a virtual display is rendered to a {@link Surface} provided
     * by the application.
     * </p><p>
     * The virtual display should be {@link VirtualDisplay#release released}
     * when no longer needed.  Because a virtual display renders to a surface
     * provided by the application, it will be released automatically when the
     * process terminates and all remaining windows on it will be forcibly removed.
     * </p><p>
     * The behavior of the virtual display depends on the flags that are provided
     * to this method.  By default, virtual displays are created to be private,
     * non-presentation and unsecure.  Permissions may be required to use certain flags.
     * </p><p>
     * As of {@link android.os.Build.VERSION_CODES#KITKAT_WATCH}, the surface may
     * be attached or detached dynamically using {@link VirtualDisplay#setSurface}.
     * Previously, the surface had to be non-null when {@link #createVirtualDisplay}
     * was called and could not be changed for the lifetime of the display.
     * </p><p>
     * Detaching the surface that backs a virtual display has a similar effect to
     * turning off the screen.
     * </p>
     *
     * @param name The name of the virtual display, must be non-empty.
     * @param width The width of the virtual display in pixels, must be greater than 0.
     * @param height The height of the virtual display in pixels, must be greater than 0.
     * @param densityDpi The density of the virtual display in dpi, must be greater than 0.
     * @param surface The surface to which the content of the virtual display should
     * be rendered, or null if there is none initially.
     * @param flags A combination of virtual display flags:
     * {@link #VIRTUAL_DISPLAY_FLAG_PUBLIC}, {@link #VIRTUAL_DISPLAY_FLAG_PRESENTATION},
     * {@link #VIRTUAL_DISPLAY_FLAG_SECURE}, {@link #VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY},
     * or {@link #VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR}.
     * @param callback Callback to call when the state of the {@link VirtualDisplay} changes
     * @param handler The handler on which the listener should be invoked, or null
     * if the listener should be invoked on the calling thread's looper.
     * @return The newly created virtual display, or null if the application could
     * not create the virtual display.
     *
     * @throws SecurityException if the caller does not have permission to create
     * a virtual display with the specified flags.
     */
    public VirtualDisplay createVirtualDisplay(@NonNull String name,
            int width, int height, int densityDpi, @Nullable Surface surface, int flags,
            @Nullable VirtualDisplay.Callback callback, @Nullable Handler handler) {
        final VirtualDisplayConfig.Builder builder = new VirtualDisplayConfig.Builder(name, width,
                height, densityDpi);
        builder.setFlags(flags);
        if (surface != null) {
            builder.setSurface(surface);
        }
        return createVirtualDisplay(null /* projection */, builder.build(), callback, handler);
    }

参数部分的英文注释已经有了：

name – 虚拟显示器的名称，必须非空。
width – 虚拟显示的宽度（以像素为单位），必须大于 0。
height – 虚拟显示器的高度（以像素为单位），必须大于 0。
densityDpi – 以 dpi 为单位的虚拟显示密度，必须大于 0。
surface – 虚拟显示器的内容应该被渲染到的表面，如果最初没有，则为 null。
flags – 虚拟显示标志的组合： VIRTUAL_DISPLAY_FLAG_PUBLIC 、 VIRTUAL_DISPLAY_FLAG_PRESENTATION 、 VIRTUAL_DISPLAY_FLAG_SECURE 、 VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY或VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR 。

本节最重要来讲解一下flags这个参数

Flags参数的详细讲解

frameworks/base/core/java/android/hardware/display/DisplayManager.java

 /**
     * Virtual display flag: Create a public display.
     *
     * <h3>Public virtual displays</h3>
     * <p>
     * When this flag is set, the virtual display is public.
     * </p><p>
     * A public virtual display behaves just like most any other display that is connected
     * to the system such as an external or wireless display.  Applications can open
     * windows on the display and the system may mirror the contents of other displays
     * onto it.
     * </p><p>
     * Creating a public virtual display that isn't restricted to own-content only implicitly
     * creates an auto-mirroring display. See {@link #VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR} for
     * restrictions on who is allowed to create an auto-mirroring display.
     * </p>
     *
     * <h3>Private virtual displays</h3>
     * <p>
     * When this flag is not set, the virtual display is private as defined by the
     * {@link Display#FLAG_PRIVATE} display flag.
     * </p>
     *
     * <p>
     * A private virtual display belongs to the application that created it.  Only the a owner of a
     * private virtual display and the apps that are already on that display are allowed to place
     * windows upon it.  The private virtual display also does not participate in display mirroring:
     * it will neither receive mirrored content from another display nor allow its own content to be
     * mirrored elsewhere.  More precisely, the only processes that are allowed to enumerate or
     * interact with the private display are those that have the same UID as the application that
     * originally created the private virtual display or as the activities that are already on that
     * display.
     * </p>
     *
     * @see #createVirtualDisplay
     * @see #VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY
     * @see #VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR
     */
    public static final int VIRTUAL_DISPLAY_FLAG_PUBLIC = 1 << 0;

    /**
     * Virtual display flag: Create a presentation display.
     *
     * <h3>Presentation virtual displays</h3>
     * <p>
     * When this flag is set, the virtual display is registered as a presentation
     * display in the {@link #DISPLAY_CATEGORY_PRESENTATION presentation display category}.
     * Applications may automatically project their content to presentation displays
     * to provide richer second screen experiences.
     * </p>
     *
     * <h3>Non-presentation virtual displays</h3>
     * <p>
     * When this flag is not set, the virtual display is not registered as a presentation
     * display.  Applications can still project their content on the display but they
     * will typically not do so automatically.  This option is appropriate for
     * more special-purpose displays.
     * </p>
     *
     * @see android.app.Presentation
     * @see #createVirtualDisplay
     * @see #DISPLAY_CATEGORY_PRESENTATION
     * @see Display#FLAG_PRESENTATION
     */
    public static final int VIRTUAL_DISPLAY_FLAG_PRESENTATION = 1 << 1;

    /**
     * Virtual display flag: Create a secure display.
     *
     * <h3>Secure virtual displays</h3>
     * <p>
     * When this flag is set, the virtual display is considered secure as defined
     * by the {@link Display#FLAG_SECURE} display flag.  The caller promises to take
     * reasonable measures, such as over-the-air encryption, to prevent the contents
     * of the display from being intercepted or recorded on a persistent medium.
     * </p><p>
     * Creating a secure virtual display requires the CAPTURE_SECURE_VIDEO_OUTPUT permission.
     * This permission is reserved for use by system components and is not available to
     * third-party applications.
     * </p>
     *
     * <h3>Non-secure virtual displays</h3>
     * <p>
     * When this flag is not set, the virtual display is considered unsecure.
     * The content of secure windows will be blanked if shown on this display.
     * </p>
     *
     * @see Display#FLAG_SECURE
     * @see #createVirtualDisplay
     */
    public static final int VIRTUAL_DISPLAY_FLAG_SECURE = 1 << 2;

    /**
     * Virtual display flag: Only show this display's own content; do not mirror
     * the content of another display.
     *
     * <p>
     * This flag is used in conjunction with {@link #VIRTUAL_DISPLAY_FLAG_PUBLIC}.
     * Ordinarily public virtual displays will automatically mirror the content of the
     * default display if they have no windows of their own.  When this flag is
     * specified, the virtual display will only ever show its own content and
     * will be blanked instead if it has no windows.
     * </p>
     *
     * <p>
     * This flag is mutually exclusive with {@link #VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR}.  If both
     * flags are specified then the own-content only behavior will be applied.
     * </p>
     *
     * <p>
     * This behavior of this flag is implied whenever neither {@link #VIRTUAL_DISPLAY_FLAG_PUBLIC}
     * nor {@link #VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR} have been set.  This flag is only required to
     * override the default behavior when creating a public display.
     * </p>
     *
     * @see #createVirtualDisplay
     */
    public static final int VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY = 1 << 3;


    /**
     * Virtual display flag: Allows content to be mirrored on private displays when no content is
     * being shown.
     *
     * <p>
     * This flag is mutually exclusive with {@link #VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY}.
     * If both flags are specified then the own-content only behavior will be applied.
     * </p>
     *
     * <p>
     * The behavior of this flag is implied whenever {@link #VIRTUAL_DISPLAY_FLAG_PUBLIC} is set
     * and {@link #VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY} has not been set.   This flag is only
     * required to override the default behavior when creating a private display.
     * </p>
     *
     * <p>
     * Creating an auto-mirroing virtual display requires the CAPTURE_VIDEO_OUTPUT
     * or CAPTURE_SECURE_VIDEO_OUTPUT permission.
     * These permissions are reserved for use by system components and are not available to
     * third-party applications.
     *
     * Alternatively, an appropriate {@link MediaProjection} may be used to create an
     * auto-mirroring virtual display.
     * </p>
     *
     * @see #createVirtualDisplay
     */
    public static final int VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR = 1 << 4;

1.VIRTUAL_DISPLAY_FLAG_PUBLIC

虚拟显示标志：创建公共显示。公共虚拟显示器
设置此标志时，虚拟显示是公开的。公共虚拟显示器的行为与大多数连接到系统的其他显示器（例如外部或无线显示器）的行为类似。 应用程序可以在显示器上打开窗口，系统可以将其他显示器的内容镜像到它上面。

创建一个public虚拟屏幕，并不仅限于只有自己内容（即自己Display没有内容时候就是黑的），其实隐式创建了一个mirror的Display。

当这个public的标志位没有被设置的话，那么虚拟屏幕就是被定义为private的display，简单说就是屏幕标志不是public就是另一个private。
private就代表私有的虚拟屏幕，这个屏幕只有屏幕创建的app和已经在屏幕上的app可以放置对应的窗口，private display一般是不参与镜像其他display。

2.VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY

虚拟显示标志：只显示该显示器本身的内容； 不要镜像另一个显示器的内容。
此标志与VIRTUAL_DISPLAY_FLAG_PUBLIC结合使用。 通常如果public display没有自己的窗口，它将自动镜像默认display的内容。 当这个标志被指定时，虚拟显示器将只显示它自己的内容，如果它没有窗口，啥也不显示一片空白。

这个flag如何和VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR同时被设置，那么就按VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY生效，即只能显示自己内容不能镜像其他display
当前这个VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY标志默认被设置的如果没有声明VIRTUAL_DISPLAY_FLAG_PUBLIC或VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR

3.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR

虚拟显示标志：当没有显示内容时，允许将内容镜像到private display上。在public的display上是默认有这个，如果没有声明public的那就代表是private display，这个时候想要镜像其他display内容就需要这个标志
这个一般要求有权限CAPTURE_VIDEO_OUTPUT 或 CAPTURE_SECURE_VIDEO_OUTPUT
当然也可以使用MediaProjection创建方式。

4.VIRTUAL_DISPLAY_FLAG_PRESENTATION

虚拟显示标志：创建演示显示。
当该标志被设置时，虚拟显示器被注册为presentation display category中的presentation display category ， 应用程序可以自动将其内容投影到演示显示以提供更丰富的第二屏幕体验。

在这里插入图片描述

更多framework实战干货，请关注下面“千里马学框架”

Android VirtualDisplay的用法和遇到的点击事件问题
caomeimaomao的博客
06-04 1万+
前言 最近在看Android 多屏相关的问题，初步接触到了DisplayManager的一些东西，发现网上资料较少，自己学习到的总结一下。
Android P 图形显示系统（四） Android VirtualDisplay解析
热门推荐
夕月风
08-29 1万+
文章目录Android VirtualDisplay解析ImageReader和VirtualDisplay使用示例ImageReader介绍VirtualDisplay的创建Native创建VirtualDisplay数据流分析ImageReader获取数据 Android VirtualDisplay解析 Android支持多个屏幕：主显，外显，和虚显，虚显就是我们要说的VirtualDisp...
安卓VirtualDisplay虚拟屏幕如何实现没有内容显示mirror屏幕内容（aosp13）
liaosongmao1的专栏
06-17 855
VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR设置1、会在DisplayContent的mApplySurfaceChangesTransaction中对Display是否有内容进行确定2、一旦涉及了Display的上有内容到无内容的变化会调用setDisplayLayerStack来重新设置layerStack3、在sf中layer会对layerStack进行匹配然后决定显示哪个Display本文章更多详细代码和资料需要购买课程获取。
【Android】VirtualDisplay创建流程及原理
林多
10-15 1万+
【代码】【Android】VirtualDisplay创建流程及原理。
createVirtualDisplay流程
helloworlddm的博客
12-03 5742
源码: @startuml WFDSession -> DisplayManager: createVirtualDisplay note left :Surface from native method DisplayManager ->DisplayManagerGlobal:createVirtualDisplay activate DisplayManagerGlobal Di...
关于MediaProjection的问题
masuning9999的博客
12-31 2043
写了一个app来投影，用了MediaProjection的createVirtualDisplay(String name, int width, int height, int dpi, int flags, Surface surface, VirtualDisplay.Callback callback, Handler handler),文档说明就一句话： Creates a Virtua
android 镜像投屏开发,Android 投屏实现纪要
weixin_33196646的博客
05-29 2503
在前文里介绍了Android -> Windows 多样化投屏方案这里记录具体的实现(一)屏幕截取MediaProjection/VirtualDisplay因为权限问题，不能直接创建镜像(VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR)类型的VirtualDisplay，需要通过MediaProjection 提示用户授权。MediaProjectionManager ...
tensorflow 使用flags定义命令行参数的方法
12-31
tf定义了tf.app.flags，用于支持接受命令行传递参数，相当于接受argv。 import tensorflow as tf #第一个是参数名称，第二个参数是默认值，第三个是参数描述 tf.app.flags.DEFINE_string('str_name', 'def_v_1',...
Android createVirtualDisplay mediacodec 投屏画面模糊原因分析
最新发布
08-06
在Android开发中，使用`createVirtualDisplay`结合`MediaCodec`实现投屏时，画面模糊通常源于分辨率设置、编码参数或渲染流程中的问题。以下我将逐步分析可能的原因，帮助您定位并解决问题。分析基于Android的Media...
从零开始用QT编写一个Android投屏、PC反控软件(五)--接收视频流并解码
光音的故事
02-18 1090
Android投屏、反控
安卓录屏使用VirtualDisplay虚拟屏幕；MediaRecorder，媒体录影机；
weixin_45877710的博客
04-11 2327
/虚拟屏幕通过MediaProjection获取，传入一系列传过来的参数。.absolutePath + “/” + “录屏文件” + “/”//设置视频存储地址，返回的文件夹下的命名为当前系统事件的文件。//如果确认为视频类型，设置根目录，绝对路径下的自定义文件夹中。//初始化完成，进入准备阶段，准备被使用。//不是音视频文件，不保存，无路径。//初始化Recorder录像机。//可能创建时会出错，捕获异常。//设置录像机的一系列参数。//创建成功了，返回该目录。//设置视频大小，清晰度。
如何实现Android端的录屏采集
zego实时音视频
04-19 3498
一、概述 在视频会议、线上课堂、游戏直播等场景下，屏幕共享是一个最常被用到的功能。要实现对屏幕画面的实时共享，端到端主要有几个步骤：录屏采集、视频编码、实时传输、视频解码、视频渲染。 一般来说，实时屏幕共享时，共享发起端以固定采样频率(一般 8 - 15帧)抓取到屏幕中指定源的画面(包括指定屏幕、指定区域、指定程序等)，经过视频编码压缩(选择保持文本/图形边缘信息不失真的方案)后，在实时网络上以相应的帧率分发。 因此，录屏采集是实现实时屏幕共享的基础。即构作为专业的音视频云服务厂商，对于实时屏幕共享有一套完
Android Graphics 显示系统 - VirtualDisplay的初印象 - 简单示例
向晚流年
09-10 3335
VirtualDisplay的初印象 - 简单示例
Android P图形架构之虚拟屏实现
Sunxiaolin2016的博客
09-14 8650
Android P默认支持两个物理屏和一个虚拟屏显示。 物理屏两块分为：主屏和副屏。 虚拟屏可以有多块。 mDisplayManager = getActivity().getSystemService(DisplayManager.class); mDisplayManager.registerDisplayListener(mDisplayListener, new Handler()); ...
Android Framework之多屏异显
m0_56144365的博客
04-07 1014
不使用TextureView ，而自定义GLSurfaceView,需要自定义解析器和Filter​val renderer: MyGlRenderer // 定义成员变量：渲染器​// 布局一定会调用 两个参数的构造函数init {// 设置EGL版本// 设置渲染器// RENDERMODE_WHEN_DIRTY 按需渲染，有帧数据的时候，才会去渲染（ 效率高，麻烦，后面需要手动调用一次才行）
Android 投屏实现纪要
luansxx的专栏
04-28 6166
在前文里介绍了Android -> Windows 多样化投屏方案 这里记录具体的实现 （一）屏幕截取 MediaProjection/VirtualDisplay 因为权限问题，不能直接创建镜像（VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR）类型的VirtualDisplay，需要通过MediaProjection 提示用户授权。 Medi...
Android开发笔记（一百三十）截图和录屏
aqi00的博客
02-06 7612
屏幕捕捉 Android5.0之后开放了屏幕捕捉的API，因此开发者便可以直接通过代码进行截图与录屏，而无需操作系统底层了。屏幕捕捉的功能由MediaProjectionManager媒体投影管理器实现，该管理器的对象从系统服务MEDIA_PROJECTION_SERVICE中获得。注意MediaProjectionManager是Android5.0之后新增的工具，故代码中要补充判断系统版本，
1对1直播源码开发，Android获取实时屏幕画面
m0_58374018的博客
06-18 1201
1对1直播源码开发，Android获取实时屏幕画面是如何实现的呢？因为VirtualDisplay可以获取当前屏幕的视频流，创建VirtualDisplay只需通过MediaProjectionManager获取MediaProjection，然后通过MediaProjection创建VirtualDisplay即可。 那么1对1直播源码中视频数据的流向是怎样的呢？ 首先，Display 会将画面投影到 VirtualDisplay中； 接着，VirtualDisplay 会将图像渲染到 Surface中，
Android技术分享| 一行代码实现安卓屏幕采集编码
Code1994的博客
09-23 634
越来越多的App需要共享手机屏幕给他人观看，特别是在线教育行业。Android 从5.0开始支持了MediaProjection，利用MediaProjection ，可以实现截屏录屏功能。 本库对屏幕采集编码进行了封装，简单的调用即可实现MediaProjection权限申请，H264硬编码，错误处理等功能。 特点 适配安卓高版本 使用 MediaCodec 异步硬编码 编码信息可配置 通知栏显示 链式调用 使用 ScreenShareKit.init(this) ...
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

千里马学框架

帮助你了，就请我喝杯咖啡

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值