使い方

1. 動作環境（必ずお読みください）

できること・できないこと

2. はじめて使うとき

インストールは不要です。Node.js や Python などのソフトを別に入れる必要もありません。

1. ダウンロードした zip ファイルを右クリック →「すべて展開」を選びます。
   zip のまま中のファイルを開くと動きません。デスクトップやドキュメントなど、分かりやすい場所に展開してください。
2. 展開してできた「HemiOverlay」フォルダの HemiOverlay.exe をダブルクリックします。
3. 初めてのときは「WindowsによってPCが保護されました」と表示されることがあります。「詳細情報」を押してから「実行」を押してください。
   個人で作ったアプリのため、Windows が発行元を確認できないときに出る表示です。2回目からは出ません。
4. 黒い画面が開き、少しするとブラウザで管理画面が開きます。
   使っている間は黒い画面を閉じないでください（閉じるとアプリが終了します）。

3. ライセンスキーの登録

購入する前に：PC ID をコピーする

キーを使うパソコンでアプリを起動し、管理画面の上の「お試し中」の欄に表示される「このパソコンのPC ID」（XXXX-XXXX-XXXX-XXXX）の「コピー」を押します。購入画面の「キーを使うパソコンのPC ID」に貼り付けてください。

このパソコンの PC ID：

購入したあと：キーを登録する

購入すると、購入完了画面に OVL1. から始まるライセンスキーが表示されます。

1. 管理画面の上の「お試し中」の欄に、キーを最初から最後までそのまま貼り付けます。
2. 「キーを登録」を押します。「〇〇が使えるようになりました」と出れば完了です。

複数の商品を一度に購入した場合は、1つのキーですべて使えるようになります。キーはこのパソコンの HemiOverlay\data フォルダに保存され、次からは入力不要です。

あとから別の商品を買い足したとき

1. 購入画面では、前と同じこのパソコンの PC ID を入力します（購入画面は前回の PC ID を覚えています）。
2. 管理画面で、買った商品のタブを開きます（まだキーを登録していない商品の画面に「お試し中」の欄が出ます）。
3. 新しいキーを貼り付けて「キーを登録」を押します。前に登録したキーはそのまま使えます。

パソコンを買い替えたとき・Windows を入れ直したとき

PC ID が変わるため、それまでのキーは使えなくなります。新しいパソコンでアプリを起動して PC ID を確認し、注文番号と新しい PC ID を添えて販売サイトのお問い合わせ先へご連絡ください。確認のうえ、新しいパソコン用のキーを発行します。

4. 配信につなぐ

1. 管理画面の入力欄に、配信するアカウントの TikTok ユーザー名（@ より後ろの部分）を入れます。
2. 「接続する」を押します。配信前に押しても大丈夫です。配信が始まると自動でつながります。
3. どの画面（コメントランキング・グローブ管理・本日の文字・加入通知・入室通知・ギフト連動・録画）から接続しても同じです。

つながらないときは「困ったとき」をご覧ください。

5. OBS にオーバーレイを追加する

オーバーレイは、管理画面に表示されるアドレス（http://127.0.0.1:8080/… の形）を OBS Studio に登録して使います。このアドレスはあなたのパソコンの中だけで使われるもので、インターネットに公開されることはありません。

1. HemiOverlay.exe を起動しておきます（OBS で表示している間は起動したままにします）。
2. 管理画面の「配信ソフトに追加する」を開き、アドレスの横の「コピー」を押します。
3. OBS Studio の「ソース」欄の ＋ →「ブラウザ」を選び、名前（例：コメントランキング）を付けて OK。
4. 「URL」にコピーしたアドレスを貼り付け、「幅」「高さ」を下の表のとおりにして OK。
   「ローカルファイル」にはチェックを入れないでください。背景は自動で透明になります。
5. OBS の画面上で、表示された枠をドラッグして好きな位置・大きさに調整します。

見た目の調整

アドレスの後ろに次のように付けると、見た目を変えられます（例：http://127.0.0.1:8080/?opacity=0.5&scale=1.3）。

6. コメントランキング

コメント数の多い上位10人を、アイコン・名前・コメント数で表示します。

• コメントするたびに1カウント（連投も数えます）。同じ数のときは、先にその数に到達した人が上になります。
• 集計は自動で保存され、同じユーザー名で接続すると続きから数えます。0からにしたいときは「リセット」を押します。
• 「デモで試す」で、配信しなくても動きを確認できます（キーがなくても使えます）。

7. グローブ管理

リスナーごとのブースティンググローブ・2位ブースター・3位ブースターの数と、消えるまでの残り時間（120時間）を表示します。

バトル後の記録（確認待ち）

バトルが終わると、アイテムを獲得した人が管理画面の「確認待ち」に、貢献順位（MVP・2位・3位）付きで並びます。TikTok から届くデータには「誰が獲得したか」しか入っておらず、グローブ・ブースター・ハンマーの区別がないため、ここで確定します。

1. その人がもらったアイテムのボタン（＋グロ・＋2位ブ・＋3位ブ）を押します。2個なら2回押します。
2. 終わったら「完了」。ハンマーなど対象外の人は「なし」を押します。

• リスナーがアイテムを使うと、その人の一番古い分が自動で1つ減ります。バトル相手側で使われた分は数えません。
• 配信の外で獲得した分は、手動の「＋」で登録してください。
• 手動での記録はキーがなくても使えます。配信からの自動記録にはキーが必要です。

8. 本日の文字

その日のコメントで一番多く使われた文字を「本日の文字」として大きく表示します。日付が変わると自動でリセットされます。

• 表示スタイル：カード（2位・3位も表示）／周回（1位の文字の周りを①が回る）
• 数える文字：ひらがな以外（おすすめ）／漢字だけ／すべての文字
• 1つのコメントの中で同じ文字は1回だけ数えます。空白・記号・絵文字は数えません。
• 「デモで試す」はキーがなくても使えます（1分で自動的に止まり、本番の集計には入りません）。

9. 加入通知

配信中にスーパーファンに新しく加入した人を、ネオンが光る電脳風の通知で大きく表示します。

• 色（シアン・マゼンタ・ライム）と表示する時間を選べます。続けて加入があったときは順番に表示します。
• 「テスト表示」はキーがなくても使えます。配信での加入を表示するにはキーが必要です。
• すでにスーパーファンの人が入ってきたときは、加入通知ではなく「入室通知」で「ファン」として表示します。

10. 入室通知

配信に入ってきた人を、ネオンサインが灯るような演出で表示します。

• ファンクラブに入っていない人は「初見さん」、ファンクラブ会員・スーパーファンは「ファン」（ファンクラブ名とレベルも表示）。
• 同じ人の出入りも含めて、届いた入室は毎回すべて表示します。初見さん・ファンのどちらかだけ表示することもできます。
• バトル相手側の配信への入室は表示しません。
• 管理画面の「配信から届いた入室 ○件／表示 ○件」で、入室が届いているかを確認できます。TikTok は人が多いとき、入室の知らせを一部の人の分しか送ってきません（届かなかった人は表示できません）。
• 「テスト表示」はキーがなくても使えます。配信での入室を表示するにはキーが必要です。

11. ギフト連動（画像・音・Webhook）

決めたギフトが投げられたときに、OBS に画像を出して音を鳴らし、指定した URL（Webhook）を呼び出します。

1. 配信に接続すると、投げられたギフトが「直近のギフト」に並びます（直近30種類）。
2. その中から「選ぶ」で、フックするギフトを15個まで選びます。選んだギフトは、直近のギフトから流れても残ります。
3. ギフトの行を押して設定を開き、画像・音・Webhook を決めます。「テストで発動」で試せます。

• OBS に出す画像：はじめはそのギフトの画像です。好きな画像（PNG・JPG・GIF・WebP、10MB まで）に差し替えられます。画像と一緒に出す文字（贈った人の名前・ギフト名・個数）は、それぞれ出すか出さないかを選べます。
• 鳴らす音：MP3・WAV・OGG（15MB まで）。音は OBS の画面から鳴ります。OBS のブラウザソースで「OBS で音声を制御する」にチェックを入れてください。
• Webhook：URL を入れると、ギフトが届いたときにその URL を呼び出します（POST で JSON を送る／GET で呼ぶだけ）。Discord の Webhook URL なら「○○ さんが Rose ×5 を贈りました」という文章で送ります。使わないときは空のままで大丈夫です。
• タイミング：「1回のギフトごとに1回」（バラなどの連打は、終わったときに合計で1回）か「1個ごと」（届いた個数だけ。1回のギフトで最大30回）。
• ギフトの一覧づくりと「テストで発動」はキーがなくても使えます。配信のギフトで発動するにはキーが必要です。

12. 録画

TikTok LIVE Studio や OBS Studio の画面から、配信している部分だけを切り出して MP4 に録画します。配信のコメントを、スマホで見たときのように画面の下に重ねて保存できます。

1. 管理画面の「録画」タブを開き、「ウィンドウ」で録画したいソフト（TikTok LIVE Studio など）を選びます。
2. 「範囲を選択」を押し、配信している部分をドラッグで囲んで「この範囲で決定」。縦配信なら「縦 9:16 に固定」をオンにします。
3. 「● 録画開始」→ 終わったら「■ 録画停止」。保存先（初期設定は「ビデオ\TikTokLive」）に MP4 ができます。

• 他のウィンドウが上に重なっていても録画できますが、録画するソフトを最小化すると録画が止まります。
• 「PCの音」「マイク」をそれぞれオン・オフできます。
• キーがなくても1分まで録画して試せます。

13. アップデート

アプリは起動するたびに、新しい版があるかを販売サイトに確認します。新しい版があると、管理画面の上に「新しいバージョンがあります」と表示されます。

1. 配信中・録画中でないことを確認して、「更新して再起動」を押します。
2. 自動でダウンロード・入れ替えをして、新しい版で起動し直します。

自動で更新できなかったときは、販売サイトから最新版をダウンロードし、今の HemiOverlay フォルダに上書きで展開してください（data フォルダはそのまま使えます）。

14. データとプライバシー

• 集計・設定・ライセンスキー・グローブの記録などは、すべてこのパソコンの HemiOverlay\data フォルダにだけ保存されます。当店のサーバーには送られません。
• アップデートの確認で送るのは「今の版の番号」だけです。ライセンスキー、TikTok のユーザー名、リスナーの名前などは送りません。
• 配信のコメントを受け取るために、入力した TikTok ユーザー名を使って TikTok に接続します。このとき、接続を補助する外部サービス（Euler Stream）を経由します。
• 録画した動画は、選んだ保存先にだけ保存されます。
• ギフト連動で Webhook の URL を入れたときは、ギフトが届くたびに、贈った人の名前・ギフト名・個数をあなたが指定した URL にだけ送ります（当店には送りません）。取り込んだ画像・音声は HemiOverlay\data\gift-media に保存されます。

アプリを削除するときは、HemiOverlay フォルダをまるごと削除するだけです（パソコンの他の場所には何も残りません。録画の設定だけは %APPDATA%\TikTokStudioRecorder に残るので、気になる場合は削除してください）。

15. 困ったとき

配信につながらない

• ユーザー名が正しいか（@ より後ろの部分）、その配信が始まっているかを確認してください。
• 管理画面の「うまくつながらないとき」から、Euler Stream の無料 API キーを設定すると安定することがあります。

OBS にオーバーレイが表示されない

• HemiOverlay.exe（黒い画面）が起動しているか確認してください。
• OBS のブラウザソースのアドレスが、管理画面に表示されているものと同じか確認してください（数字が変わっていることがあります）。
• ブラウザソースのプロパティで「現在のページのキャッシュを更新」を押してください。

「WindowsによってPCが保護されました」と出る

「詳細情報」→「実行」で起動できます。ウイルス対策ソフトがファイルを削除・ブロックした場合は、HemiOverlay フォルダを除外に追加してください。

急に動かなくなった

TikTok 側の変更が原因のことがあります。アップデートが出ていないか、管理画面の上部か販売サイトをご確認ください。

16. ご注意

• このアプリは TikTok の公式機能ではありません。TikTok が公式には提供していない方法でコメントを受け取っているため、TikTok 側の変更で予告なく動かなくなることがあります。
• 当店が販売・アップデートを終了することがあります。終了後も、お手元のアプリはそのまま使えます（TikTok 側の変更で動かなくなった場合の修正はできなくなります）。
• 1つのライセンスキーで使えるパソコンは1台です。
• デジタル商品のため、購入後の返品・返金はお受けできません。同じ商品を重複して購入された場合も返金できません。
• 詳しくは販売サイトの利用規約をご覧ください。