Kesitler hakkında

Ekran kesimi, bazı cihazlarda ekran yüzeyine doğru uzanan bir alandır. Cihazın ön tarafında önemli sensörler için yer sağlarken uçtan uca bir deneyim sunar.

Android, Android 9 (API düzeyi 28) ve sonraki sürümleri çalıştıran cihazlarda ekran kesimlerini destekler. Ancak cihaz üreticileri, Android 8.1 veya önceki sürümlerin yüklü olduğu cihazlarda ekran kesiklerini de destekleyebilir.

Bu sayfada, ekran kesimi olan cihazlarda Compose'da ekran kesimi desteğinin nasıl uygulanacağı açıklanmaktadır. Bu kapsamda, ekran kesimi alanı (ekran yüzeyinde ekran kesimini içeren uçtan uca dikdörtgen) ile nasıl çalışılacağı da ele alınmaktadır.

Varsayılan durum

API düzeyi 34 veya daha düşük olan uygulamalar ya da enableEdgeToEdge işlevini çağırmayan Etkinlikler, uygulama ekran kesimini içeren bir sistem çubuğuna çizilmediği sürece varsayılan olarak kesik bölgeye çizilmez.

Android 15 veya sonraki sürümlerin yüklü olduğu cihazlarda API düzeyi 35 veya sonraki sürümleri hedefleyen uygulamalar ya da enableEdgeToEdge işlevini çağıran Etkinlikler, çentik bölgesine çizim yapar.

Başka bir deyişle, LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT, LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES ve LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER, Android 15 veya sonraki sürümlerin yüklü olduğu cihazlarda API düzeyi 35 ya da daha yüksek olan uygulamalardaki kaymayan pencereler için LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS olarak yorumlanır.

Kameranın etrafındaki boşluk bilgilerini manuel olarak işleme

Kesim alanının önemli metinleri, kontrolleri veya ince dokunma tanıma gerektiren etkileşimli öğeleri (kesim alanında dokunma hassasiyeti daha düşük olabilir) kapatmasını önlemek için kesim bilgilerini işlemeniz gerekir. Boşlukları işlerken durum çubuğu yüksekliğini sabit kodlamayın. Bu, içeriğin çakışmasına veya kesilmesine neden olabilir. Bunun yerine, kesikleri aşağıdaki yöntemlerden biriyle işleyin:

• WindowInsets.displayCutout, WindowInsets.safeContent veya WindowInsets.safeDrawing kullanma

• LocalView.current.rootWindowInsets.displayCutout ile kesilmiş Path nesnesine erişme

Compose'da, composable'larınızdaki kesik ekleri işlemek için displayCutout, safeContent veya safeDrawing kullanmanızı öneririz. Bu yaklaşım, gerektiğinde ekran kesme alanı dolgusuna uymanıza veya gerekmediğinde bunu yoksaymanıza olanak tanır.

Canvas(modifier = Modifier.fillMaxSize().windowInsetsPadding(WindowInsets.displayCutout)) {
    drawRect(Color.Red, style = Stroke(2.dp.toPx()))
}
CutoutSnippets.kt