メインコンテンツまでスキップ

トラブルシューティングとFAQ

このページでは、GameSentenceMiner（GSM）の使用中に遭遇する頻繁な質問と一般的な問題について説明します。

ヒント

多くの問題は、GSMとOBS Studioを再起動するだけで解決します。問題が発生したらまずこれを試してください。PCの再起動も役立つ場合があります。GSMは個人プロジェクトなので、対応に時間がかかることがあります。

インストールと起動​

GSMがクラッシュするか、起動時に初期化に失敗する​

これは、破損したアップデートや他のソフトウェアとの競合が原因であることが多いです。

  • Razerソフトウェアの競合: Razer Synapse / Cortexは、GSMもデフォルトで使用するポート55000を使用することが知られています。これにより、GSMのWebサーバーが起動せず、ハングアップまたは失敗する原因となります。
    • 解決策1（推奨）: GSMのポートを変更します。設定 -> 一般に移動し、Webサーバーポートを別の番号（例: 55010）に変更します。
    • 解決策2: GSMを開始する前に、すべてのRazerソフトウェアを終了します。
  • 破損したアップデート: module 'psutil' has no attribute 'NoSuchProcess'やcannot import name 'Image' from 'PIL'のようなエラーが表示されることがあります。
    • 解決策: 上記のPython環境の修復の手順に従ってください。

GSMのインストール場所が見つからない。C:ドライブにしかインストールされない。​

現在、GSMのインストールパスはカスタマイズできません。ユーザーデータ、OBS、およびPythonパッケージは%AppData%\GameSentenceMinerに保存されます。

OBSとメディア（音声/スクリーンショット）​

OBSでゲーム画面が真っ黒に表示される​

これは一般的なOBSの問題で、特に積極的なアンチチートを持つゲームや排他的フルスクリーンで実行されるゲームで発生します。詳細なリストはこちらを参照してください。

  • 管理者として実行: 多くのゲーム（特に原神のようなHoyoverseのタイトル）は、キャプチャするためにOBSを管理者権限で実行する必要があります。これを行う最も簡単な方法は、GSM自体を管理者として実行することです。
  • キャプチャ方法の変更: OBSウィンドウで、ゲームソースをダブルクリックします。キャプチャ方法を自動からWindows 10 (1903 and up)に変更します。
  • ゲームキャプチャを使用: ウィンドウキャプチャが失敗した場合は、代わりに「ゲームキャプチャ」ソースで新しいシーンを作成してみてください。
  • ソースの表示/非表示を切り替える: OBSでソースの横にある「目」のアイコンをクリックして非表示にしてから再度表示するだけで、黒い画面が修正されることがあります。

Ankiカードに音声やスクリーンショットがない​

これは通常、GSMがOBSと通信できないか、リプレイバッファが正しく機能していないことを意味します。

  • 「リプレイバッファがアクティブではありません」エラー: これが最も一般的な原因です。
    1. OBSウィンドウを確認します。「リプレイバッファを開始」ボタンが青色で「リプレイバッファを停止」と表示されているはずです。そうでない場合は、クリックしてください。
    2. GSMには自動リプレイバッファ管理が含まれています。OBSで黒以外の画像が検出されたときにバッファを開始し、非アクティブ期間の後に停止するはずです。これが失敗した場合、通常はGSMの再起動で修正されます。
  • OBSが切断された: GSMのホームページのステータスインジケーターを確認します。OBSが切断されている場合は、GSMの設定 -> OBSのポートとパスワードが、OBSのツール -> WebSocketサーバー設定の設定と一致していることを確認してください。一般的な問題は、別のプログラムがデフォルトのOBSポート（7274）を使用していることです。GSMとOBSの両方で別の番号に変更してみてください。

カードの音声が間違っている（BGMのみ、間違ったセリフなど）​

これはしばしば音声区間検出（VAD）の問題で、モデルが背景音楽やノイズから音声を区別するのに苦労しています。

  • Whisperの幻覚: 特にボーカル付きの音楽や無音のゲームセリフがある場合、Whisperは音声がない場所で音声を「幻覚」として検出することがあります。
    • 解決策: 設定 -> VAD / 音声に移動し、VADプレフィルターを使用を有効にします。これにより、Whisperに送信する前に音声を処理してノイズを除去し、精度を大幅に向上させることができますが、非常に高音の声を時々カットすることがあります。
  • 音声が途切れる（開始/終了）:
    • 解決策: 設定 -> キー設定 / 音声で開始オフセットと終了オフセットを調整します。開始オフセットに小さな負の値（例: -0.5）を設定すると、セリフの開始をキャプチャするのに役立ちます。
  • 二重音声 / エコー: これは、OBSが特定のゲームの音声と一般的な「デスクトップ音声」の両方をキャプチャしている場合に発生します。
    • 解決策: OBSウィンドウの「音声ミキサー」パネルで、「デスクトップ音声」トラックをミュートします。

OCR（テキスト認識）​

OCRが機能しない、または開始に失敗する​

  • 「認識されない引数」エラー: これは、GSMデスクトップアプリのバージョンとPythonパッケージのバージョンが同期していない場合に発生します。
    • 解決策: ファイル -> GSMを更新メニューからGSMを更新します。これにより、両方のコンポーネントが互換性のあるバージョンになります。
  • oneocrファイルが見つからない: OneOCRは、追加のモデルファイルをダウンロードする必要があります。
    • 解決策: OCRタブで、OWOCR依存関係のインストール/更新ボタンをクリックします。これが失敗した場合は、手動でファイルをダウンロードし、C:/Users/your_username/.config/oneocrに配置する必要があるかもしれません。
  • エリア選択が機能しない:
    • 問題: 「エリアセレクターを実行」を使用すると、画面オーバーレイが表示されますが、保存できないか、すぐに失敗します。
    • 解決策: OCRタブで誤ったOBSシーンまたはOBSシーンが選択されていないことが原因である可能性があります。セレクターを実行する前に、正しいシーンが選択されていることを確認してください。

OCRが不正確または不完全なテキストを返す​

  • テキストがゆっくり表示される: テキストがフェードインまたはスクロールインする場合、OCRは完全な行が表示される前にスキャンする可能性があります。
    • 解決策: 設定 -> OCR -> 追加とデバッグで、スキャン遅延を増やします。1.0（1秒）の値は、多くの場合、良い出発点です。
  • ふりがなが読み取られる:
    • 解決策: OCRタブのふりがなフィルター感度スライダーを使用します。値が高いほど、メインラインの上の小さなテキストをより積極的に削除します。この変更を有効にするには、OCRプロセスを再起動する必要があります。
  • テキストが分割または複製される: これは、ピクセル化されたテキスト（DSゲームなど）や高速なスキャンレートでよく発生します。
    • 解決策: OCRスキャンレートをより高い数値（例: 0.8または1.0）に増やして、画面が安定する時間を長くしてみてください。2回目のスキャンを最適化を無効にすると、パフォーマンスが低下する代わりに役立つこともあります。

オーバーレイ​

オーバーレイが表示されない、または更新されない​

  • デフォルトでは自動ではない: オーバーレイのOCRスキャンは、Agent、Textractor、またはGSM独自のOCRなどのソースからの新しいテキストイベントによってトリガーされます。定期的キャプチャを有効にしない限り、常時スキャンは行いません。
    • 解決策: テキストフックのないメディア（マンガやビデオなど）の場合、オーバーレイ設定タブで定期的キャプチャを有効にします。
  • ゆっくり表示されるテキスト: メインのOCR問題と同様に、テキストがフェードインする場合、オーバーレイは早すぎるタイミングでスキャンする可能性があります。
    • 解決策: オーバーレイ設定のスキャン遅延またはイベントごとの追加ローカルスキャンオプションを使用して、最終スキャンの前にテキストが完全に表示される時間を確保します。
  • フォーカスの問題: 排他的フルスクリーンの一部のゲームでは、マウスが「トラップ」され、オーバーレイと対話できなくなることがあります。
    • 解決策: **手動モード（ホットキー）**を有効にします。これにより、キーを押したままにしてオーバーレイを有効にし、ルックアップを行い、キーを離してゲームにフォーカスを戻すことができます。

統合（Yomitan、Migaku、Anki）​

Ankiカードに文の一部しか表示されない​

これはYomitanの問題であり、GSMの問題ではありません。Yomitanは句読点に基づいて文を分割します。

  • 解決策: Yomitanの設定の解析で、文の終端文字を改行のみに変更します。この設定でテキストフッカーページ専用のYomitanプロファイルを別途作成することを強くお勧めします。

Migaku拡張機能がセンテンスマイニングを妨害している​

Migakuブラウザ拡張機能は、テキストフッカーページのHTMLを大幅に変更するため、Yomitanが文を解析する方法に干渉する可能性があります。

  • 解決策: Yomitanの設定のスキャンで、レイアウト認識スキャンを有効にするオプションをオフにします。これにより、通常は問題が解決します。

OpusオーディオファイルがAnki for iOSで再生されない​

Anki on iOSはOpusオーディオ形式をサポートしていません。

  • 解決策: GSMの設定 -> 音声で、音声出力拡張子をmp3に変更します。既存のカードについては、FFmpegスクリプトを使用して.opusファイルを.mp3にバッチ変換する必要があるかもしれません。