動画と音声の再生のキャプチャ

アプリは、別のアプリから再生されている動画や音声を録画できます。このようなアプリは、MediaProjection トークンを正しく処理する必要があります。このページでは、その方法について説明します。また、デバイス管理者が画面のスナップショットを録画する機能を無効にする方法と、音声アプリが他のアプリが再生するコンテンツを録音できないようにする方法についても説明します。

MediaProjection トークンを処理する方法

MediaProjection API を使用すると、アプリは MediaProjection トークンを取得できます。このトークンにより、画面のコンテンツや音声をキャプチャするための 1 回限りのアクセス権が付与されます。Android OS は、アプリにトークンを付与する前にユーザーに権限を求めます。

OS は、アクティブな MediaProjection トークンをクイック設定 UI に表示し、ユーザーはトークンへのアクセス権をいつでも取り消すことができます。この場合、セッションに関連付けられた仮想ディスプレイまたは音声ストリームはメディア ストリームの受信を停止します。アプリは適切に応答する必要があります。適切に応答しないと、音声が聞こえないか黒い動画ストリームが録画され続けます。

トークンの損失を処理するには、registerCallback メソッドを使用して MediaProjection インスタンスにコールバックを登録し、onStop メソッドが呼び出されたときに録画を停止します。

詳しくは、メディア プロジェクションをご覧ください。

動画を撮影

Media Projection API を使用してデバイスの画面をリアルタイムでキャプチャし、SurfaceView に表示する方法については、ScreenCapture サンプルアプリをご覧ください。

DevicePolicyManager を使用すると、画面録画を防ぐことができます。エンタープライズ アカウント（Android for Work）の場合、管理者は setScreenCaptureDisabled メソッドを使用して、仕事用プロファイルのアシスタント データの収集を無効にできます。

アプリを使用しない Android デバイスの管理の Codelab では、スクリーンショットを禁止する方法について説明しています。

音声再生をキャプチャする

AudioPlaybackCapture API は Android 10 で導入されました。この API は、他のアプリで再生されている音声をコピーする機能をアプリに提供します。この機能はアナログの画面キャプチャですが、音声用です。主に、ゲームで再生されている音声をキャプチャするストリーミング アプリで使用されます。

AudioPlaybackCapture API は、音声をキャプチャされるアプリの遅延の原因にはなりません。

キャプチャ アプリのビルド

セキュリティ確保とプライバシー保護のため、再生キャプチャにはいくつかの制限があります。音声のキャプチャを可能にするには、アプリが次の要件を満たしている必要があります。

  • アプリに RECORD_AUDIO 権限が付与されている必要があります。
  • アプリが MediaProjectionManager.createScreenCaptureIntent() によるプロンプトを表示し、ユーザーがそれを承認する必要があります。
  • キャプチャ アプリと再生アプリが同じユーザー プロファイルに含まれている必要があります。

別のアプリから音声をキャプチャするには、アプリで AudioRecord オブジェクトを作成して、AudioPlaybackCaptureConfiguration を追加する必要があります。手順:

  1. AudioPlaybackCaptureConfiguration.Builder.build() を呼び出して AudioPlaybackCaptureConfiguration を作成します。
  2. setAudioPlaybackCaptureConfig を呼び出して、構成を AudioRecord に渡します。

音声キャプチャの制御

アプリは、録画できるコンテンツの種類と、独自の再生を録画できる他の種類のアプリを制御できます。

音声コンテンツによるキャプチャの制限

アプリは次のメソッドを使用して、キャプチャできる音声を制限できます。

addMatchingUsage() メソッドと excludeUsage() メソッドを一緒に使用することはできません。どちらか一方のみを選択する必要があります。同様に、addMatchingUid() と excludeUid() を同時に使用することはできません。

他のアプリによるキャプチャの制限

他のアプリによって音声がキャプチャされないようにアプリを設定できます。アプリの音声は、アプリが次の要件を満たしている場合にのみキャプチャできます。

使用方法

音声を生成しているプレーヤーは、使用状況を設定して USAGE_MEDIA、USAGE_GAME、または USAGE_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 システムのみ システムのみ キャプチャなし