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

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

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

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

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

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

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

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

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

• SUCCESS_ANIMATION
• FAILURE_ANIMATION
• OPEN_ON_PHONE_ANIMATION

لاستخدام ميزة "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 ويتم استئناف نشاطك.