מידע על פריימים חתוכים

חיתוך תצוגה הוא אזור במכשירים מסוימים שמתרחב אל פני השטח של התצוגה. הוא מאפשר חוויית שימוש מקצה לקצה, ועדיין מספק מקום לחיישנים חשובים בחלק הקדמי של המכשיר.

‫Android תומך בחיתוכי מסך במכשירים עם Android מגרסה 9 (רמת API‏ 28) ומעלה. עם זאת, יצרני מכשירים יכולים גם לתמוך בחלקים חסרים במסך במכשירים עם Android מגרסה 8.1 ומטה.

בדף הזה מוסבר איך להטמיע תמיכה במכשירים עם חריצים ב-Compose, כולל איך לעבוד עם אזור החריץ – כלומר, המלבן מקצה לקצה על משטח התצוגה שמכיל את החריץ.

מקרה ברירת מחדל

באפליקציות שמכוונות לרמת API 34 ומטה, או בפעילויות שלא קוראות ל-enableEdgeToEdge, לא יתבצע ציור באזור החיתוך כברירת מחדל, אלא אם האפליקציה מציירת בסרגל מערכת שמכיל את החיתוך של המסך.

אפליקציות שמטרגטות רמת API‏ 35 ומעלה במכשירים עם Android 15 ומעלה, או פעילויות שקוראות ל-enableEdgeToEdge, מציירות באזור החיתוך.

במילים אחרות, LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT,‏ LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES ו-LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER מתפרשים כ-LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS בחלונות לא צפים באפליקציות שמטרגטות רמת API 35 ומעלה במכשירים עם Android 15 ומעלה.

טיפול ידני במידע על חיתוך

צריך לטפל במידע על החיתוך כדי למנוע מצב שבו האזור החתוך מסתיר טקסט חשוב, אמצעי בקרה או רכיבים אינטראקטיביים שנדרשת בהם רגישות גבוהה למגע (רגישות המגע עשויה להיות נמוכה יותר באזור החתוך). כשמטפלים בחלקים חתוכים, לא כדאי להגדיר קידוד קשיח של גובה שורת הסטטוס, כי זה עלול לגרום לחפיפה או לקיטוע של התוכן. במקום זאת, אפשר לטפל בחלקים החסרים באחת מהדרכים הבאות:

• שימוש ב-WindowInsets.displayCutout, ב-WindowInsets.safeContent או ב-WindowInsets.safeDrawing

• גישה לאובייקט Path של הגזרה עם LocalView.current.rootWindowInsets.displayCutout

לגבי Compose, מומלץ להשתמש ב-displayCutout, ב-safeContent או ב-safeDrawing כדי לטפל בתוספות של חיתוך ברכיבים הניתנים להרכבה. הגישה הזו מאפשרת לכם להשתמש בריווח של מגרעת במסך כשצריך, או להתעלם ממנו כשלא צריך.

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