Lenguaje

MediaProjection.CreateVirtualDisplay Método

Definición

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.

Java documentación para android.media.projection.MediaProjection.createVirtualDisplay(java.lang.String, int, int, int, int, android.view.Surface, android.hardware.display.VirtualDisplay.Callback, android.os.Handler).

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.

Se aplica a

Consulte también