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