MediaProjection.CreateVirtualDisplay Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea un VirtualDisplay oggetto per acquisire il contenuto dello schermo.
[Android.Runtime.Register("createVirtualDisplay", "(Ljava/lang/String;IIIILandroid/view/Surface;Landroid/hardware/display/VirtualDisplay$Callback;Landroid/os/Handler;)Landroid/hardware/display/VirtualDisplay;", "")]
public Android.Hardware.Display.VirtualDisplay? CreateVirtualDisplay(string name, int width, int height, int dpi, Android.Views.DisplayFlags flags, Android.Views.Surface? surface, Android.Hardware.Display.VirtualDisplay.Callback? callback, Android.OS.Handler? handler);[<Android.Runtime.Register("createVirtualDisplay", "(Ljava/lang/String;IIIILandroid/view/Surface;Landroid/hardware/display/VirtualDisplay$Callback;Landroid/os/Handler;)Landroid/hardware/display/VirtualDisplay;", "")>]
member this.CreateVirtualDisplay : string * int * int * int * Android.Views.DisplayFlags * Android.Views.Surface * Android.Hardware.Display.VirtualDisplay.Callback * Android.OS.Handler -> Android.Hardware.Display.VirtualDisplayParametri
- name
- String
Il nome della visualizzazione virtuale deve essere non vuoto.
- width
- Int32
Larghezza della visualizzazione virtuale in pixel. Deve essere maggiore di 0.
- height
- Int32
Altezza della visualizzazione virtuale in pixel. Deve essere maggiore di 0.
- dpi
- Int32
Densità della visualizzazione virtuale in dpi. Deve essere maggiore di 0.
- flags
- DisplayFlags
Combinazione di flag di visualizzazione virtuali. Vedere DisplayManager per l'elenco completo dei flag.
- surface
- Surface
Superficie in cui deve essere eseguito il rendering del contenuto della visualizzazione virtuale oppure null se non è presente alcuno inizialmente.
- callback
- VirtualDisplay.Callback
Callback da chiamare quando lo stato della visualizzazione virtuale cambia o null se nessuno.
- handler
- Handler
Oggetto Handler in cui deve essere richiamato il callback oppure null se il callback deve essere richiamato sul main del thread chiamante Looper.
Valori restituiti
Visualizzazione virtuale creata o null se non è possibile creare alcun display virtuale.
- Attributi
Eccezioni
Per le applicazioni destinate ad Android 14 (livello API 34) o versioni successive, se non è registrato alcuno MediaProjection.Callback .
Se la proiezione è stata arrestata; oppure, per le applicazioni destinate ad Android 14 (livello API 34) o versioni successive, se il callback è stato ricevuto, se OnStop() questa proiezione ha già avviato una registrazione o se è stata ottenuta richiamando GetMediaProjection(Int32, Intent) più volte per lo stesso risultato di consenso.
Commenti
Registrare un oggetto MediaProjection.Callback prima di chiamare questo metodo. Eseguire l'override per rilasciare OnStop() la visualizzazione virtuale, la superficie e le risorse correlate e aggiornare qualsiasi interfaccia utente che rappresenta lo stato di proiezione.
Per le applicazioni destinate ad Android 14 (livello API 34) o versioni successive, ogni sessione di consenso utente concede una chiamata a questo metodo. Non riutilizzare i dati dei risultati passati a GetMediaProjection(Int32, Intent) per ottenere più istanze di proiezione e non chiamare questo metodo più volte nella stessa istanza di proiezione.
Dopo Stop() la chiamata, questa proiezione non può più creare uno schermo virtuale. Per le applicazioni destinate ad Android 14 (livello API 34) o versioni successive, la stessa restrizione si applica dopo OnStop() la ricezione. Per le applicazioni destinate a una versione precedente, all'utente può essere richiesto di concedere di nuovo il consenso anziché generare un'eccezione.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.