API de masque d’affichage

Représente la zone de l’affichage qui n’est pas fonctionnelle pour l’affichage de contenu.

Les API du SDK Surface Duo interagissent avec l’appareil Surface Duo et ne doivent pas être appelées quand votre application est en cours d’exécution sur d’autres appareils. Avant d’appeler ces API, vous devez vérifier si votre application est en cours d’exécution sur un appareil Surface Duo. Utilisez l’extrait de code IsDualScreenDevice pour effectuer cette vérification.

DisplayMask a été mis à jour pour restituer un rectangle englobant par rapport aux métriques d’affichage basées sur le contexte de l’application. Cela affecte la façon dont l’API se comporte quand votre application s’exécute sur un seul écran par rapport à son comportement quand elle est répartie sur deux écrans. (Un service qui a créé une vue à n’importe quel moment appartient à l’une de ces deux catégories.)

• En cas d’exécution sur un seul écran :

  • Les métriques de fenêtre et d’affichage se rapportent à cet affichage unique.
  • DisplayMask retourne une liste vide. Il n’entre pas en intersection avec la fenêtre.

• En cas d’exécution répartie sur deux écrans :

  • Les métriques de fenêtre et d’affichage se rapportent aux deux écrans, y compris le masque d’affichage.
  • Le rectangle englobant de DisplayMask identifie la zone sous la charnière matérielle par rapport à la fenêtre de l’application (DisplayMask = rectangle du masque de charnière).

  Pour plus d’informations, consultez Blog Surface Duo.

val displayMask: DisplayMask = DisplayMask.fromResourcesRect(this)
val masks: List<Rect> = displayMask.getBoundingRectsForRotation(rotation) // pass in orientation (test with 0)
var mask = Rect()
if (!masks.isEmpty()) {
    mask = masks[0]
    // layout around masked area
}

DisplayMask displayMask = DisplayMask.fromResourcesRect(context);

List<Rect> masks = displayMask.getBoundingRectsForRotation(rotation); // pass in orientation (test with 0)
Rect mask = new Rect();
if(!masks.isEmpty()) {
    mask = masks.get(0);
    // layout around masked area
}