Dengan layar besar yang dibentangkan dan bentuk lipatan unik memungkinkan pengalaman pengguna baru di perangkat foldable. Agar aplikasi Anda menjadi fold aware di Jetpack Compose, gunakan library Compose Material 3 Adaptive, yang menyediakan API untuk fitur jendela perangkat foldable seperti lipatan, engsel, dan postur perangkat. Jika aplikasi Anda fold-aware, aplikasi dapat menyesuaikan tata letaknya untuk menghindari penempatan konten penting di area lipatan atau engsel serta menggunakan lipatan dan engsel sebagai pemisah alami.
Memahami apakah perangkat mendukung konfigurasi seperti mode di atas meja atau postur buku dapat memandu keputusan tentang mendukung tata letak yang berbeda atau menyediakan fitur tertentu.
Informasi jendela
Di Jetpack Compose, gunakan fungsi composable collectFoldingFeaturesAsState()
untuk mengamati informasi lipatan jendela.
collectFoldingFeaturesAsState() mengumpulkan fitur lipat jendela saat ini
dari WindowInfoTracker ke dalam Compose State yang berisi daftar
objek FoldingFeature.
Karena collectFoldingFeaturesAsState() menampilkan State Compose, composable Anda akan otomatis merekomposisi setiap kali status lipatan atau postur perangkat berubah, tanpa memerlukan pengelolaan siklus proses atau pengumpulan flow manual:
@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.
}
}
Fitur layar perangkat foldable
Daftar elemen FoldingFeature yang ditampilkan oleh
collectFoldingFeaturesAsState() (subjenis DisplayFeature)
memberikan informasi tentang layar perangkat foldable, termasuk properti
berikut:
state: Status lipatan perangkat,FLATatauHALF_OPENEDorientation: Orientasi lipatan atau engsel,HORIZONTALatauVERTICALocclusionType: Apakah lipatan atau engsel menyembunyikan bagian layar,NONEatauFULLisSeparating: Apakah lipatan atau engsel membuat dua area tampilan logis, benar (true) atau salah (false)
Perangkat foldable HALF_OPENED selalu melaporkan isSeparating sebagai benar (true)
karena layar dipisahkan menjadi dua area tampilan. Selain itu, isSeparating selalu
bernilai benar (true) pada perangkat dua layar saat aplikasi membentang pada kedua
layar.
Properti bounds FoldingFeature (diwarisi dari DisplayFeature)
mewakili persegi panjang pembatas fitur lipat seperti lipatan atau engsel.
Batas dapat digunakan untuk memosisikan elemen di layar yang terkait dengan fitur:
@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.
}
}
Postur di atas meja
Dengan menggunakan informasi yang disertakan dalam objek FoldingFeature, aplikasi Anda dapat
mendukung postur seperti mode di atas meja, dengan ponsel berada di permukaan, engsel berada
dalam posisi horizontal, dan layar perangkat foldable dibuka setengah.
Postur di atas meja menawarkan kenyamanan kepada pengguna dalam mengoperasikan ponsel tanpa memegang ponsel. Postur di atas meja sangat cocok untuk menonton media, mengambil foto, dan melakukan panggilan video.
Gunakan FoldingFeature.State dan FoldingFeature.Orientation dari
collectFoldingFeaturesAsState() untuk menentukan apakah perangkat dalam mode di atas meja:
@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.
}
}
Atau, Anda dapat menentukan apakah jendela berada dalam mode di atas meja dengan memeriksa properti Posture yang ditampilkan oleh currentWindowAdaptiveInfoV2():
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val isTabletop = adaptiveInfo.windowPosture.isTabletop
Setelah mengetahui bahwa perangkat dalam mode di atas meja, perbarui tata letak aplikasi Anda. Untuk aplikasi media, pembaruan ini biasanya berarti menempatkan pemutaran di paruh atas dan kontrol posisi serta konten tambahan tepat di bawahnya untuk pengalaman menonton atau mendengarkan secara handsfree.
Contoh
Aplikasi
MediaPlayerActivity: Lihat cara menggunakan Media3 Exoplayer dan WindowManager untuk membuat pemutar video yang fold‑aware.Menskalakan konten media di berbagai faktor bentuk: Pelajari cara menangani inset jendela, ukuran jendela dinamis, dan penskalaan konten di Jetpack Compose dengan Media3.
Codelab Mengoptimalkan aplikasi kamera di perangkat foldable dengan Jetpack WindowManager: Pelajari cara menerapkan postur di atas meja untuk aplikasi fotografi. Tampilkan jendela bidik di bagian atas layar (paruh atas) dan kontrol di bagian bawah.
Postur buku
Fitur unik lain dari perangkat foldable adalah postur buku, dengan perangkat terbuka setengah dan engsel vertikal. Postur buku sangat cocok untuk membaca e-book. Dengan tata letak dua halaman pada perangkat foldable layar besar yang dapat dilipat dan terbuka seperti buku, postur buku menciptakan pengalaman membaca buku sungguhan.
Mode ini juga dapat digunakan untuk fotografi jika Anda ingin mengambil rasio aspek yang berbeda sambil mengambil gambar secara handsfree.
Terapkan postur buku dengan teknik yang sama dengan yang digunakan untuk postur di atas meja. Periksa apakah orientasi fitur lipat adalah vertikal, bukan horizontal:
@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.
}
}
Perubahan ukuran jendela
Area tampilan aplikasi dapat berubah sebagai akibat dari perubahan konfigurasi perangkat, misalnya, saat perangkat dilipat atau dibentangkan, diputar, atau diubah ukurannya dalam mode multi-aplikasi.
Untuk mengambil class ukuran jendela saat ini dan menyesuaikan dengan perubahan ukuran di Jetpack
Compose, gunakan fungsi composable currentWindowAdaptiveInfoV2() dari
library Compose Material 3 Adaptive. currentWindowAdaptiveInfoV2()
menampilkan instance WindowAdaptiveInfo yang menyediakan
WindowSizeClass jendela saat ini (dengan dukungan untuk titik henti sementara besar dan
ekstra besar secara default), serta
windowPosture perangkat:
@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
}
}
}
Lihat Menggunakan class ukuran jendela.
Referensi lainnya
Untuk mempelajari lebih lanjut tata letak fold-aware dan perangkat foldable, lihat referensi berikut:
Contoh
- Contoh WindowManager Jetpack: Contoh cara menggunakan library WindowManager Jetpack
- Jetcaster: Implementasi postur mode di atas meja dengan Compose
Codelab
- Mendukung perangkat foldable dan perangkat dua layar dengan Jetpack WindowManager
- Mengoptimalkan aplikasi kamera di perangkat foldable dengan Jetpack WindowManager