アプリは、別のアプリから再生されている動画や音声を録音できます。このようなアプリは、MediaProjection
トークンを正しく処理する必要があります。このページでは、その方法について説明します。また、デバイス管理者が画面スナップショットの録画機能を無効にする方法と、オーディオ アプリで再生中のコンテンツを他のアプリが録音できないようにする方法についても説明します。
MediaProjection
トークンの処理方法
MediaProjection
API を使用すると、アプリは MediaProjection
トークンを取得できます。このトークンによって、画面コンテンツまたは音声をキャプチャするための 1 回限りのアクセスが可能になります。Android OS は、アプリにトークンを許可する前に、ユーザーに権限をリクエストします。
OS では、アクティブな MediaProjection
トークンがクイック設定 UI に表示され、ユーザーはトークンへのアクセスをいつでも取り消すことができます。この場合、セッションに関連付けられた仮想ディスプレイまたはオーディオ ストリームはメディア ストリームの受信を停止します。アプリは適切に応答する必要があります。適切に応答しないと、無音または黒い動画ストリームが録音され続けます。
トークンの損失を処理するには、registerCallback
メソッドを使用して MediaProjection
インスタンスにコールバックを登録し、onStop
メソッドが呼び出されたら記録を停止します。
詳しくは、メディア プロジェクションをご覧ください。
動画を撮影
Media Projection API を使用してデバイスの画面をリアルタイムでキャプチャし、SurfaceView に表示する方法については、ScreenCapture サンプルアプリをご覧ください。
DevicePolicyManager
を使用すると、画面を録画しないようにできます。企業アカウント(Android for Work)の場合、管理者は setScreenCaptureDisabled メソッドを使用して、仕事用プロファイルのアシスタント データの収集を無効にできます。
Codelab のアプリを使用しない Android デバイスの管理では、スクリーンショットを禁止する方法について説明します。
音声再生のキャプチャ
AudioPlaybackCapture API は Android 10 で導入されました。この API を使用すると、他のアプリで再生されている音声をコピーできます。この機能はスクリーン キャプチャのアナログですが、音声のためのものです。主なユースケースは、ゲームで再生されている音声をキャプチャするストリーミング アプリです。
なお、AudioPlaybackCapture API は、音声がキャプチャされているアプリのレイテンシには影響しません。
キャプチャ アプリのビルド
セキュリティとプライバシーを保護するため、再生キャプチャにはいくつかの制限があります。 音声をキャプチャするには、アプリが次の要件を満たしている必要があります。
- アプリに
RECORD_AUDIO
権限が必要です。 - アプリは
MediaProjectionManager.createScreenCaptureIntent()
によって表示されるプロンプトを表示し、ユーザーがそれを承認する必要があります。 - キャプチャ アプリと再生アプリが同じユーザー プロファイルに含まれている必要があります。
別のアプリから音声をキャプチャするには、アプリで AudioRecord
オブジェクトを作成して、AudioPlaybackCaptureConfiguration
を追加する必要があります。手順は次のとおりです。
AudioPlaybackCaptureConfiguration.Builder.build()
を呼び出してAudioPlaybackCaptureConfiguration
をビルドします。setAudioPlaybackCaptureConfig
を呼び出して、構成をAudioRecord
に渡します。
音声キャプチャの制御
アプリは、録画できるコンテンツの種類や、再生を録画できるその他のアプリの種類を制御できます。
音声コンテンツによるキャプチャの制限
アプリは次の方法で、キャプチャできる音声を制限できます。
AUDIO_USAGE
を AudioPlaybackCaptureConfiguration.addMatchingUsage() に渡して、特定の用途のキャプチャを許可します。複数の用途を指定するには、メソッドを複数回呼び出します。AUDIO_USAGE
を AudioPlaybackCaptureConfiguration.excludeUsage() に渡して、その用途のキャプチャを禁止します。複数の用途を指定するには、メソッドを複数回呼び出します。- UID を AudioPlaybackCaptureConfiguration.addMatchingUid() に渡して、特定の UID を持つアプリのみをキャプチャします。複数の UID を指定するには、このメソッドを複数回呼び出します。
- UID を AudioPlaybackCaptureConfiguration.excludeUid() に渡して、その UID のキャプチャを禁止します。複数の UID を指定するには、このメソッドを複数回呼び出します。
addMatchingUsage()
メソッドと excludeUsage()
メソッドは併用できません。どちらか一方のみを選択する必要があります。同様に、addMatchingUid()
と excludeUid()
を同時に使用することはできません。
他のアプリによるキャプチャの制限
他のアプリが音声をキャプチャしないようにアプリを設定できます。アプリからの音声は、アプリが次の要件を満たしている場合にのみキャプチャできます。
Usage
音声を生成するプレーヤーは、用途を USAGE_MEDIA
、USAGE_GAME
、または USAGE_UNKNOWN
に設定する必要があります。
キャプチャ ポリシー
プレーヤーのキャプチャ ポリシーは AudioAttributes.ALLOW_CAPTURE_BY_ALL
である必要があります。これにより、他のアプリが再生をキャプチャできるようになります。これはさまざまな方法で設定できます。
- すべてのプレーヤーでキャプチャを有効にするには、アプリの
manifest.xml
ファイルにandroid:allowAudioPlaybackCapture="true"
を含めます。 - また、
AudioManager.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL)
を呼び出して、すべてのプレーヤーでキャプチャを有効にすることもできます。 AudioAttributes.Builder.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL)
を使用して個々のプレーヤーを作成する際に、このポリシーを設定できます。(AAudio
を使用している場合は、AAudioStreamBuilder_setAllowedCapturePolicy(AAUDIO_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 |
---|---|---|---|
○ | すべてのアプリ | システムのみ | キャプチャなし |
false | システムのみ | システムのみ | キャプチャなし |