在 Wear 上顯示確認訊息

注意：本指南與 Android View 的使用有關。建議做法 Compose for Wear OS 是一種現代化的宣告式方法 使用符合最新材質指南的穿戴式裝置建構 UIJetpack Compose 可讓您以更少的程式碼編寫出更出色的應用程式。

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

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

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