# ウィジェット

Cakeday は、今後の誕生日をホーム画面、ロック画面、Apple Watch に広げて表示します。対応するシステムバージョンでは、コントロールセンターや Dynamic Island の Live Activity にも表示でき、重要な日付をより多くの場所から確認できます。これらの表示面はアプリの日付形式設定を引き継ぎ、データ変更後も自動的に更新されます。

## ホーム画面ウィジェット

Cakeday には複数の異なるホーム画面ウィジェットがあり、それぞれウィジェットギャラリーに個別に並びます。ウィジェットを追加するときは、まず名前で目的のものを選び、そのウィジェットが対応するサイズから選びます：

- **次の誕生日：** 次に近い誕生日を中心に、アバター、名前、カウントダウン、年齢を表示します。小、中、大、特大に対応しています。
- **誕生日リスト：** 今後の誕生日をコンパクトな一覧で表示します。小と中に対応しています。
- **誕生日カレンダー：** カレンダーのグリッドで誕生日を見渡します。小、中、大、特大に対応しています。
- **スタンバイカウントダウン：** スタンバイ向けのサイズに合わせた大きな誕生日カウントダウンです。中のみに対応しています。
- **月の進み具合：** 日が進むにつれて誕生日が灯り、その月の様子をひと目で把握できます。小のみに対応しています。
- **誕生日カバー：** 今日の誕生日を、今後の誕生日のグリッドの上に大きく表示します。iOS 27 以降の特大（縦）サイズに対応しています。

  ほとんどのウィジェットは、特定の人やグループに絞り込めます。ウィジェットを長押しして
  **ウィジェットを編集** をタップし、**表示モード** を
  **次の予定**、**特定の人**、 **グループ** に設定します。**特定の人** または
  **グループ** を選んだ場合は、その下で 対象の **人** または **グループ**
  を選びます。

## ロック画面ウィジェット

**次の誕生日** と **誕生日リスト** は、ロック画面ウィジェット（時計の上または下に配置）としても使えます。3 つのアクセサリスタイルがあります：

- **円形：** 次の誕生日のアバターやカウントダウンを表示するコンパクトなリングです。
- **長方形：** 名前とカウントダウンの行を表示する小さなカードです。
- **インライン：** 時計の横に並ぶ 1 行のテキストです。

ホーム画面ウィジェットと同様に、ロック画面ウィジェットも編集して **特定の人** を固定したり、**グループ** に絞り込んだりできます。

## コントロールセンターのコントロール

対応するシステムバージョンでは、Cakeday は高頻度の操作向けに複数のコントロールセンターのコントロールに対応しています：

- **誕生日を追加：** 新規追加フローを直接開きます。
- **近日中の誕生日：** 直近の誕生日を表示し、特定のグループに合わせて設定することもできます。
- **誕生日カウントダウン：** 選んだ1人を固定し、その人専用のカウントダウンを表示します。

これらのコントロールを使うと、特に誕生日を頻繁に管理する場合に、意図から操作までの手数を減らせます。

## Live Activity と Dynamic Island

Cakeday には、ある人の誕生日までをカウントダウンする **誕生日カウントダウン** の Live Activity があります。その人のアバター、名前、対象の日付、リアルタイムのカウントダウンタイマー、進捗バーを表示し、当日になるとお祝いの表示に切り替わります。

- **ロック画面** では、カウントダウンはカードとして表示され、タップするとその人の詳細を開けます。
- **Dynamic Island** では、拡張、コンパクト、最小の各表示に合わせて変化し、他のアプリを使っている間もカウントダウンを表示し続けます。

このカウントダウンは、日が近づくにつれて誕生日アラームと並行して動作します。

  

[誕生日アラーム](/docs/ja/birthday-alarm)

    アラームを設定し、カウントダウンの Live Activity
    をどれだけ早く始めるかを選びます。
  

## Apple Watch

Cakeday には独立した Apple Watch アプリと文字盤コンプリケーションがあり、手首から今後の誕生日、人物の詳細、カウントダウンを確認できます。

日付形式の設定は iPhone から Apple Watch にも反映されるため、Watch アプリ、ウィジェット、メインアプリの並び順をそろえられます。

対応する入口では、コンプリケーションや一覧項目をタップして対象の人物へ直接移動できます。より大きな画面が必要な場合は、Cakeday は iPhone 側へ流れを引き継ぐこともできます。

## 追加と設定の方法

**ホーム画面ウィジェットを追加**

ホーム画面にウィジェットを追加するには、ホーム画面を長押しし、左上の **+** ボタンをタップして「Cakeday」を検索し、サイズを選んで好きな場所に配置します。

**コントロールセンターのコントロールを追加**

対応するシステムバージョンでは、コントロールセンターのコントロールをシステムのコントロールセンター編集画面から追加できます。コントロールによっては、グループの選択や特定の人の指定など、追加設定も可能です。

## 更新のしくみ

Cakeday で誕生日を追加、編集、削除すると、アプリは関連するウィジェットやコントロールの更新を要求します。Apple Watch のデータもあわせて同期され、連携する表示面が最新の状態に保たれます。

実際の更新タイミングは、システムのスケジュール、バッテリー状況、ウィジェットの更新予算に左右されるため、反映まで少し時間がかかることがあります。
