عرض التأكيدات على Wear

تجربة طريقة Compose
‫Jetpack Compose على Wear OS هي مجموعة أدوات واجهة المستخدم المقترَحة لأجهزة Wear OS.
تجربة Compose على Wear OS ←

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

في معظم الحالات، لن تحتاج إلى استخدام صورة متحركة منفصلة للتأكيد. يُرجى مراجعة مقالة مبادئ التصميم لمزيد من المعلومات.

توفر مكتبة Jetpack Wearable UI ConfirmationActivity لعرض صورة متحركة للتأكيد في تطبيقاتك.

عرض الصور المتحركة للتأكيد

يُستخدم ConfirmationActivity لعرض الصور المتحركة للتأكيد بعد أن يُكمل المستخدم إجراءً على الجهاز القابل للارتداء.

هناك ثلاثة أنواع من عمليات التأكيد:

  • النجاح: تم إكمال الإجراء بنجاح على الجهاز القابل للارتداء.
  • الفشل: تعذّر إكمال الإجراء.
  • الفتح على الهاتف: أدّى الإجراء إلى عرض محتوى على الهاتف، أو يحتاج المستخدم إلى الانتقال إلى هاتفه لمتابعة الإجراء وإكماله.

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

لاستخدام ConfirmationActivity في تطبيقك، عليك أولاً تعريف هذا النشاط في ملف البيان ، كما هو موضّح في المثال التالي:

<manifest>
  <application>
    ...
    <activity
        android:name="androidx.wear.activity.ConfirmationActivity">
    </activity>
  </application>
</manifest>

حدِّد نتيجة إجراء المستخدم، وابدأ النشاط باستخدام هدف، و أضِف رسالة تظهر أسفل رمز التأكيد، كما هو موضّح في المثال التالي:

val intent = Intent(this, ConfirmationActivity::class.java).apply {
    putExtra(ConfirmationActivity.EXTRA_ANIMATION_TYPE, ConfirmationActivity.SUCCESS_ANIMATION)
    putExtra(ConfirmationActivity.EXTRA_MESSAGE, getString(R.string.msg_sent))
}
startActivity(intent)

بعد عرض الصورة المتحركة للتأكيد، يتم إنهاء ConfirmationActivity ويستأنف نشاطك.