Xamarin.Essentials: Informações de exibição do dispositivo

  • Artigo

A classe DeviceDisplay fornece informações sobre as métricas de tela do dispositivo no qual o aplicativo está sendo executado e pode solicitar para evitar que a tela fique suspensa quando o aplicativo está em execução.

Introdução

Para começar a usar essa API, leia o guia de introdução para Xamarin.Essentials garantir que a biblioteca esteja instalada e configurada corretamente em seus projetos.

Como usar DeviceDisplay

Adicione uma referência a Xamarin.Essentials em sua classe:

using Xamarin.Essentials;

Informações principais de Tela

Além das informações básicas do dispositivo, a classe DeviceDisplay contém informações sobre a tela e a orientação do dispositivo.

// Get Metrics
var mainDisplayInfo = DeviceDisplay.MainDisplayInfo;

// Orientation (Landscape, Portrait, Square, Unknown)
var orientation = mainDisplayInfo.Orientation;

// Rotation (0, 90, 180, 270)
var rotation = mainDisplayInfo.Rotation;

// Width (in pixels)
var width = mainDisplayInfo.Width;

// Height (in pixels)
var height = mainDisplayInfo.Height;

// Screen density
var density = mainDisplayInfo.Density;

A classe DeviceDisplay também expõe um evento que pode ser assinado e que é disparado sempre que ocorre alterações nas métricas da tela:

public class DisplayInfoTest
{
    public DisplayInfoTest()
    {
        // Subscribe to changes of screen metrics
        DeviceDisplay.MainDisplayInfoChanged += OnMainDisplayInfoChanged;
    }

    void OnMainDisplayInfoChanged(object sender, DisplayInfoChangedEventArgs  e)
    {
        // Process changes
        var displayInfo = e.DisplayInfo;
    }
}

Manter a tela ligada

A classe DeviceDisplay expõe uma bool propriedade chamada KeepScreenOn que pode ser definida para tentar evitar o bloqueio ou desligamento da tela do dispositivo.

public class KeepScreenOnTest
{
    public void ToggleScreenLock()
    {
        DeviceDisplay.KeepScreenOn = !DeviceDisplay.KeepScreenOn;
    }
}

Diferenças entre plataformas

Sem diferenças.

API

Encontre mais vídeos sobre o Xamarin no Channel 9 e no YouTube.