# トラブルシューティング

## インジケーターが表示されない

### 特定のアプリでだけ出ない

キャレット位置は次の2経路で取得しており、どちらも提供しないアプリでは表示できません。

1. システムキャレット(`GetGUIThreadInfo`)— 従来型のエディットコントロール
2. UI Automation の TextPattern — Chrome・Windows Terminal などの独自描画エディタ

動作確認済み: メモ帳・Firefox・Chrome・Windows Terminal。
独自描画で UIA も実装していないエディタ(一部の Electron アプリ・ゲーム内の入力欄など)は
原理的に対応できません。

### どこにも出ない

よくある順に:

- **IMEがオフ** — 既定では「IMEオフ」は非表示(素のキャレットのまま)です。仕様であり、
  設定画面で「IMEオフ」の表示をオンにすれば出せます
- **一時停止中** — トレイアイコン右クリック →「一時停止」のチェックを確認してください
- **管理者権限で動くアプリ** — UIPI の制約により、昇格したプロセスからは IME 状態と
  キャレット位置を取得できません
- **排他フルスクリーン(ゲーム等)** — 最前面オーバーレイ自体が表示されません

### 録画・画面共有に映らない

インジケーターは対象アプリとは**別の**最前面ウィンドウなので、**ウィンドウ単位**の
キャプチャには映りません:

| 方式 | 映る? |
|---|---|
| Game Bar (Win+G)、OBS ウィンドウキャプチャ、Teams/Zoom のウィンドウ共有 | 映らない |
| OBS 画面キャプチャ、全画面共有、PrtScr、スクリーンショット | 映る |

裏を返すと、ウィンドウ共有では入力モードの表示が相手に見えません(プライバシー上は利点)。

## 二重に表示される

Windows 標準のテキストカーソルインジケーター(EoAExperiences.exe)と併用しています。
設定画面の上部に警告と停止ボタンが出るので、そこから停止してください
(または Windows 設定 → アクセシビリティ → テキストカーソル でオフ)。

## モードの色・バッジがおかしい

判定できない変換モードは「その他」として表示します。Microsoft IME 以外
(Google 日本語入力など)も IMM32 互換で概ね動作しますが、独自のモード値を返す IME では
「その他」の色/バッジになることがあります。「その他」の見た目も設定画面で変更できます。

## サインイン時に自動起動しない

自動起動は登録時の exe の**絶対パス**で動きます。exe を移動・改名した場合は、
移動先から一度手動起動すれば登録先が自動で追随します(設定画面にも登録先パスと
再登録ボタンがあります)。

## それでも解決しないとき

[Issues](https://github.com/Hinaser/is-ime-on/issues) へ次の情報を添えて報告してください:

- 症状が出るアプリ名(ウィンドウタイトルではなくアプリ名)
- IME の種類(Microsoft IME / Google 日本語入力 など)
- Windows のバージョン(`winver` で確認)