Disco サービス API
Disco サービスは、ユーザーのストリーム情報を提供するサードパーティの Web サイト用のHTTP API を提供します。
この API が Genvid サービスからの重要なリソースへのアクセスを制御するため、ヘッダー部にセキュリティコードが含まれています。このコードは必ず信頼できるサーバーから呼び出し、Web クライアントから直接アクセスするのではなく、Web サーバー経由で戻すようにしてください。
Disco
- GET /disco/stream/info
ストリーム配信に必要な情報を取得する。
- リクエストヘッダ:
secret -- サービスに必要なセキュリティトークン。
- 応答 JSON オブジェクト:
name (string) -- ストリーム名。
description (string) -- ストリームの説明。
game (string) -- このストリームを配信するゲーム名。
service (string) -- ライブ配信サービスのタイプ。
channel (string) -- user-specific チャンネル識別子。
delayoffset (number) -- ビデオストリームとゲームストリームの遅延 (オプション)。
videowidth (integer) -- 最終ビデオの横幅 (ピクセル)。
videoheight (integer) -- 最終ビデオの高さ (ピクセル)。
ntpuri (string) -- NTP URI。
応答例 :
{ "name": "unknown", "description": "", "game": "unknown", "service": "youtube", "channel": "genvid", "delayoffset": 0, "videowidth": 1920, "videoheight": 1080, "ntpuri": "" }
- POST /disco/stream/join
ユーザーをストリームに接続するために必要な情報については、サービスにリクエストを送信します。
- リクエストヘッダ:
secret -- サービスに必要なセキュリティトークン。
- 応答 JSON オブジェクト:
info.name (string) -- ストリーム名。
info.description (string) -- ストリームの説明。
info.game (string) -- このストリームを配信するゲーム名。
info.service (string) -- ライブ配信サービスのタイプ。
info.channel (string) -- user-specific チャンネル識別子。
info.delayoffset (number) -- ビデオストリームとゲームストリームの遅延 (オプション)。
info.videowidth (integer) -- 最終ビデオの横幅 (ピクセル)。
info.videoheight (integer) -- 最終ビデオの高さ (ピクセル)。
info.ntpuri (string) -- NTP URI。
uri (string) -- 接続 URI。
token (string) -- 接続に必要なセキュリティトークン。
応答例 :
{ "info": { "name": "unknown", "description": "", "game": "unknown", "service": "youtube", "channel": "genvid", "delayoffset": 0, "videowidth": 1920, "videoheight": 1080, "ntpuri": "" }, "uri": "", "token": "" }