Une application peut enregistrer la vidéo ou l'audio en cours de lecture à partir d'une autre application. Ces applications doivent gérer correctement le jeton MediaProjection
. Cette page explique comment procéder. Il montre également comment un administrateur d'appareil peut désactiver la possibilité d'enregistrer des instantanés d'écran et comment une application audio peut empêcher d'autres applications d'enregistrer le contenu lu.
Gérer un jeton MediaProjection
L'API MediaProjection
permet aux applications d'acquérir un jeton MediaProjection
qui leur donne un accès unique pour capturer le contenu de l'écran ou l'audio. L'OS Android demande à l'utilisateur son autorisation avant d'accorder le jeton à votre application.
L'OS affiche les jetons MediaProjection
actifs dans l'interface utilisateur des Réglages rapides et permet aux utilisateurs de retirer l'accès à un jeton à tout moment. Dans ce cas, les affichages virtuels ou les flux audio associés à la session cessent de recevoir les flux multimédias. Votre application doit répondre de manière appropriée, sinon elle continuera d'enregistrer une silence audio ou un flux vidéo noir.
Pour gérer la perte d'un jeton, enregistrez un rappel sur l'instance MediaProjection
à l'aide de la méthode registerCallback
, puis arrêtez l'enregistrement lorsque la méthode onStop
est appelée.
Pour en savoir plus, consultez la section Projection multimédia.
Enregistrer une vidéo
Consultez l'application exemple ScreenCapture pour apprendre à utiliser l'API Media Projection afin de capturer l'écran d'un appareil en temps réel et de l'afficher sur une SurfaceView.
Vous pouvez utiliser le DevicePolicyManager
pour empêcher l'enregistrement de l'écran. Pour les comptes d'entreprise (Android for Work), l'administrateur peut désactiver la collecte des données de l'assistant pour le profil professionnel à l'aide de la méthode setScreenCaptureDisabled.
L'atelier de programmation Gérer des appareils Android sans application explique comment interdire les captures d'écran.
Enregistrer la lecture audio
L'API AudioPlaybackCapture a été introduite dans Android 10. Cette API permet aux applications de copier le contenu audio lu par d'autres applications. Cette fonctionnalité est l'équivalent de la capture d'écran, mais pour l'audio. Le cas d'utilisation principal concerne les applications de streaming qui souhaitent capturer le contenu audio joué par les jeux.
Notez que l'API AudioPlaybackCapture n'affecte pas la latence de l'application dont le contenu audio est capturé.
Créer une application de capture
Pour des raisons de sécurité et de confidentialité, la capture vidéo impose certaines limites. Pour enregistrer du contenu audio, votre application doit remplir les conditions suivantes:
- L'application doit disposer de l'autorisation
RECORD_AUDIO
. - L'application doit afficher l'invite affichée par
MediaProjectionManager.createScreenCaptureIntent()
et l'utilisateur doit l'approuver. - Les applications de capture et de lecture doivent se trouver dans le même profil utilisateur.
Pour capturer du contenu audio à partir d'une autre application, celle-ci doit créer un objet AudioRecord
et y ajouter un élément AudioPlaybackCaptureConfiguration
. Procédez comme suit :
- Appelez
AudioPlaybackCaptureConfiguration.Builder.build()
pour créer unAudioPlaybackCaptureConfiguration
. - Transmettez la configuration à
AudioRecord
en appelantsetAudioPlaybackCaptureConfig
.
Contrôler la capture audio
Votre application peut contrôler les types de contenus qu'elle peut enregistrer et les autres types d'applications qui peuvent enregistrer sa propre lecture.
Limiter la capture par contenu audio
Une application peut limiter le contenu audio qu'elle peut capturer à l'aide des méthodes suivantes:
- Transmettez un
AUDIO_USAGE
à AudioPlaybackCaptureConfiguration.addMatchingUsage() pour autoriser la capture d'une utilisation spécifique. Appelez la méthode plusieurs fois pour spécifier plusieurs utilisations. - Transmettez un élément
AUDIO_USAGE
à AudioPlaybackCaptureConfiguration.ExcludeUsage() pour interdire la capture de cette utilisation. Appelez la méthode plusieurs fois pour spécifier plusieurs utilisations. - Transmettez un UID à AudioPlaybackCaptureConfiguration.addMatchingUid() pour ne capturer que les applications ayant un UID spécifique. Appelez la méthode plusieurs fois pour spécifier plusieurs UID.
- Transmettez un UID à AudioPlaybackCaptureConfiguration.ExcludeUid() pour interdire la capture de cet UID. Appelez la méthode plusieurs fois pour spécifier plusieurs UID.
Notez que vous ne pouvez pas utiliser les méthodes addMatchingUsage()
et excludeUsage()
ensemble. Vous devez choisir l'une ou l'autre de ces options. De même, vous ne pouvez pas utiliser addMatchingUid()
et excludeUid()
en même temps.
Limiter la capture par d'autres applications
Vous pouvez configurer une application de manière à empêcher les autres applications d'enregistrer son contenu audio. Le contenu audio provenant d'une application ne peut être enregistré que si celle-ci remplit les conditions suivantes:
Utilisation
Le lecteur qui produit l'audio doit définir son utilisation sur USAGE_MEDIA
, USAGE_GAME
ou USAGE_UNKNOWN
.
Règle de capture
La règle de capture du lecteur doit être AudioAttributes.ALLOW_CAPTURE_BY_ALL
, ce qui permet aux autres applications de capturer la lecture. Pour ce faire, vous disposez de différentes méthodes:
- Pour activer la capture sur tous les joueurs, incluez
android:allowAudioPlaybackCapture="true"
dans le fichiermanifest.xml
de l'application. - Vous pouvez également activer la capture sur tous les joueurs en appelant
AudioManager.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL)
. - Vous pouvez définir la règle sur un joueur individuel lorsque vous le compilez à l'aide de
AudioAttributes.Builder.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL)
. (Si vous utilisezAAudio
, appelezAAudioStreamBuilder_setAllowedCapturePolicy(AAUDIO_ALLOW_CAPTURE_BY_ALL)
.)
Si ces conditions sont remplies, tout contenu audio produit par le lecteur peut être capturé.
Désactivation de la capture système
Les protections permettant la capture décrites ci-dessus ne s'appliquent qu'aux applications. Les composants du système Android peuvent capturer la lecture par défaut.
Bon nombre de ces composants sont personnalisés par les fournisseurs Android et prennent en charge des fonctionnalités telles que l'accessibilité et les sous-titres. C'est pourquoi il est recommandé que les applications autorisent le système à enregistrer leur lecture. Dans les rares cas où vous ne souhaitez pas que le système capture la lecture de votre application, définissez la règle de capture sur ALLOW_CAPTURE_BY_NONE
.
Définir la règle au moment de l'exécution
Vous pouvez appeler AudioManager.setAllowedCapturePolicy()
pour modifier la règle de capture pendant l'exécution d'une application. Si un MediaPlayer ou une piste audio est en cours de lecture lorsque vous appelez la méthode, l'audio n'est pas affecté. Vous devez fermer, puis rouvrir le lecteur ou le suivi pour que la modification de la règle prenne effet.
Règle = fichier manifeste + AudioManager + AudioAttributes
Étant donné que la règle de capture peut être spécifiée à plusieurs endroits, il est important de comprendre comment la règle en vigueur est déterminée.
La règle de capture la plus restrictive est toujours appliquée. Par exemple, une application dont le fichier manifeste inclut setAllowedCapturePolicy="false"
n'autorisera jamais les applications non-système à capturer son contenu audio, même si AudioManager#setAllowedCapturePolicy
est défini sur ALLOW_CAPTURE_BY_ALL
. De même, si AudioManager#setAllowedCapturePolicy
est défini sur ALLOW_CAPTURE_BY_ALL
et que le fichier manifeste indique setAllowedCapturePolicy="true"
, mais que les AudioAttributes
du lecteur multimédia ont été créés avec AudioAttributes.Builder#setAllowedCapturePolicy(ALLOW_CAPTURE_BY_SYSTEM)
, ce lecteur multimédia ne pourra pas être capturé par des applications autres que système.
Le tableau ci-dessous récapitule l'effet de l'attribut "manifest" et la règle applicable:
allowAudioPlaybackCapture | AUTORISER_TOUT_CAPTURE_PAR_TOUT | AUTORISER_CAPTURE_PAR_SYSTÈME | AUTORISER_CAPTURE_BY_NONE |
---|---|---|---|
vrai | n'importe quelle application | système uniquement | aucune capture |
false | système uniquement | système uniquement | aucune capture |