17LIVE EDITION / 接続仕様
17LIVEから、どこまで取得できる？
現在確認できる実用的な接続経路は、17LIVE公式OBSプラグインのローカルHTTP / WebSocketです。一般開発者がAPIキーを取得して利用する、包括的な公開APIの案内は今回確認できませんでした。
公式プラグインが公開しているソースコードには、ログイン後の内部API呼び出しもあります。ただし、ソースが読めることと、第三者サービス向けに安定したAPIとして提供・保証されることは同じではありません。
| 情報 | 公開ソースで確認できる範囲 | この版の対応・注意点 |
|---|---|---|
| 通常・ランダムギフト | 送信者、ギフトID、名前・画像・ポイント（辞書取得時） | 演出・モニター・集計に対応。通知1件を1個として扱います。 |
| コメント・入室 | 表示名、ユーザーID、コメント本文、通知に含まれるプロフィール情報 | コメントビュー・OBS表示に対応。 |
| いいね | いいね通知と送信者情報 | 受信通知を集計。公式アプリの総いいね数の再現は保証しません。 |
| 入室演出 | 入室通知、表示名、レベル、アニメーション種別（届いた場合） | 専用ウェルカム演出に対応。アーミー契約一覧の取得とは別です。 |
| Poke・エール | Poke送信者、エール通知のユーザー・レベル・値 | 専用カードに対応。ギフトポイントやいいねに換算しません。 |
| 配信ルーム・画像辞書 | ローカルAPIにルーム情報、ギフト・入室演出素材の取得処理あり | この版ではギフト辞書を使用。配信者やバージョンにより取得結果が異なります。 |
| イベント・ロックゾーン・アーミー | 公式プラグイン内部にはイベント設定、ロックゾーン視聴者、アーミー名などの処理あり | 一般向け公開APIとしての提供範囲は未確認。この版では自動取得・操作を提供しません。 |
| 売上・換金・DM・契約情報 | 第三者ツール向けに取得可能と確認できる資料なし | 取得できる機能として扱いません。 |
このツールの接続方法
公式プラグインで17LIVEにログイン → ローカル受信アプリでイベントを受け取る → iLIveGIFt(17LIVE)の共通イベント形式へ変換 → 演出・コメントビュー・レポートへ反映します。17LIVEのパスワードやAblyトークンをこの管理画面へ入力する必要はありません。
ギフト辞書のポイントが取れない場合は「未取得」として扱い、ポイント条件の演出から除外します。ランダムギフトの抽選確率、当選期待値、換金額は推計しません。ギフトの数量は通知単位であり、実配信での数量照合が必要です。
確認状況
公開ソースの調査と、同じイベント形式を使ったローカル接続試験を対象にしています。実際の17LIVE配信でのギフト・OBS表示の最終確認は、ご自身の配信環境で必要です。
調査日：2026年10月11日。参照リビジョン：c36a4c6。