Xamarin.Essentials: Informazioni sulla visualizzazione del dispositivo

  • Articolo

La classe DeviceDisplay fornisce informazioni sulle metriche dello schermo del dispositivo in cui è in esecuzione l'applicazione e può richiedere di evitare la sospensione dello schermo quando l'applicazione è in esecuzione.

Operazioni preliminari

Per iniziare a usare questa API, leggere la guida introduttiva per Xamarin.Essentials assicurarsi che la libreria sia installata e configurata correttamente nei progetti.

Uso di DeviceDisplay

Aggiungere un riferimento a Xamarin.Essentials nella classe :

using Xamarin.Essentials;

Informazioni sullo schermo principale

Oltre alle informazioni di base sul dispositivo, la classe DeviceDisplay contiene informazioni sullo schermo e l'orientamento del 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;

La classe DeviceDisplay espone anche un evento che è possibile sottoscrivere, attivato quando le metriche dello schermo vengono modificate:

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;
    }
}

Mantieni schermata

La classe DeviceDisplay espone una proprietà bool denominata KeepScreenOn che può essere impostata per evitare lo spegnimento o il blocco dello schermo del dispositivo.

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

Differenze tra le piattaforme

Nessuna differenza.

API

Altri video di Xamarin sono disponibili su Channel 9 e YouTube.