ライブエンコーダー設定情報の取得を行うAPIです。
■リクエストURL
https://file-platform.stream.co.jp/writeapi/live/getEncoder/[アップロードキー]
※「アップロードキー」の取得方法は「認証API」をご参照ください。
- contentType：multipart/form-data
■パラメータ
| パラメータ | 必須 | 説明 | デフォルト値 | フォーマット |
| lpid | ○ | ライブID | 無し | 半角数 |
| type | --- | ライブエンコーダー | "json":jsonフォーマット | "json":jsonフォーマット "wirecast":WireCastフォーマット "liveusolo":LiveUSoloフォーマット "liveshell":LiveShellフォーマット |
■レスポンス情報
- 出力タイプ：JSON
- Content-Type：application/json または text/plain
- 文字コード：UTF-8(BOMなし)
■レスポンス例：正常時（JSONフォーマット）
| { "error_code": 0, "message":"OK", "lpid": 1, "encoder_setting": { "server_mainurl": "rtmp://eqlive-eqXXXXXXXX-live.eq.feed1.wselive.stream.ne.jp/eqlive-eqXXXXXXXX-live/fmsins-XXXXX?token= XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "server_suburl": "rtmp://eqlive-eqXXXXXXXX-live.eq.feed2.wselive.stream.ne.jp/eqlive-eqXXXXXXXX-live/fmsins-XXXXX?token= XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "qualities": [ { "name": "hd", "jpname": "ＨＤ画質", "stream_name": "stream-XXXXX-hd", "keyframe": 30, "video_bitrate": 1904, "audio_bitrate": 96, "width": 1280, "height": 720, "audio_sampling_frequency": 44 } ] } } |
error_code：レスポンスコード
|
■レスポンス例：正常時（LiveShellフォーマット）
| 【配信するサーバ情報(RTMP)】 ■配信先URL －メインライブエンコーダーの場合： rtmp://eqlive-eqXXXXXXXX-live.eq.feed1.wselive.stream.ne.jp/eqlive-eqXXXXXXXX-live/fmsins-XXXXX?token= XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX －バックアップライブエンコーダーの場合： rtmp://eqlive-eqXXXXXXXX-live.eq.feed2.wselive.stream.ne.jp/eqlive-eqXXXXXXXX-live/fmsins-XXXXX?token= XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ■ストリーム名 －標準画質用ライブエンコーダーの場合：stream-XXXXX-standard 【CUSTOM】 ■AUDIO QUALITY －サンプリングレート：44KHz －チャンネル：ステレオ －ビットレート：96kbps ■VIDEO QUALITY －平均ビットレート －標準画質用ライブエンコーダーの場合：436 －iフレーム挿入間隔：30frame －フレームレート：30 －プロファイル：Main －縦解像度： －標準画質用ライブエンコーダーの場合：360 |
■レスポンス例：エラー時
| { "error_code": 9021, "message": "request parameter error" } |
■レスポンスコード
| レスポンスコード | 説明 |
| 0 | 正常 |
| 9021 | パラメータエラー |
| 9503 | 削除済み、または登録されていない |
| 9999 | その他システムエラー |