Uygulamanızın kullanıma sunulmasını sağlayın

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, FLAT veya HALF_OPENED

  • orientation: Katlama veya menteşenin yönü, HORIZONTAL veya VERTICAL

  • occlusionType: Katlama veya menteşenin ekranın bir kısmını gizleyip gizlemediği, NONE veya FULL

  • isSeparating: 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.

Masaüstü duruşunda bir video oynatıcı uygulaması. Video oynatma, ekranın dik dikey bölümünde, oynatma kontrolleri ise alt yatay bölümde yer alır.
Şekil 1. Masaüstü duruşunda bir video oynatıcı uygulaması: Video, ekranın dikey kısmında; oynatma kontrolleri ise yatay kısmında.

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

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ı