تتيح الشاشات الكبيرة غير المطوية وحالات الطي الفريدة تجارب مستخدمين جديدة على الأجهزة القابلة للطي. لجعل تطبيقك متوافقًا مع الأجهزة القابلة للطي في Jetpack Compose، استخدِم مكتبة Compose Material 3 Adaptive التي توفّر واجهات برمجة تطبيقات لميزات نوافذ الأجهزة القابلة للطي، مثل الطيات والمفاصل وأوضاع الجهاز. عندما يكون تطبيقك متوافقًا مع الشاشات القابلة للطي، يمكنه تكييف تصميمه لتجنُّب وضع المحتوى المهم في منطقة الطيات أو المفصلات واستخدام الطيات والمفصلات كفواصل طبيعية.
يمكن أن يساعد فهم ما إذا كان الجهاز يتيح إعدادات مثل وضع الشاشة المسطحة أو وضع الكتاب في توجيه القرارات بشأن إتاحة تنسيقات مختلفة أو توفير ميزات معيّنة.
معلومات النافذة
في Jetpack Compose، استخدِم الدالة المركّبة collectFoldingFeaturesAsState() لمراقبة معلومات طيّ النافذة.
تجمع دالة collectFoldingFeaturesAsState() ميزات طي النافذة الحالية
من WindowInfoTracker في Compose State يحتوي على قائمة
بعناصر FoldingFeature.
بما أنّ collectFoldingFeaturesAsState() تعرض دالة State في Compose، تتم إعادة تركيب الدوال المركّبة تلقائيًا كلما تغيّرت حالة طي الجهاز أو وضعيته، بدون الحاجة إلى إدارة مراحل النشاط يدويًا أو جمع بيانات التدفق:
@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.
}
}
ميزات الشاشات القابلة للطي
توفّر قائمة عناصر FoldingFeature التي تعرضها السمة
collectFoldingFeaturesAsState() (نوع فرعي من DisplayFeature)
معلومات عن الشاشات القابلة للطي، بما في ذلك
السمات التالية:
state: حالة طي الجهاز، إماFLATأوHALF_OPENED
orientation: اتجاه الطي أو المفصلة،HORIZONTALأوVERTICAL
occlusionType: تشير إلى ما إذا كان الجزء القابل للطي أو المفصلة يحجبان جزءًا من الشاشة،NONEأوFULLisSeparating: تشير إلى ما إذا كان الطي أو المفصلة ينشئان منطقتَي عرض منطقيتَين، صحيح أو خطأ
الجهاز القابل للطي الذي يكون HALF_OPENED يعرض دائمًا isSeparating على أنّه صحيح
لأنّ الشاشة مقسّمة إلى منطقتَي عرض. بالإضافة إلى ذلك، تكون قيمة isSeparating صحيحة دائمًا على الأجهزة ذات الشاشتين عندما يمتد التطبيق على كلتا الشاشتين.
تمثّل السمة FoldingFeature bounds (المكتسَبة من DisplayFeature) المستطيل المحيط بميزة قابلة للطي، مثل الطي أو المفصلة.
يمكن استخدام الحدود لتحديد موضع العناصر على الشاشة بالنسبة إلى المَعلم:
@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.
}
}
وضع "التثبيت على سطح مستوٍ"
باستخدام المعلومات المضمّنة في عنصر FoldingFeature، يمكن لتطبيقك
إتاحة أوضاع مثل وضع الشاشة المسطحة، حيث يتم وضع الهاتف على سطح، وتكون المفصلة
في وضع أفقي، وتكون الشاشة القابلة للطي نصف مفتوحة.
يوفّر وضع "الشاشة المسطحة" للمستخدمين إمكانية تشغيل هواتفهم بدون حملها في أيديهم. يُعدّ وضع "الشاشة المسطحة" رائعًا لمشاهدة الوسائط والتقاط الصور وإجراء مكالمات الفيديو.
استخدِم FoldingFeature.State وFoldingFeature.Orientation من
collectFoldingFeaturesAsState() لتحديد ما إذا كان الجهاز في وضعية
الشاشة المسطحة:
@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.
}
}
بدلاً من ذلك، يمكنك تحديد ما إذا كانت النافذة في وضع الشاشة المسطحة من خلال
التحقّق من السمة Posture التي تعرضها
currentWindowAdaptiveInfoV2():
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val isTabletop = adaptiveInfo.windowPosture.isTabletop
بعد معرفة أنّ الجهاز في وضع الشاشة المسطحة، عدِّل تنسيق تطبيقك وفقًا لذلك. بالنسبة إلى تطبيقات الموسيقى، يعني ذلك عادةً وضع المشغّل في الجزء المرئي من الصفحة ووضع عناصر التحكّم والمحتوى التكميلي بعده مباشرةً لتوفير تجربة مشاهدة أو استماع بدون لمس الجهاز.
أمثلة
تطبيق
MediaPlayerActivity: تعرَّف على كيفية استخدام Media3 Exoplayer وWindowManager لإنشاء مشغّل فيديو يتوافق مع الأجهزة القابلة للطي.توسيع نطاق محتوى الوسائط على مستوى أشكال الأجهزة المختلفة: تعرَّف على كيفية التعامل مع هوامش النوافذ وتغيير حجم النوافذ ديناميكيًا وتوسيع نطاق المحتوى في Jetpack Compose باستخدام Media3.
تحسين تطبيق الكاميرا على الأجهزة القابلة للطي باستخدام Jetpack WindowManager درس تطبيقي حول الترميز: تعرَّف على كيفية تنفيذ وضعية الشاشة المسطحة لتطبيقات التصوير الفوتوغرافي. اعرض عدسة الكاميرا في النصف العلوي من الشاشة (فوق الجزء المطوي) وعناصر التحكّم في النصف السفلي.
وضع الكتاب
ومن الميزات الفريدة الأخرى في الأجهزة القابلة للطي وضعية الكتاب، حيث يكون الجهاز مفتوحًا حتى المنتصف والمفصلة في وضع رأسي. وضع الكتاب رائع لقراءة الكتب الإلكترونية. من خلال تنسيق الصفحتين على شاشة كبيرة قابلة للطي ومفتوحة مثل كتاب مجلّد، يتيح وضع الكتاب تجربة قراءة كتاب حقيقي.
ويمكن استخدامها أيضًا للتصوير الفوتوغرافي إذا أردت التقاط صور بنسبة عرض إلى ارتفاع مختلفة بدون لمس الجهاز.
يمكنك استخدام وضعية الكتاب باتّباع الأساليب نفسها المستخدَمة في وضعية الشاشة المسطحة. تأكَّد من أنّ اتجاه ميزة الطي عمودي وليس أفقيًا:
@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.
}
}
تغييرات حجم النافذة
يمكن أن تتغيّر مساحة عرض التطبيق نتيجة لتغيير في إعدادات الجهاز، على سبيل المثال، عند طي الجهاز أو فتحه أو تدويره أو تغيير حجمه في وضع النوافذ المتعددة.
لاسترداد فئة حجم النافذة الحالية والتكيّف مع تغييرات الحجم في Jetpack
Compose، استخدِم الدالة المركّبة currentWindowAdaptiveInfoV2() من
مكتبة Compose Material 3 Adaptive. currentWindowAdaptiveInfoV2()
تعرض مثيل WindowAdaptiveInfo الذي يوفّر
WindowSizeClass للنافذة الحالية (مع إتاحة نقاط توقّف كبيرة
وكبيرة جدًا تلقائيًا)، بالإضافة إلى
windowPosture للجهاز:
@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
}
}
}
يُرجى الاطّلاع على مقالة استخدام فئات حجم النافذة.
مراجع إضافية
لمزيد من المعلومات حول التنسيقات المتوافقة مع الشاشات القابلة للطي والأجهزة القابلة للطي، يُرجى الاطّلاع على المراجع التالية:
نماذج
- نموذج WindowManager في Jetpack: مثال على كيفية استخدام مكتبة WindowManager في Jetpack
- Jetcaster: تنفيذ وضعية الشاشة المسطحة باستخدام Compose
اختبارات الرموز
- دَعْم الأجهزة القابلة للطي والمزودة بشاشتين من خلال مكتبة Jetpack WindowManager
- تحسين تطبيق الكاميرا على الأجهزة القابلة للطي باستخدام Jetpack WindowManager