جعل تطبيقك مطوّلاً

تتيح الشاشات الكبيرة غير المطوية وحالات الطي الفريدة تجارب مستخدمين جديدة على الأجهزة القابلة للطي. لجعل تطبيقك متوافقًا مع الأجهزة القابلة للطي في 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 أو FULL

  • isSeparating: تشير إلى ما إذا كان الطي أو المفصلة ينشئان منطقتَي عرض منطقيتَين، صحيح أو خطأ

الجهاز القابل للطي الذي يكون 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، يمكن لتطبيقك إتاحة أوضاع مثل وضع الشاشة المسطحة، حيث يتم وضع الهاتف على سطح، وتكون المفصلة في وضع أفقي، وتكون الشاشة القابلة للطي نصف مفتوحة.

يوفّر وضع "الشاشة المسطحة" للمستخدمين إمكانية تشغيل هواتفهم بدون حملها في أيديهم. يُعدّ وضع "الشاشة المسطحة" رائعًا لمشاهدة الوسائط والتقاط الصور وإجراء مكالمات الفيديو.

تطبيق مشغّل فيديو في وضع الشاشة المسطحة مع تشغيل الفيديو على
        الجزء العمودي المستقيم من الشاشة وعناصر التحكّم في التشغيل على
        الجزء الأفقي السفلي
الشكل 1: تطبيق مشغّل فيديو في وضع الشاشة المسطحة: يظهر الفيديو على الجزء العمودي من الشاشة، وتظهر عناصر التحكّم في التشغيل على الجزء الأفقي.

استخدِم 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

بعد معرفة أنّ الجهاز في وضع الشاشة المسطحة، عدِّل تنسيق تطبيقك وفقًا لذلك. بالنسبة إلى تطبيقات الموسيقى، يعني ذلك عادةً وضع المشغّل في الجزء المرئي من الصفحة ووضع عناصر التحكّم والمحتوى التكميلي بعده مباشرةً لتوفير تجربة مشاهدة أو استماع بدون لمس الجهاز.

أمثلة

وضع الكتاب

ومن الميزات الفريدة الأخرى في الأجهزة القابلة للطي وضعية الكتاب، حيث يكون الجهاز مفتوحًا حتى المنتصف والمفصلة في وضع رأسي. وضع الكتاب رائع لقراءة الكتب الإلكترونية. من خلال تنسيق الصفحتين على شاشة كبيرة قابلة للطي ومفتوحة مثل كتاب مجلّد، يتيح وضع الكتاب تجربة قراءة كتاب حقيقي.

ويمكن استخدامها أيضًا للتصوير الفوتوغرافي إذا أردت التقاط صور بنسبة عرض إلى ارتفاع مختلفة بدون لمس الجهاز.

يمكنك استخدام وضعية الكتاب باتّباع الأساليب نفسها المستخدَمة في وضعية الشاشة المسطحة. تأكَّد من أنّ اتجاه ميزة الطي عمودي وليس أفقيًا:

@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

اختبارات الرموز