录制视频和音频播放内容

应用可以录制从其他应用播放的视频或音频。此类应用必须正确处理 MediaProjection 令牌。本页介绍了具体操作方法。此外,该文档还介绍了设备管理员如何停用录制任何屏幕快照的功能,以及音频应用如何阻止其他应用录制其播放的内容。

如何处理 MediaProjection 令牌

借助 MediaProjection API,应用可以获取 MediaProjection 令牌,从而获得一次性访问权限来截取屏幕内容或音频。Android 操作系统会在向您的应用授予令牌之前征求用户许可。

操作系统会在“快捷设置”界面中显示有效的 MediaProjection 令牌,并允许用户随时撤消对令牌的访问权限。发生这种情况时,与会话关联的虚拟显示屏或音频流会停止接收媒体流。您的应用必须做出适当的响应,否则会继续录制无声音频或黑色视频流。

如需处理令牌丢失的情况,请使用 registerCallback 方法在 MediaProjection 实例上注册回调,并在调用 onStop 方法时停止录制。

如需了解详情,请参阅媒体投影

拍摄视频

如需了解如何使用 Media Projection API 实时地对设备屏幕进行截图,并将其显示在 SurfaceView 上,请参阅 ScreenCapture 示例应用

您可以使用 DevicePolicyManager 来防止屏幕录制。对于企业账号 (Android for Work),管理员可以使用 setScreenCaptureDisabled 方法禁止收集工作资料的智能助理数据。

Codelab Managing Android Devices Without an App(在没有应用的情况下管理 Android 设备)介绍了如何禁止截屏。

捕获音频播放

AudioPlaybackCapture API 是在 Android 10 中引入的。应用可以借助此 API 复制其他应用正在播放的音频。该功能类似于屏幕采集,但针对的是音频。主要用例是影音在线播放应用,这些应用希望捕获游戏当前播放的音频。

请注意,对于其音频正在由其他应用捕获的应用,AudioPlaybackCapture API 不会影响此应用的延迟时间。

构建捕获应用

为确保安全性和隐私,捕获播放的音频功能会施加一些限制。 为了能够捕获音频,应用必须满足以下要求:

如需捕获其他应用的音频,您的应用必须构建一个 AudioRecord 对象,并向其中添加一个 AudioPlaybackCaptureConfiguration。请按以下步骤操作:

  1. 调用 AudioPlaybackCaptureConfiguration.Builder.build() 以构建 AudioPlaybackCaptureConfiguration
  2. 通过调用 setAudioPlaybackCaptureConfig 将配置传递给 AudioRecord

控制音频捕获

您的应用可以控制自己可以录制哪些类型的内容,以及哪些其他类型的应用可以录制自己的播放内容。

按音频内容限制捕获

应用可以使用以下方法限制它可以捕获的音频:

请注意,您不能同时使用 addMatchingUsage()excludeUsage() 方法。您必须选择其中之一。同样,您不能同时使用 addMatchingUid()excludeUid()

按其他应用限制捕获

您可以对应用进行配置来防止其他应用捕获其音频。 只有当应用满足以下要求时,才可以捕获来自该应用的音频:

用法

生成音频的播放器必须将其使用场景设置为 USAGE_MEDIAUSAGE_GAMEUSAGE_UNKNOWN

捕获政策

播放器的捕获政策必须为 AudioAttributes.ALLOW_CAPTURE_BY_ALL,此政策允许其他应用捕获播放的音频。该操作可以通过许多方法完成:

如果满足这些前提条件,应用就可以捕获播放器生成的任何音频。

停用系统捕获

上述允许捕获的保护措施仅适用于应用。默认情况下,Android 系统组件可以捕获播放的音频。 其中许多组件由 Android 供应商自定义,并支持无障碍和字幕等功能。因此,我们建议应用允许系统捕获其播放的音频。在极少数情况下,如果您不希望系统捕获应用播放的音频,则可以将该捕获政策设置为 ALLOW_CAPTURE_BY_NONE

在运行时设置政策

在应用运行时,您可以调用 AudioManager.setAllowedCapturePolicy() 来更改捕获政策。如果您在调用此方法时 MediaPlayer 或 AudioTrack 正在播放音频,则相应音频不受影响。您必须关闭播放器或音轨,然后再重新打开,这项政策变更才会生效。

政策 = 清单 + AudioManager + AudioAttributes

由于可以在多个位置指定捕获政策,因此务必要了解如何确定有效政策。 应始终应用最严格的捕获政策。例如,如果应用的清单包含 setAllowedCapturePolicy="false",则即使 AudioManager#setAllowedCapturePolicy 设置为 ALLOW_CAPTURE_BY_ALL,该应用也绝不允许非系统应用捕获其音频。同样,如果 AudioManager#setAllowedCapturePolicy 设置为 ALLOW_CAPTURE_BY_ALL,清单设置了 setAllowedCapturePolicy="true",但媒体播放器的 AudioAttributes 是使用 AudioAttributes.Builder#setAllowedCapturePolicy(ALLOW_CAPTURE_BY_SYSTEM) 构建的,则非系统应用不会捕获此媒体播放器播放的音频。

下表总结了清单属性和有效政策的效果:

allowAudioPlaybackCapture ALLOW_CAPTURE_BY_ALL ALLOW_CAPTURE_BY_SYSTEM ALLOW_CAPTURE_BY_NONE
true 任何应用 仅限系统 无法捕获
false 仅限系统 仅限系统 无法捕获