在 Wear 上顯示確認訊息

確認動畫會在使用者完成動作時給予視覺回饋。 內容涵蓋整個螢幕畫面,確保使用者一眼就能看到確認訊息。

在大多數情況下,您不需要使用個別的確認動畫。詳情請參閱「設計原則」。

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 即完成作業,活動也會繼續執行。