Appearance
よくある質問とトラブルシューティング
配信の準備中や配信中に発生しやすいトラブルの解決策をまとめています。
1. OBS Studio 関連
Q. OBS のブラウザソースに何も表示されない、または画面が真っ黒になる
- 確認 1：
yt-reaction-counter.exe（黒いコンソール画面）が起動しているか確認してください。 - 確認 2：OBS Studio の ブラウザソース のプロパティで、URL が正しく入力されているか確認してください。
- リアクションカウンター：
http://localhost:53023/overlay - エモート演出オーバーレイ：
http://localhost:53023/overlay_emote - 特典演出オーバーレイ（特典版のみ）：
http://localhost:53023/overlay_special - 起動時のコンソール画面に別のポート番号が表示されている場合は、そのポート番号に合わせて指定してください。
- リアクションカウンター：
- 解決策：OBS Studio のソースプロパティ画面で「現在のページのキャッシュを更新」ボタンをクリックしてください。
Q. アップデート後にOBSのカスタムブラウザドックで表示が崩れる、または更新されない
本ツールのアップデート後、OBS Studio の カスタムブラウザドック に配置した コントロールパネル の表示が崩れたり、以前の画面のまま更新されなかったりすることがあります。 垂直スクロールバーが表示されず下部のボタンを押せない場合もこれに該当します。 その場合は、以下の手順で画面を再読み込みしてください。
- コントロールパネルのドック内を右クリックして「再読み込み」をクリックしてください（またはドックを選択して
Ctrl + Rキーを押してください）。 - 表示が直らない場合は、OBS Studio の上部メニュー「ドック」から「カスタムブラウザドック」を開き、「適用」をクリックしてください。
- それでも改善しない場合は、OBS Studio を再起動してください。
Q. ポートが使用中と表示されて起動できない、または複数の配信枠で同時に使いたい
- 本ツールは OBS Studio 側の URL が変わるのを防ぐため、初回起動時に決めたポート番号（初期値：
53023）をdata/settings.jsonに記録して固定ポートで動作します。 - 起動時に「ポートは既に使用中のため起動できません」と表示された場合は、すでに本ツールまたは別のアプリがそのポートで動いています。 ブラウザで開いているコントロールパネル右上の「インスタンス管理」ボタンから、稼働中のインスタンスの接続先を確認したり、「インスタンス終了」ボタンで不要なインスタンスを終了したりできます。
- 2枠以上の配信で同時に複数のインスタンスを起動したい場合は、本ツールのフォルダごと複製し、コントロールパネルの「インスタンス管理」または
data/settings.jsonの"port"に別の番号（例：53024）を設定してください。 1つのコントロールパネル画面から、稼働中のすべてのインスタンスを確認・終了し、それぞれのコントロールパネルを開くことができます。
2. YouTube Live 接続関連
Q. リアクションのカウントが増えない、または反応しない
- 確認 1：YouTube Live の配信が「公開」または「限定公開」に設定されているか確認してください（非公開配信ではデータが取得できません）。
限定公開で配信する場合
限定公開の配信は、チャンネルのハンドルやチャンネルIDではなく、配信URL で接続する必要があります。
- 確認 2：入力した配信URLやハンドルが正しいか確認してください。
- 確認 3（テスト発火による切り分け）：本ツールのトップ画面にはテスト発火用のボタンを常設していません。 テストを行う場合は、コントロールパネルのモジュール一覧にある「テスト」ボタンをクリックしてください。 開いた「動作TEST FIRE・シミュレーター」画面からテスト用のリアクションボタンをクリックします。 OBS Studio 側のオーバーレイ表示が動く場合は YouTube 接続側の問題、動かない場合は OBS Studio のブラウザソース URL 設定の問題と切り分けることができます。 なお、動作確認ツール（
yt-reaction-checker）にはテスト発火ボタン自体がありません。 実際の YouTube 配信画面でリアクションを送信し、シグナルランプが点灯するかを確認してください。
Q. 配信枠を移動（枠替え）したときの切り替え手順
- ハンドルやチャンネル名で接続していた場合は、一度コントロールパネルの「DISCONNECT」ボタンをクリックして切断してください。 その後、再度「CONNECT」ボタンをクリックすると、自動的に新しいアクティブな配信枠へつながります。
- コントロールパネル上部の入力欄に新しい配信枠の URL を入力し、「CONNECT」をクリックして接続することも可能です。
- 動作確認ツールの場合は、「切断する」ボタンをクリックしてから新しい枠の情報を入力し、「接続する」ボタンをクリックしてください。
Q. アプリを起動すると、勝手に前のチャンネルに接続されてしまう
- 本ツールは利便性のため、起動時に前回のチャンネルへ自動接続する設定が有効になっています。
- コントロールパネル上部の接続エリアにある「起動時に自動接続」のトグルスイッチをクリックしてオフ（灰色）にしてください。 これにより、起動時の自動接続を停止できます。
3. アプリ起動とシステム関連
Q. Windows SmartScreen（青い画面）で起動がブロックされる
- 画面内の「詳細情報」をクリックします。
- 右下の「実行」をクリックします。 ※ 個人開発の未署名アプリのため初回に表示されますが、一度実行すると次回以降は表示されなくなります。
Q. セキュリティソフトで誤検知（False Positive）された
- 単一の
.exe実行ファイルとしてパッケージ化しているため、一部のセキュリティソフトで誤検知される場合があります。 - お使いのセキュリティソフトの管理画面を開き、本ツールのフォルダを除外設定に追加してください。
4. 免責事項とアップデート
YouTube の仕様変更について
- 本ツールは YouTube の公開データおよび画面仕様に依存しています。
- YouTube 側の仕様変更や制限などにより、予告なく一部または全機能が利用できなくなる可能性があります。
- 仕様変更への対応やアップデート情報は、公式サイトおよび配布元（BOOTH など）のお知らせにてご案内します。
5. 解決しない場合のお問い合わせ
上記の手順を試しても問題が解決しない場合や、不具合の報告、機能追加のご要望などは、公式サイトのお問い合わせフォームよりご連絡ください。