Wear で確認を表示する

確認アニメーションは、ユーザーが操作を完了したときに視覚的なフィードバックを提供します。ユーザーがひと目で確認できるよう、画面全体に表示されます。

ほとんどの場合、確認アニメーションを別途使用する必要はありません。詳細については、設計の原則をご覧ください。

Jetpack ウェアラブル UI ライブラリには、アプリに確認アニメーションを表示する ConfirmationActivity が用意されています。

確認アニメーションを表示する

ConfirmationActivity は、ユーザーがウェアラブルで操作を完了した後に確認アニメーションを表示するために使用されます。

確認には次の 3 つのタイプがあります。

• 成功: ウェアラブルで操作が正常に完了しました。
• 失敗: 操作の完了に失敗しました。
• スマートフォンで開く: 操作の結果、スマートフォンに表示する必要があるコンテンツが存在しています。この操作を完了するには、ユーザーがスマートフォンで操作を続行する必要があります。

ユーザーがアプリ内で操作を完了したときに確認アニメーションを表示するには、アクティビティのいずれかから 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 が終了してアクティビティが再開されます。