Izgara ve mediaQuery ile masa üstü duruş düzeni

4 yıldız puanı simgesi

Katlanabilir cihazlardaki masaüstü duruşu, tek bir ekranı fiziksel katlama (veya menteşe) ile bölünmüş iki işlevsel görüntüleme alanına ayırır. Masaüstü duruşu, uygulamanızın ana içeriğini (ör. video oynatıcı veya oyun tuvali) üst yarıya, etkileşimli öğeleri (ör. medya kontrolleri veya kontrol pedleri) ise alt yarıya yerleştirmenize olanak tanır.

Masaüstü duruşundaki katlanabilir cihazın üst ekranında video içeriği, alt ekranında ise oynatma kontrolleri gösteriliyor.
Şekil 1. Masaüstü duruşu, içeriği ve etkileşimli kontrolleri fiziksel katlama boyunca böler.

En iyi uygulamalar

Uygulamanıza masaüstü desteği eklemek için Grid API'yi kullanarak iki satır ve bir sütun içeren bir düzen tanımlayın ve masaüstü pencere duruşu medya sorgusunu uygulayın.

  • Masaüstü duruşunu reaktif olarak algılama: Cihaz durumunu gözlemlemek için mediaQuery composable'ı kullanın. Cihaz masaüstü duruşuna (windowPosture == Posture.Tabletop) katlandığında, etkinliğin yeniden başlatılmasına veya karmaşık yaşam döngüsü işlemlerine gerek kalmadan düzeninizi dinamik olarak değiştirin.
  • Düzenleri Grid ile yapılandırın: Masaüstü duruşundayken birincil görsel içeriği katın üstündeki üst satıra ve etkileşimli kontrolleri katın altındaki alt satıra düzgün bir şekilde ayırmak için Grid API'yi (2 rows, 1 column) kullanın.
  • Yer paylaşımları için dolaylı z-endeksinden yararlanın: Standart (masaüstü olmayan) duruşlarda, kontrolleri oynatıcının üzerine yerleştirmek için aynı hücreye birden fazla alan kimliği atayın. Grid, öğeleri bildirim sırasına göre otomatik olarak arkadan öne doğru oluşturur.
  • Sorunsuz geçişler sağlayın: Standart tam ekran düzenleri ile masaüstü duruşu arasında geçiş yaparken durum ve kaydırma konumlarının korunduğundan emin olun.

Malzemeler

  • Grid: Öğeleri yapılandırılabilir satır ve sütunlara yerleştirmenize olanak tanıyan uyarlanabilir bir düzen kapsayıcısıdır. İçeriği farklı ekran bölgelerine bölmek için idealdir.
  • mediaQuery: Uygulamanın mevcut pencere duruşunu, boyut sınıflarını ve donanım özelliklerini doğrudan composable'larınızda sorgulamak için kullanılan bir Jetpack Compose API'si.

Adımlar

mediaQuery() kullanarak cihaz durumunu sorgulayın. Cihaz masaüstü duruşundayken uygulamanızın içeriğini iki satır ve bir sütundan oluşan dikey bir ızgara şeklinde düzenleyin. Birincil içeriğin üstte, kontrollerin ise altta erişilebilir durumda kalmasını sağlayın.

1. Masaüstü modu için ızgara yapılandırmalarını tanımlama

Bir composable işlevde, enum kullanarak düzen alanı kimliklerini tanımlayın ve varsayılan ile masaüstü duruşları için GridConfigurationScope blokları oluşturun.

defaultConfig içinde her iki alan da aynı hücreye (row = 1, column = 1) atanır. Grid, düzende daha sonra tanımlanan bileşenlerin daha önce tanımlananların üzerinde oluşturulduğu örtük Z-endeksi kullanır. Bu sayede denetleyici, ekstra kapsayıcı iç içe yerleştirmesi olmadan oynatıcıyı yerleştirebilir (daha fazla bilgi için Izgara ile kullanıcı arayüzü öğesi yer paylaşımları bölümüne bakın).

enum class VideoPlayerArea { Player, Controller }

object PlayerGridConfig {
    // Default: Single area layout with overlay (controls on top of player)
    val defaultConfig: GridConfigurationScope.() -> Unit = {
        row(1f)
        column(1f)
        area(areaId = VideoPlayerArea.Player, row = 1, column = 1)
        area(areaId = VideoPlayerArea.Controller, row = 1, column = 1)
    }

    // Tabletop: Two rows splitting content across the fold
    val tabletopConfig: GridConfigurationScope.() -> Unit = {
        row(0.5f)
        row(0.5f)
        column(1f)
        area(areaId = VideoPlayerArea.Player, row = 1, column = 1) // Top half above fold
        area(areaId = VideoPlayerArea.Controller, row = 2, column = 1) // Bottom half below fold
    }
}

2. Masaüstü duruşunu algılama ve yapılandırmayı Grid'e uygulama

windowPosture temelinde etkin yapılandırmayı seçmek için mediaQuery kullanın, config değerini Grid değerine iletin ve birleştirilebilir içeriği alan kimliklerine bağlayın. VideoPlayerArea.Player öğesini VideoPlayerArea.Controller öğesinden önce tanımlamak, her ikisi de defaultConfig içinde bir hücreyi paylaştığında kontrollerin oynatıcının üzerinde oluşturulmasını sağlar:

val config = mediaQuery {
    when (windowPosture) {
        Posture.Tabletop -> PlayerGridConfig.tabletopConfig
        else -> PlayerGridConfig.defaultConfig
    }
}

Grid(config = config) {
    Box(
        modifier = Modifier
            .gridItem(areaId = VideoPlayerArea.Player)
    ) {
        // VideoPlayerContent
    }

    Box(
        modifier = Modifier
            .gridItem(areaId = VideoPlayerArea.Controller)
    ) {
        // PlaybackControlsContent
    }
}

Sonuçlar

mediaQuery ve Grid özelliklerini birleştiren uygulamanız, katlanabilir bir cihazın kısmen katlanarak masaüstü duruşuna geçtiğini dinamik olarak algılar ve kullanıcı arayüzünü otomatik olarak katlama çizgisiyle ayrılmış iki işlevsel ekran alanına ayarlar.

Ek kaynaklar