نمایش تأییدیه‌ها در Wear

امتحان کردن روش Compose
Jetpack Compose در Wear OS جعبه‌ابزار واسط کاربر توصیه‌شده برای Wear OS است.

پویانمایی‌های تأیید به کاربران بازخورد دیداری می‌دهند وقتی‌که کنشی را تکمیل می‌کنند. این تأییدیه‌ها کل صفحه را می‌پوشانند تا کاربران بتوانند آن‌ها را در یک نگاه ببینند.

در بیشتر موارد، نیازی به استفاده از پویانمایی تأیید جداگانه نخواهید داشت. برای اطلاعات بیشتر، اصول طراحی را مرور کنید.

«کتابخانه میانای کاربری پوشیدنی Jetpack» 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 تمام می‌شود و فعالیتتان ازسر گرفته می‌شود.