KeyMod ▾

KeyMod チュートリアル - トラブルシューティング

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

Android の KeyCmd アプリに関する一般的な問題と解決策。

接続の問題

接続されていません

症状 ソリューション
「未接続」 インジケータ ケーブル接続を確認してください。再度差し込んでみてください。 BLE の場合は、Bluetooth のオフ/オンを切り替えて、再ペアリングします。
USB 許可が拒否されました Android 設定 → アプリ → KeyMod → 権限 → USB を有効にします。ケーブルを再度差し込みます。
Bluetooth がペアリングされません Bluetooth のオフ/オンを切り替えます。 Bluetooth 設定でデバイスを忘れて、再度ペアリングします。 KeyMod デバイスがペアリング モードになっていることを確認してください。
接続が頻繁に切断されます アプリでBLE buttonの下にあるRSSIの値を確認してください。 -75 dBm 未満は信号が弱いことを示します。近くに移動してください。物理的な障害物を取り除きます。

接続状態インジケーター

インジケーター 意味
接続済み 緑色のアイコン — 入力を送信する準備ができています
接続中 黄色のアイコン — 接続中
切断されました 灰色のアイコン - アクティブな接続がありません
信号バー BLE信号強度またはUSBアクティブステータス

自動接続

接続ダイアログで 「起動時に自動接続」 を有効にします。 KeyMod は、最後の接続タイプ (USB または BLE) と最後にペアリングした BLE デバイスを記憶します。

USB 着脱検出

KeyMod は、Android の USB のアタッチ/デタッチ ブロードキャスト イベントを監視します。 USB ケーブルを取り外すと、接続ステータスがすぐに更新されます。自動接続が有効になっている場合、再接続すると再接続が試行されます。

キーボードの問題

キーが登録されていません

症状 ソリューション
キーが送信されません 接続が「接続済み」(緑色) と表示されていることを確認します。モードを切り替えたり戻してみたりしてください。ターゲット コンピュータが KeyMod デバイスをキーボードとして認識していることを確認します。
マクロが実行されません 接続されていることを確認してください。マクロ データに有効なトークンが含まれていること (トークン名のタイプミスがないこと) を確認してください。
間違った文字が表示されます ターゲット OS 設定を確認してください。OS が一致しないと、キー マッピングの問題が発生する可能性があります。ターゲット コンピュータのキーボード レイアウト (QWERTY と AZERTY) を確認します。

Unicode 文字が機能しない

非 ASCII 文字 (中国語、日本語、絵文字) には、OS 固有の入力方法が必要です。

OS 方法
Windows Alt+NumPad 16 進 Unicode 入力
Linux Ctrl+Shift+U の後に 16 進コードが続く
macOS Option+16 進数入力

Unicode 文字が正しく表示されない場合は、ターゲット OS が正しく設定されていることを確認してください。

TouchPad 問題

症状 ソリューション
Touchpad 応答がありません 設定で触覚フィードバックが有効になっていることを確認します。 TouchPad ヘルプ オーバーレイ (?) を試して、ジェスチャのサポートを確認してください。
スクロールが機能しない 「設定」→「一般」でtouchpadのスクロール感度を確認してください。

音声入力の問題

音声認識機能が利用できません

Play ストアから Google 音声入力をインストールします。 Android 11+ では、KeyMod にはクエリ権限が必要です (APK に含まれています)。

無音検出が機能しない

症状 ソリューション
話していないときでも録音は継続されます [無音時の自動一時停止] トグルをオンにします。周囲のノイズを低減します。マイクに近づいてはっきりと話してください。
録音はすぐに停止します もっと大きな声で話すか、無音検出のタイムアウトを減らしてください。

音声テキストが送信されない

接続状態を確認してください。接続されていない場合、「送信」button は無効になります。

AI の問題

API キーが機能しない

症状 ソリューション
「API キーが設定されていません」 API キーが正しいことを確認します。余分なスペースやタイプミスがないか確認してください。 API ベース URL を確認します。フルパス (例: https://api.openai.com/v1) を含める必要があります。モデル名がプロバイダーに存在することを確認します。ローカルプロバイダー (Ollama) の場合は、API Key Optional フラグが設定されていることを確認してください。

テキストの絞り込みが遅い

ネットワーク接続を確認してください。より高速なモデルを試してください。より小さいモデル (gpt-3.5-turbo、llama3-8b) の方が応答が速くなります。ネットワーク遅延を排除するには、ローカルプロバイダー (Ollama) を使用してください。 AI リクエスト履歴でエラー メッセージを確認してください。

さらにサポートが必要ですか?

まだ問題が解決しない場合: