MediaProjection.CreateVirtualDisplay Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un VirtualDisplay objeto para capturar el contenido de la pantalla.
[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.VirtualDisplay
Parámetros
- name
- String
El nombre de la presentación virtual debe no estar vacío.
- width
- Int32
Ancho de la pantalla virtual en píxeles. Debe ser mayor que 0.
- height
- Int32
Alto de la pantalla virtual en píxeles. Debe ser mayor que 0.
- dpi
- Int32
Densidad de la pantalla virtual en ppp. Debe ser mayor que 0.
- flags
- DisplayFlags
Combinación de marcas de visualización virtual. Consulte DisplayManager la lista completa de marcas.
- surface
- Surface
Superficie a la que se debe representar el contenido de la pantalla virtual o null si no hay ninguna inicialmente.
- callback
- VirtualDisplay.Callback
Devolución de llamada para llamar cuando cambia el estado de la pantalla virtual o null si no existe.
- handler
- Handler
en Handler el que se debe invocar la devolución de llamada, o null si se debe invocar la devolución de llamada en la principal Looperdel subproceso que realiza la llamada.
Devoluciones
Pantalla virtual creada o null si no se puede crear ninguna pantalla virtual.
- Atributos
Excepciones
En el caso de las aplicaciones destinadas a Android 14 (nivel de API 34) o posterior, si no MediaProjection.Callback está registrado.
Si se ha detenido la proyección; o bien, para las aplicaciones destinadas a Android 14 (nivel de API 34) o posterior, si se ha recibido su OnStop() devolución de llamada, si esta proyección ya ha iniciado una grabación, o si se obtuvo invocando GetMediaProjection(Int32, Intent) más de una vez para el mismo resultado de consentimiento.
Comentarios
Registre un MediaProjection.Callback antes de llamar a este método. Invalide OnStop() para liberar la presentación virtual, la superficie y los recursos relacionados y actualizar cualquier interfaz de usuario que represente el estado de proyección.
Para las aplicaciones destinadas a Android 14 (nivel de API 34) o posterior, cada sesión de consentimiento del usuario concede una llamada a este método. No reutilice los datos de resultados pasados para GetMediaProjection(Int32, Intent) obtener varias instancias de proyección y no llame a este método más de una vez en la misma instancia de proyección.
Después Stop() de llamar a , esta proyección ya no puede crear una pantalla virtual. En el caso de las aplicaciones destinadas a Android 14 (nivel de API 34) o posterior, se aplica la misma restricción después OnStop() de recibirse. En el caso de las aplicaciones destinadas a una versión anterior, se puede solicitar al usuario que vuelva a conceder consentimiento en lugar de que se produzca una excepción.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.