1. はじめに
ImmiChangeにアクセスしていただき、ありがとうございます。
このアプリは、「iOSの標準機能にあるような、ロック画面や壁紙の自動切り替えをAndroidでも実現したい」という想いから開発されました。スマホを開くたびに新しいお気に入りの写真に出会える、あの心地よい体験をAndroidユーザーの皆様にお届けすることを目指しています。
当初はGoogleフォトとの直接連携を目指しましたが、APIの厳しい制限により断念しました。しかし、その代わりに「Localモード」を実装することで、独自のImmichサーバーをお持ちでない方でも、Googleフォトから手動で選んだ写真を使って同様の体験を楽しめるように工夫しています。
2. 初期設定（セットアップ・ウィザード）
アプリを初めて起動すると、いくつかの設定をお願いしています。これらはアプリが正しく機能するために最小限必要なものです。
権限と初期設定を求める理由
- 通知権限: 壁紙の更新状況や、サーバーとの同期エラーをお知らせするために使用します。
- バッテリー消費の最適化解除: Androidのシステムによってアプリが強制終了されるのを防ぎ、バックグラウンドで壁紙を更新し続けるために必要です。
- 自宅Wi-Fi (SSID) の設定: Immichサーバーとの同期を「自宅にいる時だけ」に限定し、外出先でのパケット消費をゼロにするために使用します。
Immichサーバー設定
Immichモードを使用する場合、以下の設定が必要です。（※ローカル写真モードのみを使用する場合は、設定せずにスキップ可能です）
- Server URL: あなたのImmichインスタンスのURL（http://...）
- API Key: サーバーから安全に写真を読み込むための鍵です。
【必要な権限詳細】
ImmichのAPIキーには、以下の5つのスコープ（権限）が含まれている必要があります：
- album.read: アルバム内のアセット一覧取得用
- asset.read: アセットのメタデータ確認用
- asset.view: 画像のプレビュー表示用
- asset.download: 画像実体のダウンロード用
- server.about: 自宅Wi-Fi内での疎通確認用
3. アプリの使い方（各モード解説）
ホーム画面にある「Dashboard」から、好みのモードを選択できます。
Immich (サーバー) モード
あなたのImmichサーバー上のアルバムから、写真を自動的に取得して壁紙にします。
- 自宅Wi-Fiでの更新: 外出先でのパケット消費を抑えるため、指定した自宅Wi-Fiに接続されている時だけ新しい写真をダウンロードします。
- キャッシュ管理: 指定した容量（MB）の範囲で、写真を賢く入れ替えます。
【Tips: 更新がうまくいかない場合】
サーバーへの接続に失敗した場合、アプリは「指数バックオフ」という仕組みで再試行します。
1. 失敗すると通知でお知らせし、最初は2分後、次は4分、8分...と間隔を広げて再試行します。
2. 最終的に接続できない場合は、アプリから「接続を確認してください」という詳細な通知を送ります。
Local (ローカル) モード
端末内の写真やGoogleフォトから選択した写真を壁紙にします。
- 安定性のためのコピー: 選択された写真は、一度アプリ専用の領域にコピーされます。これにより、元のファイルを削除したり移動しても、壁紙が消えることはありません。
- Photo Manager: 取り込んだ写真は「Manager」から一覧確認できます。長押しすることで複数選択して一括削除も可能です。
ストレージに関する注意：
ローカルモードは端末に写真をコピーするため、大量に追加するとその分スマホの容量を消費します。不要になった写真はManagerから削除してください。
設定項目の名称と意味
- 切り替えタイミング (Update Interval): 壁紙が切り替わるトリガーを設定します。
- 画面OFFで切り替え (On Screen Off):
画面を消して次に開いた時に、自動で壁紙が変わります。iOSの挙動に最も近い、おすすめのモードです。
- 指定時間で切り替え: 指定した間隔（分、時間、日単位）で定期的に壁紙が変わります。
- 圧縮率 (Compression): 画像をコピーする際の画質です。75%程度にすると、見た目の美しさを保ちつつ容量を節約できます。
- ストローク強度 (Stroke): ライブ壁紙使用時、スワイプでどれくらい写真が動くかを設定します。
PRO
4. Proモード（究極のパーソナライズ）
Pro版にアップグレードすることで、あなたのスマホを世界に一つだけのプレミアムなギャラリーへと変貌させます。
- ライブ壁紙エンジン (Fluid Engine):
通常の壁紙とは一線を画す、120FPS対応の独自エンジンを搭載。ホーム画面のスワイプに合わせて写真が滑らかに追従し、パノラマ写真もその魅力を余すことなく堪能できます。
- 高度な日付表示設定 (Advanced Date):
撮影日時の表示位置を、0〜100%の精度で自由自在に配置可能です。設定画面内のスマホ型リアルタイム・プレビューにより、実際の表示を確認しながら微調整できます。
- インテリジェント・コントラスト: 日付の配置場所の背景をアプリが賢くサンプリングし、視認性が最も高くなるよう文字色（黒・白）を自動で切り替えます。
- Monet (Material You) 完全同期: Android
12以降のダイナミック・カラーに対応。壁紙の色を抽出してシステム全体やアプリのUIカラーを自動生成するため、常に高い一体感を楽しめます。
- 自動切り替えの連動: 通常壁紙と同様に、画面オフや時間間隔での自動切り替えがライブ壁紙でもシームレスに作動します。
- 複数アルバムの同時指定: Immichモードにおいて、複数のアルバムから写真をミックスして表示できるようになります。
PRO
5. 撮影日時へのこだわり (Metadata Precision)
ImmiChangeは、写真の「思い出」としての価値を大切にしています。単なる画像表示ではなく、その写真がいつ撮られたものかを正確に伝えるための仕組みを構築しています。
- 正確な撮影日の抽出: Immichサーバー上の「ファイル作成日時」を優先的に読み込みます。サーバーへの登録日ではなく、実際にシャッターを切ったその瞬間を記録します。
6. Trial (お試し) モード
「ライブ壁紙をまずは見てみたい」という方向けの機能です。
- ピッカーで選んだ1枚の固定写真で、いつでも何度でもライブ壁紙の動作を確認できます。
- Pro版を購入する前に、ご自身の端末での滑らかさ（120FPS対応）をぜひ体験してみてください。
6. 設計のこだわり
- 120FPS対応: 高速なハードウェア描画により、バッテリー負荷を抑えつつ最高の滑らかさを追求しています。
- プライバシー保護: 取得した写真データやAPIキーは、あなたの端末内のみに保存され、外部に送信されることはありません。
