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