Katlanabilir cihazlarda, katlanmamış büyük ekranlar ve benzersiz katlanmış durumlar yeni kullanıcı deneyimleri sunar. Uygulamanızı Jetpack Compose'da katlanabilir cihazlara uyumlu hale getirmek için Compose Material 3 Adaptive kitaplığını kullanın. Bu kitaplık; katlama, menteşe ve cihaz duruşu gibi katlanabilir cihaz penceresi özellikleri için API'ler sağlar. Uygulamanız katlanabilir cihazlara uyumlu olduğunda, önemli içerikleri katlama veya menteşe alanına yerleştirmemek için düzenini uyarlayabilir ve katlama ile menteşeleri doğal ayırıcılar olarak kullanabilir.
Bir cihazın masaüstü veya kitap duruşu gibi yapılandırmaları destekleyip desteklemediğini anlamak, farklı düzenleri destekleme veya belirli özellikler sunma konusundaki kararlara yön verebilir.
Pencere bilgileri
Jetpack Compose'da, pencere katlama bilgilerini gözlemlemek için collectFoldingFeaturesAsState() composable işlevini kullanın.
collectFoldingFeaturesAsState(), WindowInfoTracker'den geçerli pencere katlama özelliklerini toplayarak FoldingFeature nesnelerinin listesini içeren bir Compose State nesnesine dönüştürür.
collectFoldingFeaturesAsState(), bir Compose State döndürdüğü için cihazın katlama durumu veya duruşu değiştiğinde, manuel yaşam döngüsü yönetimi veya akış toplama gerekmeden composable'larınız otomatik olarak yeniden oluşturulur:
@Composable
fun FoldAwareScreen() {
val foldingFeatures by collectFoldingFeaturesAsState()
// Access folding features for the current window.
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
// Adapt layout based on the fold feature.
}
}
Katlanabilir ekranların özellikleri
collectFoldingFeaturesAsState() (DisplayFeature'nin bir alt türü) tarafından döndürülen FoldingFeature öğelerinin listesi, katlanabilir ekranlar hakkında aşağıdaki özellikler de dahil olmak üzere bilgi sağlar:
state: Cihazın katlanmış durumu,FLATveyaHALF_OPENEDorientation: Katlama veya menteşenin yönü,HORIZONTALveyaVERTICALocclusionType: Katlama veya menteşenin ekranın bir kısmını gizleyip gizlemediği,NONEveyaFULLisSeparating: Katlama veya menteşenin iki mantıksal ekran alanı oluşturup oluşturmadığı (doğru veya yanlış)
HALF_OPENED olan katlanabilir bir cihaz, ekran iki görüntüleme alanına ayrıldığı için her zaman isSeparating değerini doğru olarak bildirir. Ayrıca, uygulama her iki ekranı da kapladığında isSeparating, çift ekranlı bir cihazda her zaman doğrudur.
FoldingFeature bounds özelliği (DisplayFeature öğesinden devralınır), katlama veya menteşe gibi bir katlama özelliğinin sınırlayıcı dikdörtgenini temsil eder.
Sınırlar, ekrandaki öğeleri özelliğe göre konumlandırmak için kullanılabilir:
@Composable
fun FoldFeatureDemo() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
val isSeparating = foldFeature.isSeparating
val occlusionType = foldFeature.occlusionType
val bounds = foldFeature.bounds
// Use bounds and properties to position content.
}
}
Masaüstü duruşu
Uygulamanız, FoldingFeature nesnesinde yer alan bilgileri kullanarak telefonun bir yüzeyde durduğu, menteşenin yatay konumda olduğu ve katlanabilir ekranın yarı açık olduğu masaüstü gibi duruşları destekleyebilir.
Masaüstü duruşu, kullanıcılara telefonlarını ellerinde tutmadan kullanma kolaylığı sağlar. Masaüstü duruşu, medya izlemek, fotoğraf çekmek ve görüntülü görüşme yapmak için idealdir.
Cihazın masaüstü duruşunda olup olmadığını belirlemek için collectFoldingFeaturesAsState() sınıfındaki FoldingFeature.State ve FoldingFeature.Orientation yöntemlerini kullanın:
@Composable
fun TabletopContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isTableTopPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.HORIZONTAL
if (isTableTopPosture) {
// Tabletop layout: separate content and controls across the fold.
} else {
// Standard layout.
}
}
Alternatif olarak, currentWindowAdaptiveInfoV2() tarafından döndürülen Posture özelliğini kontrol ederek pencerenin masaüstü duruşunda olup olmadığını belirleyebilirsiniz:
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val isTabletop = adaptiveInfo.windowPosture.isTabletop
Cihazın masaüstü duruşunda olduğunu öğrendikten sonra uygulama düzeninizi buna göre güncelleyin. Medya uygulamalarında bu, genellikle oynatma bölümünün ekranın üst kısmına yerleştirilmesi ve kontroller ile ek içeriklerin hemen altına konumlandırılması anlamına gelir. Böylece kullanıcılar, ellerini kullanmadan izleme veya dinleme deneyimi yaşayabilir.
Örnekler
MediaPlayerActivityuygulaması: Katlanabilir cihazlara uyumlu bir video oynatıcı oluşturmak için Media3 Exoplayer ve WindowManager'ı nasıl kullanacağınızı öğrenin.Medya içeriğini form faktörlerine göre ölçeklendirme: Media3 ile Jetpack Compose'da pencere eklerini, dinamik pencere boyutlandırmayı ve içerik ölçeklendirmeyi nasıl yöneteceğinizi öğrenin.
Jetpack WindowManager ile katlanabilir cihazlarda kamera uygulamanızı optimize etme codelab: Fotoğrafçılık uygulamaları için masaüstü duruşunu nasıl uygulayacağınızı öğrenin. Vizörü ekranın üst yarısında (katlama çizgisinin üstünde), kontrolleri ise alt yarısında gösterin.
Kitap duruşu
Katlanabilir cihazlara özgü bir diğer özellik de cihazın yarıya kadar açıldığı ve menteşenin dikey olduğu kitap duruşudur. Kitap duruşu, e-kitap okumak için idealdir. Ciltli bir kitap gibi açılan büyük ekranlı katlanabilir cihazlarda iki sayfalık düzen sunan kitap duruşu, gerçek bir kitap okuma deneyimi yaşatır.
Ellerinizi kullanmadan fotoğraf çekerken farklı bir en-boy oranı yakalamak istiyorsanız fotoğrafçılık için de kullanılabilir.
Masaüstü duruşu için kullanılan tekniklerin aynısını kullanarak kitap duruşunu uygulayın. Katlama özelliğinin yönünün yatay yerine dikey olduğunu kontrol edin:
@Composable
fun BookContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isBookPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.VERTICAL
if (isBookPosture) {
// Book posture layout: two-page layout across the vertical fold.
} else {
// Standard single-page layout.
}
}
Pencere boyutu değişiklikleri
Bir uygulamanın görüntüleme alanı, cihaz yapılandırmasındaki bir değişiklik sonucunda değişebilir. Örneğin, cihaz katlandığında veya açıldığında, döndürüldüğünde ya da çoklu pencere modunda yeniden boyutlandırıldığında.
Mevcut pencere boyutu sınıfını almak ve Jetpack Compose'daki boyut değişikliklerine uyum sağlamak için Compose Material 3 Adaptive kitaplığındaki currentWindowAdaptiveInfoV2() composable işlevini kullanın. currentWindowAdaptiveInfoV2(), geçerli pencerenin WindowSizeClass değerini (varsayılan olarak büyük ve ekstra büyük kesme noktaları desteğiyle) ve cihazın windowPosture değerini sağlayan bir WindowAdaptiveInfo örneği döndürür:
@Composable
fun AdaptiveApp() {
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val windowSizeClass = adaptiveInfo.windowSizeClass
when {
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_EXPANDED_LOWER_BOUND
) -> {
// Expanded layout
}
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_MEDIUM_LOWER_BOUND
) -> {
// Medium layout
}
else -> {
// Compact layout
}
}
}
Pencere boyutu sınıflarını kullanma başlıklı makaleyi inceleyin.
Ek kaynaklar
Katlanabilir cihazlar ve katlanabilir cihazlara uygun düzenler hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara göz atın:
Örnekler
- Jetpack WindowManager örneği: Jetpack WindowManager kitaplığının nasıl kullanılacağına dair örnek
- Jetcaster: Compose ile masaüstü duruşu uygulaması
Codelab uygulamaları
- Jetpack WindowManager ile Katlanabilir ve Çift Ekranlı Cihazları Destekleme
- Jetpack WindowManager ile katlanabilir cihazlarda kamera uygulamanızı optimize etme