用户必须同意应用访问用户在头戴设备中看到和听到的内容。媒体投影 API 受到口令的保护。应用必须先获得该口令，才能执行视频或音频采集。要获得该口令，您的应用必须启动 MediaProjectionPermissionActivity，才能向用户请求采集屏幕的权限。用户将看到一个对话框，如果用户接受对话框，系统将提供媒体投影口令。

使用 createScreenCaptureIntent⁠ 创建启动权限活动的意图。口令将通过活动结果⁠提供。收到活动结果后，使用 getMediaProjection⁠ 方法获取媒体投影口令。请参考以下 Android 文档中的获取媒体投影口令的示例：

final MediaProjectionManager mediaProjectionManager =
    getSystemService(MediaProjectionManager.class);
final MediaProjection[] mediaProjection = new MediaProjection[1];


ActivityResultLauncher<Intent> startMediaProjection = registerForActivityResult(
    new StartActivityForResult(),
    result -> {
        if (result.getResultCode() == Activity.RESULT_OK) {
            mediaProjection[0] = mediaProjectionManager
                .getMediaProjection(result.getResultCode(), result.getData());
        }
    }
);

startMediaProjection.launch(mediaProjectionManager.createScreenCaptureIntent());

集成视频拍摄

媒体投影视频拍摄 API 通过接受 Android 表面⁠来运作。Horizon 操作系统将使用屏幕内容填充该表面。该 API 还会返回 VirtualDisplay⁠ 对象。在基础 Android 中，屏幕内容会投影到 VirtualDisplay 上，然后 Surface 会被该 VirtualDisplay 填充。但是，在 Horizon 操作系统中，表面会直接被我们自己的合成器填充。详情请见下文的 API 差异版块。

Surface 需要由客户端应用创建，该应用还负责连接 Surface 的消费者端。然后，应用可以通过 createVirtualDisplay⁠ 方法将 Surface 传递到媒体投影 API。此操作将连接生产者端，用屏幕内容填充表面。

以下展示了如何从 Android 文档调用此方法：

virtualDisplay = mediaProjection.createVirtualDisplay(
                     "ScreenCapture",
                     width,
                     height,
                     screenDensity,
                     DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,
                     surface,
                     null, null);

集成音频采集

要采集音频，请使用 Android AudioPlaybackCapture API⁠。同样地，您需要获得媒体投影口令。相同的口令可用于视频和音频采集。首先，使用媒体投影口令创建 AudioPlaybackCaptureConfiguration⁠ 对象。然后，创建 AudioRecord⁠ 对象，并将 AudioPlaybackCaptureConfiguration 对象传送进去。然后，您可以使用 AudioRecord 对象开始录制并读取采集的音频数据。

处理媒体投影回调

Android 不允许同时进行多个媒体投影采集。因此，每当另一个应用请求并获得媒体投影口令时，任何现有的媒体投影会话都会结束。原来的应用会通过媒体投影回调⁠收到通知。

您的应用必须处理系统结束媒体投影会话的情况。您必须通过回调和注册⁠来正确地结束媒体投影会话和清理任何资源。

API 差异

此 API 在 Horizon 操作系统中的实现方式的主要差异是，返回的 VirtualDisplay 对象实际上并没有填充表面。也就是说，在返回的 VirtualDisplay 上调用 resize 方法不会产生与基础 Android 中一样的行为。

图像在表面上的缩放也由 XrRuntime 内的自定义合成器处理，这意味着此版块⁠中介绍的缩放/宽银幕行为可能并不准确。

已知问题

使音频静音实际上并不会使传入系统的音频静音，这是一个已知的问题。目前，可以通过将播放器的 AudioUsage 属性设为 AUDIO_UNKNOWN 来修复这个问题。因此，如果您希望应用的音频采集能够实现音频静音，则不应在 AudioPlaybackCaptureConfiguration 中添加 AudioAttributes.USAGE_UNKNOWN 属性。