Un'app può registrare il video o l'audio riprodotto da un'altra app. Queste app devono gestire correttamente il token MediaProjection. Questa pagina spiega come. Inoltre, mostra come un amministratore del dispositivo può disattivare la possibilità di registrare gli screenshot dello schermo e come un'app audio può impedire ad altre app di registrare i contenuti riprodotti.
Come gestire un token MediaProjection
L'API MediaProjection consente alle app di acquisire un token MediaProjection che offre un accesso una tantum per acquisire contenuti dello schermo o audio. Il sistema operativo Android chiede all'utente l'autorizzazione prima di concedere il token alla tua app.
Il sistema operativo mostra i token MediaProjection attivi nell'interfaccia utente delle Impostazioni rapide e consente agli utenti di revocare l'accesso a un token in qualsiasi momento. In questo caso, i display virtuali o gli stream audio associati alla sessione smettono di ricevere stream multimediali. L'app deve rispondere in modo appropriato, altrimenti continuerà
a registrare silenzio audio o uno stream video nero.
Per gestire la perdita di un token, registra un callback sull'istanza MediaProjection
utilizzando il metodo
registerCallback
e interrompi la registrazione quando viene chiamato il metodo
onStop.
Per ulteriori informazioni, consulta la sezione Proiezione di contenuti multimediali.
Registra video
Consulta l'app di esempio ScreenCapture per scoprire come utilizzare l'API Media Projection per acquisire lo schermo di un dispositivo in tempo reale e mostrarlo su un SurfaceView.
Puoi utilizzare DevicePolicyManager per impedire la registrazione dello schermo. Per gli account aziendali (Android for Work), l'amministratore può disattivare la raccolta dei dati dell'assistente per il profilo di lavoro utilizzando il metodo setScreenCaptureDisabled.
Il codelab Gestire i dispositivi Android senza un'app spiega come vietare gli screenshot.
Acquisisci la riproduzione audio
L'API AudioPlaybackCapture è stata introdotta in Android 10. Questa API consente alle app di copiare l'audio riprodotto da altre app. Questa funzionalità è l'equivalente dell'acquisizione dello schermo, ma per l'audio. Il caso d'uso principale riguarda le app di streaming che vogliono acquisire l'audio riprodotto dai giochi.
Tieni presente che l'API AudioPlaybackCapture non influisce sulla latenza dell'app di cui viene acquisito l'audio.
Creazione di un'app di acquisizione
Per motivi di sicurezza e privacy, la registrazione della riproduzione impone alcune limitazioni. Per poter acquisire audio, un'app deve soddisfare i seguenti requisiti:
- L'app deve disporre dell'autorizzazione
RECORD_AUDIO. - L'app deve mostrare il prompt visualizzato da
MediaProjectionManager.createScreenCaptureIntent(), e l'utente deve approvarlo. - Le app di acquisizione e riproduzione devono trovarsi nello stesso profilo utente.
Per acquisire l'audio da un'altra app, la tua app deve creare un oggetto
AudioRecord
e aggiungervi un
AudioPlaybackCaptureConfiguration. Procedi nel seguente modo:
- Chiama
AudioPlaybackCaptureConfiguration.Builder.build()per creare unAudioPlaybackCaptureConfiguration. - Passa la configurazione a
AudioRecordchiamandosetAudioPlaybackCaptureConfig.
Controllare l'acquisizione audio
La tua app può controllare quali tipi di contenuti può registrare e quali altri tipi di app possono registrare la propria riproduzione.
Limitare l'acquisizione in base ai contenuti audio
Un'app può limitare l'audio che può acquisire utilizzando questi metodi:
- Passa un
AUDIO_USAGEa AudioPlaybackCaptureConfiguration.addMatchingUsage() per consentire di acquisire un utilizzo specifico. Chiama il metodo più volte per specificare più di un utilizzo. - Passa un
AUDIO_USAGEa AudioPlaybackCaptureConfiguration.excludeUsage() per vietare l'acquisizione di questo utilizzo. Chiama il metodo più volte per specificare più di un utilizzo. - Passa un UID a AudioPlaybackCaptureConfiguration.addMatchingUid() per acquisire solo le app con un UID specifico. Chiama il metodo più volte per specificare più di un UID.
- Passa un UID a AudioPlaybackCaptureConfiguration.excludeUid() per vietare l'acquisizione di quell'UID. Chiama il metodo più volte per specificare più di un UID.
Tieni presente che non puoi utilizzare contemporaneamente i metodi addMatchingUsage() e excludeUsage(). Devi scegliere una o l'altra opzione. Analogamente, non puoi utilizzare addMatchingUid() e excludeUid() contemporaneamente.
Limitare l'acquisizione da parte di altre app
Puoi configurare un'app per impedire ad altre app di acquisire l'audio. L'audio proveniente da un'app può essere acquisito solo se l'app soddisfa i seguenti requisiti:
Utilizzo
Il player che produce l'audio deve impostarne l'utilizzo su USAGE_MEDIA, USAGE_GAME o USAGE_UNKNOWN.
Criterio di acquisizione
Le norme relative alle acquisizioni del player devono essere impostate su
AudioAttributes.ALLOW_CAPTURE_BY_ALL,
che consente ad altre app di acquisire la riproduzione. Questa operazione può essere eseguita in diversi modi:
- Per attivare la registrazione su tutti i giocatori, includi
android:allowAudioPlaybackCapture="true"nel filemanifest.xmldell'app. - Puoi anche attivare la registrazione su tutti i giocatori chiamando
AudioManager.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL). - Puoi impostare il criterio su un singolo player quando lo crei utilizzando
AudioAttributes.Builder.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL). Se utilizziAAudio, chiamaAAudioStreamBuilder_setAllowedCapturePolicy(AAUDIO_ALLOW_CAPTURE_BY_ALL).
Se questi prerequisiti sono soddisfatti, è possibile acquisire qualsiasi audio prodotto dal player.
Disattivazione dell'acquisizione del sistema
Le protezioni che consentono la cattura descritte sopra si applicano solo alle app. I componenti di sistema Android possono acquisire la riproduzione per impostazione predefinita.
Molti di questi componenti sono personalizzati dai fornitori di Android e supportano funzionalità come l'accessibilità e i sottotitoli codificati. Per questo motivo, è consigliabile che le app consentano al sistema di acquisire la loro riproduzione. Nei rari casi in cui non
vuoi che il sistema acquisisca la riproduzione della tua app, imposta il criterio di acquisizione su
ALLOW_CAPTURE_BY_NONE.
Impostazione del criterio in fase di runtime
Puoi chiamare AudioManager.setAllowedCapturePolicy() per modificare il criterio di acquisizione mentre un'app è in esecuzione. Se un MediaPlayer o un AudioTrack è in riproduzione
quando chiami il metodo, l'audio non viene interessato. Affinché la modifica dei criteri venga applicata, devi chiudere e riaprire il player o la traccia.
Criterio = manifest + AudioManager + AudioAttributes
Poiché il criterio di acquisizione può essere specificato in più punti, è importante comprendere come viene determinato il criterio effettivo.
Viene sempre applicata la norma di acquisizione più restrittiva. Ad esempio, un'app il cui manifest include setAllowedCapturePolicy="false" non consentirà mai alle app non di sistema di acquisire il suo audio, anche se AudioManager#setAllowedCapturePolicy è impostato su ALLOW_CAPTURE_BY_ALL. Analogamente, se il valore di AudioManager#setAllowedCapturePolicy è impostato su ALLOW_CAPTURE_BY_ALL e il manifest imposta setAllowedCapturePolicy="true", ma il valore di AudioAttributes del media player è stato creato con AudioAttributes.Builder#setAllowedCapturePolicy(ALLOW_CAPTURE_BY_SYSTEM), questo media player non potrà essere acquisito dalle app non di sistema.
La tabella seguente riassume l'effetto dell'attributo manifest e la norma effettiva:
| allowAudioPlaybackCapture | ALLOW_CAPTURE_BY_ALL | ALLOW_CAPTURE_BY_SYSTEM | ALLOW_CAPTURE_BY_NONE |
|---|---|---|---|
| vero | qualsiasi app | solo sistema | Nessuna acquisizione |
| falso | solo sistema | solo sistema | Nessuna acquisizione |