プレイヤーオプション照会
- 印刷する
- PDF
プレイヤーオプション照会
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
プレイヤーに設定された情報を照会する方法は、次の通りです。
リクエスト
GET {API_URL}/players/{player_no}/options
リクエストパラメータ
| フィールド名 | 要否 | タイプ | 制約事項 | 説明 |
|---|---|---|---|---|
| player_no | Y | Integer | Path Parameter | プレイヤー番号 |
レスポンス
| フィールド名 | タイプ | 説明 | 備考 |
|---|---|---|---|
| result | Object | ||
| result.env | String | 環境 | |
| result.options | String(json) | 設定されたオプション |
プレイヤーオプション情報
| フィールド名 | 要否 | タイプ | 制限 | 説明 |
|---|---|---|---|---|
| player_no | Y | Integer | プレイヤー番号 | |
| option | Y | Object(json) | プレイヤーオプション情報 | |
| option.aspectRatio | N | String | 無料/有料 | アスペクト比、デフォルト値 16/9、 オプション: 16/9、4/3、1/1、9/16、21/9 |
| option.autoPause | N | Boolean | 無料/有料 | 無効化時に再生を自動停止 |
| option.autostart | N | Boolean | 無料/有料 | 自動再生有無、デフォルト値 TRUE |
| option.repeat | N | Boolean | 無料/有料 | 動画繰り返し、デフォルト値 FALSE |
| option.lang | N | String | 無料/有料 | UI言語設定、デフォルト値: auto オプション: auto、ko、en、ja |
| option.muted | N | Boolean | 無料/有料 | ミュート、デフォルト値 FALSE |
| option.objectFit | N | String | 無料/有料 | アスペクト比設定、デフォルト値 contain、 オプション: contain、cover、fill |
| option.controlActiveTime | N | Integer | 無料/有料 | コントロールバーの有効時間(ms) デフォルト値 3000 |
| option.controls | N | Boolean | 無料/有料 | コントロールバー使用有無、デフォルト値 TRUE |
| option.controlBtn | N | Object | 有料 | コントロールバーボタンの表示有無設定、有料のみ変更可能 |
| option.controlBtn.fullscreen | N | Boolean | 有料 | 全体画面、有料のみ変更可能、デフォルト値 TRUE |
| option.controlBtn.pictureInPicture | N | Boolean | 有料 | ミニプレイヤー、有料のみ変更可能、デフォルト値 TRUE |
| option.controlBtn.play | N | Boolean | 有料 | プレイボタン表示、有料のみ変更可能、デフォルト値 TRUE |
| option.controlBtn.times | N | Boolean | 有料 | 時間表示、有料のみ変更可能、デフォルト値 TRUE |
| option.controlBtn.volume | N | Boolean | 有料 | ボリューム調整、有料のみ変更可能、デフォルト値 TRUE |
| option.controlBtn.setting | N | Boolean | 有料 | 設定ボタン表示、有料のみ変更可能、デフォルト値 TRUE |
| option.descriptionNotVisible | N | Boolean | 有料 | 動画メタデータ UI非表示、有料のみメタデータ設定可能、デフォルト値 FALSE |
| option.playRateSetting | N | Array | 有料 | 倍速選択オプション 有料のみ変更可能、デフォルトオプション値: [0.5、0.75、1、1.5、2] |
| option.progressBarColor | N | String | 有料 | コントロールバーのカラー、有料のみ変更可能 デフォルト値: #4299f5 |
| option.seekingPreview | N | Boolean | 有料 | 動画区間移動のプレビュー、デフォルト値 TRUE |
| option.setStartTime | N | String | 有料 | 初公開日 |
| option.startMutedInfoNotVisible | N | Boolean | 有料 | ミュート通知、デフォルト値 FALSE |
| option.keyboardShortcut | N | Boolean | 有料 | キーボードショートカット有無、デフォルト値 TRUE |
| option.touchGestures | N | Boolean | 有料 | タッチジェスチャの有効化 |
| option.ui | N | String | 有料 | UI設定、デフォルト値 all 有料のみオプション設定可能: all、mobile、pc |
| option.lowLatencyMode | N | Boolean | 有料 | LL-HLS超遅延モード対応、LIVE映像を常に最新区間に維持 デフォルト値: FALSE |
| option.customBtns | N | Array | 有料 | カスタムボタン追加(最大4個) |
| option.customBtns.ui | Y | String | 有料 | カスタムボタンのデバイス環境 UI(PC、MOBILE) |
| option.customBtns.position | Y | String | 有料 | カスタムボタンの位置設定(left-top、left-bottom、right-top、right-bottom |
| option.customBtns.flow | N | String | 有料 | カスタムボタンの作成位置設定(left、right、デフォルト: left) |
| option.customBtns.icon | Y | String | 有料 | カスタムボタンの画像 URL設定 |
リクエスト例
GET /api/v1/players/option?player_no=1
HOST: vpe.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR
成功コード
| HttpStatusCode | Code | Message |
|---|---|---|
| 200 | 200 | ok |
エラーコード
| HttpStatusCode | Code | Message | Description |
|---|---|---|---|
| 200 | 4601 | Query string player_no is missing. | |
| 200 | 4801 | No player information. |
レスポンス例
HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Feb 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
{
"code": "string",
"message": "string",
"result": {
"env": "string",
"option": {
"aspectRatio": "string",
"autoPause": true,
"autostart": true,
"controlActiveTime": 0,
"controlBtn": {
"fullscreen": true,
"pictureInPicture": true,
"play": true,
"setting": true,
"times": true,
"volume": true
},
"controls": true,
"descriptionNotVisible": true,
"keyboardShortcut": true,
"muted": true,
"objectFit": "string",
"playRateSetting": [
0
],
"progressBarColor": "string",
"repeat": true,
"seekingPreview": true,
"startMutedInfoNotVisible": true,
"touchGestures": true,
"ui": "string"
}
}
}
この記事は役に立ちましたか?