確認アニメーションは、ユーザーが操作を完了したときに視覚的なフィードバックを提供します。ユーザーがひと目で確認できるよう、画面全体に表示されます。
ほとんどの場合、確認アニメーションを別途使用する必要はありません。詳細については、設計の原則をご覧ください。
Jetpack ウェアラブル UI ライブラリには、アプリに確認アニメーションを表示する ConfirmationActivity が用意されています。
確認アニメーションを表示する
ConfirmationActivity は、ユーザーがウェアラブルで操作を完了した後に確認アニメーションを表示するために使用されます。
確認には次の 3 つのタイプがあります。
- 成功: ウェアラブルで操作が正常に完了しました。
- 失敗: 操作の完了に失敗しました。
- スマートフォンで開く: 操作の結果、スマートフォンに表示する必要があるコンテンツが存在しています。この操作を完了するには、ユーザーがスマートフォンで操作を続行する必要があります。
ユーザーがアプリ内で操作を完了したときに確認アニメーションを表示するには、アクティビティのいずれかから 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 が終了してアクティビティが再開されます。