ダイアログの見方
| 見た目 | 意味 |
|---|---|
| タイトルが「〜エラー」で帯が赤 | 何かが失敗した。下の目次からタイトルごとに対処を確認 |
| 本文 1 行目が GEM-L-001 など | Gemini まわりの不具合。問い合わせ時にコードを伝えると助けになる |
| OK だけ | 内容を読んで閉じる。多くはあとから同じ操作をやり直せる |
| 接続 画面の GEMINI 右の状態バッジ（タップ） | エラーではないこともある（OK や 接続中...）。赤や「未接続」は詳細の再確認用（帯の色はバッジに合わせる） |
まず試すこと（多くのエラーで共通）
- OK で閉じる（慌てて連打しない）
- インターネット（Wi‑Fi / モバイルデータ）が使えるか確認
- Gemini API キー — ギア → 接続 で保存済みか、Google AI Studio で有効か確認（取得手順・アプリへの設定）
- 少し時間をおいて もう一度（会話の再接続・記憶の整理は自動で再試行されることもある）
- 直らないときはダイアログの タイトル と コード（あれば） を控えて問い合わせ
Gemini エラー
いつ出る: 会話の 初回接続・再接続 に失敗したときなど。同じ原因では 最初の 1 回だけ 自動で出ることがあり、以降は上部マイクや 接続 画面の状態表示だけになることがあります。
認証失敗（GEM-L-002） は、自動の赤ダイアログが出ない場合があります。接続 画面のバッジが「認証失敗」のときは、バッジをタップして案内を確認してください（API キー）。
本文のコードから探す
| コード | だいたいどんなとき | すること |
|---|---|---|
| GEM-L-001 | API キーがまだ入っていない | 接続 でキーを貼り付け API キーを保存 |
| GEM-L-002 | キーが無効・誤り | AI Studio で確認し、接続 で正しいキーを再保存 |
| GEM-L-003 | オフライン・接続失敗 | ネットを直す → 話しかける／オンライン復帰で自動試行を待つ |
| GEM-L-004 | 接続タイムアウト | 通信環境を変え、しばらく待って再接続 |
| GEM-L-005 | サーバー準備のタイムアウト | しばらく待って再接続 |
| GEM-L-006 | 会話用モデルに届けなかった | ネット確認・時間をおいて再試行（キー問題なら GEM-L-002 を先に） |
| GEM-L-007 | Gemini 側の一時障害 | 数分〜十数分待って再接続 |
| GEM-L-008 | 自動再接続が続けて失敗 | ネット確認 → アプリ再起動 → 話しかけて再接続 |
会話が切れただけ（エラーではない）
| 状態 | 表示 | すること |
|---|---|---|
| セッションの時間切れなど | バッジやマイクが 発話待ち（琥珀色） | そのまま話しかける と再接続できる |
ネットワークに接続できない場合
画面上部の マイク が赤のまま、または 接続 の状態が「未接続」「エラー」になることがあります。ダイアログに GEM-L-003 などが出る場合も同系です。
- Wi‑Fi またはモバイルデータがオンか確認
- 機内モードがオフか確認
- ブラウザなどでインターネットに出られるか試す
- 接続が戻ったらアプリを開き直すか、接続 の状態バッジをタップして案内を確認
一度つながったあとに切れた場合、オンラインに戻ると自動で再接続を試みます。ミュート中・API キー未設定・認証失敗中は自動再接続されません。
API キーを間違えた・未設定の場合
キー未入力・コピーミス・無効化で、状態が「APIキー未設定」または「認証失敗」になり、会話を始められないことがあります（GEM-L-001 / GEM-L-002）。
- ギア → 接続 を開く
- GEMINI 欄をタップし、正しいキーを入力（前後の空白に注意）
- API キーを保存 をタップ
- 状態バッジが緑の OK になりキャラが表示されれば成功
キーが分からなくなった場合は Google AI Studio で新しいキーを作成し直してください。古いキーは無効化すると安全です。
記憶の整理エラー
いつ出る: 会話のあと、覚えた内容を Gemini で整理しようとして失敗したとき（しばらく無言のあと、接続が切れたあと、アプリを離れたあと、前回残した会話の再処理など）。会話そのものは続けられることが多く、整理だけが後回しになります。
| 本文の例 | だいたいどんなとき | すること |
|---|---|---|
| [GEM-R-003] + インターネットを確認… | 整理用の通信失敗 | ネット確認 → 会話を続けてもよい。記録は残り 次回起動で再整理。頻発する日は時間をおく |
| 記憶の整理結果を解釈できませんでした。 | 返答はあったが記憶用の形にできなかった | 急ぐ必要はない。繰り返す場合は時間をおくか、問い合わせ時にこの文言を伝える |
出ないのに記憶が増えないとき（利用上限）
API の 利用上限（レート制限） に当たった場合、アプリは このダイアログを出さず、会話記録を残してあとで再試行します（最大で約 10 分 待ってから再挑戦する動きになります）。
- 症状: エラーは出ないが「最終記録」が更新されない
- すること: 10〜30 分ほど待ってから再度使う。毎日続く場合は Google AI Studio で無料枠・利用量を確認
設定のエラー
いつ出る: 基本設定（名前・性格など）を保存・反映するとき、指示文の自動作成に失敗したときなど。
| 本文の例 | だいたいどんなとき | すること |
|---|---|---|
| 設定の読み取りに失敗しました。 | 端末内の設定を読めなかった | アプリ再起動。直らなければ問い合わせ |
| 設定の反映に失敗しました。 | 保存が完了しなかった | ネットとキーを確認 → もう一度保存 |
| [GEM-R-001] など | キー未設定 | 接続 でキーを保存 |
| [GEM-R-004] 利用上限 / 再試行待機（N 分） | API 回数制限 | 表示の分数待って再保存。頻発する日は利用量を確認 |
| [GEM-R-006] 有効な応答が… | 返答が空など | 時間をおいて再保存 |
| その他の短い説明 | 生成・保存の途中失敗 | ネット・キー確認 → 再試行 |
反映中は「設定を反映しています」と出ることがあります。完了まで待ってください。
キャラの設定エラー
いつ出る: キャラの保存・削除・切り替え・工場出荷状態への戻しなどができなかったとき。
| だいたいどんなとき | すること |
|---|---|
| 名前がプリセットと同じ | 別の名前で保存 |
| 保存・削除・切替の一般失敗 | 会話やモデル読み込みが終わってからもう一度 |
| 起動時のキャラ準備失敗 | アプリ再起動。ストレージの空きを確認 |
記憶・ToDo・会話ログ
記憶の 自動整理 の失敗（記憶の整理エラー）と、画面で消す操作の失敗は別です。
| タイトル | いつ出る | すること |
|---|---|---|
| 記憶のエラー | 記憶の表示・削除に失敗 | もう一度試す。アプリ再起動 |
| 記憶の整理エラー | 自動整理の失敗 | 記憶の整理エラー を参照 |
| ToDoのエラー | ToDo の追加・削除に失敗 | もう一度入力・削除 |
| 会話ログのエラー | ログの 1 行削除に失敗 | もう一度試す |
モデルのエラー・シーンのロードエラー
| タイトル | いつ出る | すること |
|---|---|---|
| モデルのエラー | VRoid Hub の準備・見た目の切替失敗など | Hub にログインできるか確認 → 通信を直す → 切替をやり直す |
| モデルの読み込みエラー（主に PC 版） | Hub から読み込めなかった | ネット・Hub 状態を確認して再試行 |
| シーンのロードエラー | プレイ用シーンの読み込み失敗 | アプリ再起動。空き容量を確認 |
その他の赤いエラー
| タイトル | いつ出る | すること |
|---|---|---|
| 指示文のエラー | 初期の指示文を開けなかった | もう一度開く。アプリ更新を確認 |
| 背景のエラー | カメラ背景・写真の読み込み失敗 | iOS の設定でカメラ許可。.png / .jpg など対応形式を選ぶ |
| サンプル音声のエラー | 声の試聴に失敗 | 会話がつながっているか・キーがあるか確認して再試行 |
| 人格設定のエラー（主に PC 版） | 性格設定の保存・生成失敗 | 設定のエラー と同様 |
| マイク感度調整のエラー（PC 版） | 感度調整に失敗 | マイク権限・デバイスを確認 |
困ったときのチェックリスト
| 順番 | 確認項目 |
|---|---|
| 1 | インターネットに接続できているか |
| 2 | 接続 で Gemini API キーが保存されているか（データの送信について に同意済みか） |
| 3 | マイク・カメラなど、OS のアプリの権限 |
| 4 | 同じエラーが何度も出る → 10〜30 分待つ（API 制限の可能性） |
| 5 | 記憶だけ更新されない → 出ないのに記憶が増えないとき |
| 6 | 会話だけ続けたい → 発話待ち なら話しかける。未接続 ならネットとキーを直してから再接続 |