Xamarin.Essentials: Informacje o wyświetlaniu urządzenia

  • Artykuł

Klasa DeviceDisplay zawiera informacje o metrykach ekranu urządzenia, na których działa aplikacja, i może zażądać, aby ekran nie zasnął, gdy aplikacja jest uruchomiona.

Rozpocznij

Aby rozpocząć korzystanie z tego interfejsu API, przeczytaj przewodnik wprowadzający , Xamarin.Essentials aby upewnić się, że biblioteka jest prawidłowo zainstalowana i skonfigurowana w projektach.

Korzystanie z funkcji DeviceDisplay

Dodaj odwołanie do Xamarin.Essentials klasy:

using Xamarin.Essentials;

Informacje o ekranie głównym

Oprócz podstawowych informacji o urządzeniu klasa DeviceDisplay zawiera informacje o ekranie i orientacji urządzenia.

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

Klasa DeviceDisplay udostępnia również zdarzenie, które można zasubskrybować, które jest wyzwalane za każdym razem, gdy wszystkie zmiany metryk ekranu:

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

Zachowaj ekran na ekranie

Klasa DeviceDisplay uwidacznia bool właściwość o nazwie KeepScreenOn , którą można ustawić, aby podjąć próbę wyłączenia lub zablokowania ekranu urządzenia.

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

Różnice między platformami

Brak różnic.

interfejs API

Więcej filmów na platformie Xamarin można znaleźć w witrynach Channel 9 i YouTube.