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.
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
mediaQuerycomposable'ı 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
Gridile 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çinGridAPI'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
- Uyarlanabilir uygulamaları kullanmaya başlama
- Katlanabilir ekran modlarını destekleme
- Izgara ile kullanıcı arayüzü öğesi yer paylaşımları