TikXanderで自作ゲームを連携する
更新日 2026年8月10日
TikXanderは既製のインタラクティブゲームのカタログだけではありません。TikTok Live向けのゲームやオーバーレイを作るなら、配信者PC上のローカルAPI経由でライブイベントに接続できます。TikXanderローカルエージェントがライブをキャプチャし、gift・like・chat・followなどのイベントをlocalhostのWebSocketで配信します。クライアントにTikTok認証情報を埋め込まずにリアルタイム反応が可能です。
ローカル連携とは
ローカル連携とは、ゲームやウィジェットが通常のWebページ（ブラウザ、OBS Browser Source、デスクトップWebView）として配信者マシン上のWebSocketに接続することです。ローカルエージェントが橋渡し役となり、TikTok Live接続（browser-mode含む）を処理し、配信者が許可したアプリへ正規化イベントを配信します。
イベントはlocalhost（127.0.0.1）に留まります。配信中にギフトを受け取るために公開バックエンドは不要で、OBSオーバーレイ、カスタムミニゲーム、開発プロトタイプに最適です。
対象ユーザー
- TikTok Liveのギフトやチャットでゲームプレイを動かしたいゲーム／ウィジェット開発者。
- gift・like・follow・chatにリアルタイム反応するOBSオーバーレイを作るスタジオ。
- 製品化前に独自のインタラクティブ形式を試作するクリエイターとチーム。
- クラウド中継だけに頼らず、配信者PC上の低遅延ローカルイベント経路を好む方。
仕組み
1) 配信者がTikXanderローカルエージェントをインストールしてログインし、ライブキャプチャを開始（エージェントのbrowser-modeが推奨）。
2) アプリがポート8767のローカルイベントチャネルに接続。同じlocalhostサーバー上に2つの公開面があります：バージョン付き開発者チャネル ws://127.0.0.1:8767/events/v1（app id／権限）と、同一マシン向け軽量コンシューマ用のローカルDAPI ws://127.0.0.1:8767/dapi。
3) 視聴者がギフト・いいね・チャット・フォローすると、エージェントが正規化イベントフレームを送出。ゲームはスポーン、進捗バー、アラート、スコアなどにマップします。
4) 同じホストで long-poll（/events/v1/poll）、simulate（POST /events/v1/simulate）、status（GET /events/v1/status）を使い、毎回フルライブなしで開発できます。
ローカルエンドポイント（配信者PC）
- 開発者WebSocket API: ws://127.0.0.1:8767/events/v1 — アプリ単位のバージョン付きイベント。
- ローカルDAPI WebSocket: ws://127.0.0.1:8767/dapi — 同一マシン向けイベントストリーム。
- HTTPヘルパー（同ポート）: /events/v1/poll, /events/v1/simulate, /events/v1/status。
- localhostのみ（127.0.0.1:8767）：このチャネルは配信者PC外へは出ません。
反応できるイベント種別
- gift — 視聴者ギフト（ファンアウト前にストリーク解決済み）。
- like — ライブ中のいいね（ソフト進捗や加速に）。
- chat — キーワードゲーム、投票、コールアウト用コメント。
- follow / join — ウェルカム演出やカウンター用の成長イベント。
- live_status — セッション開始／終了でUIをクリーンにアイドル化。
始め方
1. TikXanderアカウント作成
games.tikxander.com で登録 — 配信者がゲーム・プラン・ライブツールを管理するのと同じダッシュボードです。
2. ローカルエージェントを導入
オーバーレイ、ウィジェット、localhostイベントポートを公開するデスクトップエージェントについて、ローカルエージェント製品ページを確認してください。
3. ゲームをlocalhostに接続
ws://127.0.0.1:8767/events/v1（必要ならapp id付き）または ws://127.0.0.1:8767/dapi にWebSocket接続し、gift/like/chat/followをゲームロジックにマップします。
4. フルライブなしでテスト
同じホストで POST /events/v1/simulate と GET /events/v1/status を使い、テストギフトを注入してハンドラを検証します。
5. 配信者フローで公開
準備ができたら、配信者はダッシュボードからTikXanderのカタログ・ウィジェット・セッションツールと組み合わせられます。
開発者がTikXanderを選ぶ理由
OBSの隣で動くリアルタイムイベントパイプ、明確な種別（gift, like, chat, follow）、開発用シミュレーション、インタラクティブTikTok Live向けに既に使われている製品面が揃います。アカウントとプランは games.tikxander.com、ローカルエージェントの紹介は当サイト（例: /ja/local-agent）です。
よくある質問
ギフト受信用に公開サーバーは必要ですか？
ローカルチャネルでは不要です。配信者PCでローカルエージェントが動いていれば、ws://127.0.0.1:8767 に接続してlocalhostでイベントを受け取れます。
/events/v1 と /dapi の違いは？
/events/v1 はバージョン付き開発者契約（app id、権限、init、poll/simulate/status）です。/dapi は同一ポート上の軽量ローカルWebSocket面です。クライアントに合う契約を選んでください。
どのイベントを購読できますか？
典型的には gift, like, chat, follow, join と live_status です。正確な可用性はキャプチャモードと配信者が付与する権限に依存します。
アカウントとエージェントはどこで管理しますか？
アカウントとプランは games.tikxander.com。ローカルエージェント製品ページは当サイト（例: /ja/local-agent）。ログイン後のダッシュボードでセッションとエージェントツールを扱います。
トラフィックは配信者ネットワーク外に出ますか？
イベントソケットは 127.0.0.1:8767 で待ち受け — 同一PC上のクライアントのみ。低遅延で、公開インターネットにイベントパイプを晒しません。