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": "" }