The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.
Available in Classic and VPC
Deploy player settings to the develop environment.
Request
This section describes the request format. The method and URI are as follows:
| Method | URI |
|---|---|
| PUT | /api/v1/players/{player_no}/applyDev |
Request headers
For information about the headers common to all Video Player Enhancement APIs, see Video Player Enhancement request headers.
Request path parameters
You can use the following path parameters with your request:
| Field | Type | Required | Description |
|---|---|---|---|
player_no |
String | Required | Player number
|
Request body
You can include the following data in the body of your request:
| Field | Type | Required | Description |
|---|---|---|---|
option |
Object | Required | Player option information
|
option.touchGestures |
Boolean | Optional | Whether to use touch gestures
|
option.autostart |
Boolean | Optional | Automatic playback
|
option.controlBtn |
Object | Optional | Control bar button settings |
option.controlBtn.fullscreen |
Boolean | Optional | Full screen button display
|
option.controlBtn.pictureInPicture |
Boolean | Optional | PIP (switch to mini player) button display
|
option.controlBtn.volume |
Boolean | Optional | Volume control button display
|
option.controlBtn.play |
Boolean | Optional | Play button display
|
option.controlBtn.times |
Boolean | Optional | Time display
|
option.controlBtn.setting |
Boolean | Optional | Settings button display
|
option.controlBtn.subtitle |
Boolean | Optional | Subtitle selection button display
|
option.controlBtn.progressBar |
Boolean | Optional | Progress bar display
|
option.autoPause |
Boolean | Optional | Auto-stop on browser inactivity
|
option.seekingPreview |
Boolean | Optional | Thumbnail preview display
|
option.descriptionNotVisible |
Boolean | Optional | Description (video title and metadata UI) usage
|
option.playRateSetting |
Array | Optional | Playback speed options list
|
option.repeat |
Boolean | Optional | Loop playback
|
option.startMutedInfoNotVisible |
Boolean | Optional | Whether to mute upon playback start
|
option.ui |
String | Optional | Control UI type
|
option.aspectRatio |
String | Optional | Aspect ratio
|
option.controlActiveTime |
Integer | Optional | Controlbar auto-hide time (millisecond)
|
option.muted |
Boolean | Optional | Mute indication window display
|
option.controls |
Boolean | Optional | Control bar usage
|
option.progressBarColor |
String | Optional | Control bar color
|
option.keyboardShortcut |
Boolean | Optional | Keyboard shortcut usage
|
option.objectFit |
String | Optional | Full screen method
|
option.lowLatencyMode |
Boolean | Optional | Ultra-low latency mode usage
|
option.lang |
String | Optional | Language settings
|
option.visibleWatermark |
Boolean | Optional | Text watermark usage
|
option.watermarkConfig |
Object | Conditional | Text watermark detailed options
|
option.watermarkConfig.randPosition |
Boolean | Conditional | Whether to randomize location
|
option.watermarkConfig.randPositionInterVal |
Integer | Conditional | Exposure interval (millisecond)
|
option.watermarkConfig.x |
Integer | Conditional | Horizontal offset
|
option.watermarkConfig.y |
Integer | Conditional | Vertical offset
|
option.watermarkConfig.opacity |
Float | Conditional | Transparency
|
option.iosFullscreenNativeMode |
Boolean | Optional | Support for full screen mode settings for iOS mobile Safari
|
option.customBtns |
Array | Optional | Custom button settings: customBtns
|
customBtns
The following describes customBtns.
| Field | Type | Required | Description |
|---|---|---|---|
ui |
String | Conditional | Button UI environment
|
flow |
String | Conditional | Creation location
|
position |
String | Conditional | Button location
|
icon |
String | Conditional | Button image URL |
Request example
The request example is as follows:
curl --location --request PUT 'https://vpe.apigw.ntruss.com/api/v1/players/6284/applyDev' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'x-ncp-region_code: KR' \
--data '{
"option": {
"touchGestures": true,
"autostart": true,
"controlBtn": {
"fullscreen": true,
"pictureInPicture": true,
"volume": true,
"play": true,
"times": true,
"setting": true,
"progressBar": true
},
"seekingPreview": true,
"descriptionNotVisible": false,
"playRateSetting": [
0.5,
1.0,
1.5,
2.0,
2.5
],
"repeat": false,
"startMutedInfoNotVisible": false,
"ui": "pc",
"aspectRatio": "16/9",
"controlActiveTime": 3000,
"muted": false,
"controls": true,
"progressBarColor": "#4299f5",
"keyboardShortcut": true,
"objectFit": "cover",
"lowLatencyMode": false,
"lang": "ko",
"visibleWatermark": true,
"watermarkConfig": {
"randPosition": false,
"x": 98,
"y": 2,
"opacity": 0.6
},
"customBtns": [
{
"ui": "pc",
"flow": "left",
"position": "right-bottom",
"icon": "{Icon URL}"
}
]
}
}'
Response
This section describes the response format.
Response body
The response body includes the following data:
| Field | Type | Required | Description |
|---|---|---|---|
code |
String | - | Response code |
message |
String | - | Response message |
Response status codes
For information about the HTTP status codes common to all Video Player Enhancement APIs, see Common Video Player Enhancement response status codes.
Response example
The response example is as follows:
{
"code": "200",
"message": "ok"
}