<!-- TStar documentation · ja · canonical HTML: https://tstar.stream/ja/docs/troubleshooting -->

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

配信の前後で特につまずきやすい6つの状況について、チェックリストの順に確認していけば解決できます。

## 配信に接続できない

**配信中に突然切断された**場合:コンソールが自動的に検知して再接続します。切断中はスコアが一旦凍結され、勝手に変動することはないので、手動での対応は不要です。以下は**最初から接続できない**場合の確認手順です。

1. まずコンソール下部の接続バーが警告色になり「先にバックエンドへ接続してください」と表示されていないか確認してください——これはコンソール自体がまだ TStar のスコア集計サービスに接続できていないという意味で、TikTok アカウントの問題ではありません。もっとも多い原因は**PCのウイルス対策ソフトやファイアウォールが通信をブロックしている**ことなので、まずこれを確認してください。
2. 設定ページの「デバイス情報」で「ライセンス状態」が「有効」になっているか確認してください。「再アクティベートが必要」と表示されている場合は、先にライセンスキーを確認してください(次のセクション参照)。
3. 接続したい TikTok アカウントが**今まさに配信中**か確認してください——TikTok LIVE のルームは配信中しか存在しないため、配信開始前や終了後は接続できません。
4. ネットワーク自体が安定しているか確認してください。
5. 上記すべて問題ないのに接続できない場合、接続サービス側で一時的な流量制限が発生している可能性があります。1〜2分待ってから再度「接続」を試すと解決することがほとんどです。

それでも解決しない場合は、サポートへ連絡するのが一番早いです。

## 配信画面にオーバーレイが表示されない

1. コンソールに戻り、今使っているゲームのリンクを再度コピーしてください(画面上部ナビの「ウィジェットURLをコピー」ボタンを押すと「🔗 ウィジェットリンク管理」ダイアログが開くので、一覧から対象のウィジェットを探してリンクをコピーします)。TikTok LIVE Studio のブラウザソース URL 欄は**全体を一度削除してから貼り直して**ください——リンクは長いため、文字の欠けや古いゲームのリンクを誤って貼ってしまうことがよくあります。
2. 貼り付けたリンクに **`preview=1` が含まれていないか**確認してください:`preview=1` 付きのリンクはコンソール自身のプレビュー専用で、TikTok LIVE Studio には絶対に貼らないでください。貼ってしまうと画面にはプレビュー用のサンプル画面が表示され、実際の配信状態が反映されません。
3. 背景が黒く表示される場合、たいていはリンクの貼り間違いか、コンソールがまだ TikTok アカウントに接続できていない状態です(オーバーレイの背景は元から透過なので、別途クロマキー設定は不要です)。
4. レイアウトが崩れる場合は、[オーバーレイのサイズとレイアウトの目安](/docs/overlay-layout)を参照してブラウザソースの幅・高さを設定し直してください。オーバーレイは自動的に比率を保って拡大縮小されるため、たいてい幅と高さの比率が極端すぎることが原因です。
5. TikTok LIVE Studio 固有のより詳しいトラブルシューティングは [TikTok LIVE Studio のよくある質問](/docs/live-studio-tips) を参照してください。

それでも解決しない場合は、サポートへ連絡するのが一番早いです。

## ライセンスキーの有効化失敗 / PCの変更

1. 「キーが見つかりません。入力内容をご確認ください」と表示される → 文字の欠けや誤入力がないか確認してください——キーは長いので、手入力せずまるごとコピー&ペーストすることをおすすめします。
2. 「このシリアルキーは別のパソコンに紐付けられています。公式サイトの「マイアカウント」からご自身で解除してください」と表示される → これは正常な保護機能です。1つのライセンスキーは1台のPCにしか紐付けできません(**同じPC上であれば TikTok アカウントは自由に切り替え可能**で、これには影響しません)。同じキーを新しいPCで使いたい場合、コンソール上では自分で切り替えられませんが、公式サイトの「マイアカウント」でシリアルカードの「デバイスの紐付け解除」を押し、新しいPCで有効化すればご自身で完結します(詳しくは[アカウントとシリアル管理](/docs/account-and-licenses)を参照)。それでも解決しない場合はサポートへご連絡のうえ、ライセンスキーと、設定ページの「デバイス情報」パネルに表示されている**デバイスコード**を添えてください。
3. 「ライセンスサーバーに接続できません。ネットワーク接続を確認して再試行してください」と表示される → ネットワークが正常か確認してから再試行してください。
4. ライセンスの期限切れやサブスクリプションの一時停止:期限切れ後もしばらくは通常どおり使い続けられることが多いので、できるだけ早くサポートへ連絡して対応してください。
5. 購入からアクティベートまでの流れ全体は [ライセンスの購入とアクティベート](/docs/activation) を参照してください。

それでも解決しない場合は、サポートへ連絡するのが一番早いです。

## アップデートに失敗する

1. 公式サイトの [/download](/download) ページから最新版のインストーラーを再度ダウンロードしてください。
2. 旧バージョンの上に**上書きインストール**するだけで問題ありません。事前のアンインストールは不要です。インストーラーがまったく反応しない場合は、旧バージョンを手動で削除してから再インストールしてください。
3. 初回実行時やバージョン差が大きい場合、Windows が「Windows によってPCが保護されました」という SmartScreen の警告を表示することがあります——これは署名のないインストーラーに対する標準的な警告で、ファイルに問題があるわけではありません。「詳細情報」→「実行」の順にクリックして続行してください。
4. インストール完了後、設定ページに戻り「現在のバージョン」が最新版になっているか確認してください。

**アップデート後にアプリが見つからない**(デスクトップのショートカットが白い書類アイコンになる、ダブルクリックしても反応がない、スタートメニューにもない):アップデートのインストール中にPCをシャットダウン・再起動すると発生します。上の1〜2の手順でもう一度ダウンロードしてインストールすれば元に戻ります。**設定とライセンスキーはそのまま残っているので、キーを入力し直す必要はありません。**アップデートは数十秒で終わります。その間はシャットダウンや電源オフを避けてください。

それでも解決しない場合は、サポートへ連絡するのが一番早いです。

## スコアが動かない

1. まずラウンドが本当に開始されているか確認してください——「スコアゲーム」ページは設定専用のページで、そこでゲームを選んだり設定を変えたりしても視聴者画面は変わりません。ゲームを切り替えるときはホームに戻ってそのカードをタップしてください。ホームで操作しているのが使いたいゲームであることを確認し、ホームのワークベンチで「開始」を押して正式にラウンドを開始してください。ラウンドが始まったあとに送られたギフトから、はじめてスコアに反映されます。
2. **もっとも多い原因**:初期状態では「代表ギフト」は**一つもバインドされていません**(空です)。これは意図的な仕様です——配信ルームごとに送れるギフトが異なるため、アカウントに接続してから実際のギフト一覧の中から選ぶことで、確実に正しいサイドへ加点されるようにしています。**配信を始める前に、必ずワークベンチで「代表ギフト」をバインドしてください**——TikTok アカウントに接続すると、そのアカウントで実際に送れるギフトの一覧が自動的に取得されるので、そこから選ぶだけです。一覧がすぐに取得できない場合は「更新」を押して再試行するか、隣にある「ギフト ID を手動入力」欄で対応してください。バインドするまではコンソールに黄色い警告が表示され、ギフトは「未分類」に入り(売上レポートには残ります)、どのサイドにも加点されません。
3. 連続で送られたギフト(連打)ですか?**連続送信は一連の動作が終わった時点で1回だけ集計されます**——1つ1つのアニメーションごとに加算されるわけではないので、途中で「反応がない」ように見えるのは正常です。動作が終わった瞬間にまとめて加算されます。
4. ギフトのアイコンが「不明なギフト」と表示されても、スコア計算には影響しません——IDが正しいチーム/枠に紐付いていれば、ダイヤ数は正しく加算されます。単にギフト名の表示が最新のギフト一覧にまだ追いついていないだけです。

それでも解決しない場合は、サポートへ連絡するのが一番早いです。

## 画面のカクつき / コマ落ち

1. まずオーバーレイの自動軽量モードが働いているか確認してください:パソコンの負荷が高いとき、パーティクルやグローなどの装飾効果が自動でオフになり、3Dダイスは平面表示に切り替わり、アニメーションのフレームレートも下がります。これは正常な自動保護動作で、負荷が下がれば自動的に元に戻るため、特に対応は必要ありません。手動で指定したい場合は、コンソールの設定ページに「自動 / 強制軽量 / 強制フル」の3段階スイッチもあります。
2. 同時に開くオーバーレイソースの数を減らす:複数の個別ソースを貼る代わりに「全部(概要)」の単一リンクを使い、[オーバーレイのサイズとレイアウトの目安](/docs/overlay-layout)に沿って幅・高さを設定し、推奨サイズより大きく拡大しないようにしてください。
3. TikTok LIVE Studio のエンコード設定で、CPUのみのエンコードではなくハードウェアエンコード(NVENC / QuickSync)が有効になっているか確認してください——これがカクつき軽減にもっとも効果的です。
4. コンソールをインストールすると、このパソコンを自動的に検出して適切な効果設定を適用するため、通常は手動調整の必要はありません。詳しい推奨スペックとその他の対処法は[パフォーマンスとハードウェアの目安](/docs/performance)をご覧ください。

それでも解決しない場合は、サポートへ連絡するのが一番早いです。

接続が切れてから1分経過すると、警告内の「今すぐ診断」から診断結果を表示し、サポート向けにコピーできます。再接続するとボタンは消えます。

**サポートにログを送信** — 送信するとコンソールログ、診断結果、更新記録がTStarサポートに共有されます。

## 利用状況の分析

コンソールは初期設定で匿名の利用データを共有し、TStar の改善に役立てています。たとえば、どのツールやゲームモードが使われたか、接続が安定しているかといった情報です。ライセンスキー、視聴者データ、画面録画は含まれません。共有したくない場合は **設定 → 利用状況の分析** で「匿名の利用データを共有」をオフにしてください。いつでも再びオンにできます。
