MediaProjection.CreateVirtualDisplay Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un VirtualDisplay pour capturer le contenu de l’écran.
[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.VirtualDisplayParamètres
- name
- String
Le nom de l’affichage virtuel doit être non vide.
- width
- Int32
Largeur de l’affichage virtuel en pixels. Doit être supérieure à 0.
- height
- Int32
Hauteur de l’affichage virtuel en pixels. Doit être supérieure à 0.
- dpi
- Int32
Densité de l’affichage virtuel en ppp. Doit être supérieure à 0.
- flags
- DisplayFlags
Combinaison d’indicateurs d’affichage virtuels. Consultez DisplayManager la liste complète des indicateurs.
- surface
- Surface
Surface à laquelle le contenu de l’affichage virtuel doit être affiché, ou null s’il n’existe aucun initialement.
- callback
- VirtualDisplay.Callback
Rappel pour appeler lorsque l’état de l’affichage virtuel change ou null si aucun.
- handler
- Handler
Sur Handler lequel le rappel doit être appelé ou null si le rappel doit être appelé sur le principal Looperdu thread appelant.
Retours
Affichage virtuel créé ou null si aucun affichage virtuel n’a pu être créé.
- Attributs
Exceptions
Pour les applications ciblant Android 14 (niveau d’API 34) ou version ultérieure, si aucune application n’est MediaProjection.Callback inscrite.
Si la projection a été arrêtée ; ou, pour les applications ciblant Android 14 (niveau d’API 34) ou version ultérieure, si son OnStop() rappel a été reçu, si cette projection a déjà démarré un enregistrement ou s’il a été obtenu en appelant GetMediaProjection(Int32, Intent) plusieurs fois pour le même résultat de consentement.
Remarques
Inscrivez un MediaProjection.Callback avant d’appeler cette méthode. Remplacez OnStop() la mise en production de l’affichage virtuel, de la surface et des ressources associées et pour mettre à jour toute interface utilisateur qui représente l’état de projection.
Pour les applications ciblant Android 14 (niveau d’API 34) ou version ultérieure, chaque session de consentement utilisateur accorde un appel à cette méthode. Ne réutilisez pas les données de résultat transmises pour GetMediaProjection(Int32, Intent) obtenir plusieurs instances de projection et n’appelez pas cette méthode plusieurs fois sur la même instance de projection.
Une fois Stop() appelée, cette projection ne peut plus créer d’affichage virtuel. Pour les applications ciblant Android 14 (niveau d’API 34) ou version ultérieure, la même restriction s’applique après OnStop() réception. Pour les applications ciblant une version antérieure, l’utilisateur peut être invité à accorder à nouveau le consentement au lieu d’une exception levée.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.