화질 세트 설정 변경

Prev Next

생성된 화질 세트의 설정을 변경하는 API 입니다. 화질 세트의 설정 중 segmentCount 와 segmentDuration 속성만 수정할 수 있습니다.

주의

HLS 화질 세트만 설정 변경할 수 있으며 Low Latency 화질 세트는 설정 변경을 지원하지 않습니다.

PUT https://livestation.apigw.ntruss.com/api/fin-v2/qualitySets/{qualitySetId}
HTTP
헤더명 필수 여부 설명
x-ncp-apigw-timestamp YES 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key YES 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 YES Access Key ID 값과 Secret Key로 암호화한 서명
x-ncp-apigw-signature-v2:{API Gateway Signature}
Content-Type YES Request body content type을 application/json으로 지정
Content-Type: application/json
x-ncp-region_code YES 리전 코드 (FKR)
필드명 필수 여부 타입 제약 사항 설명
segmentCount Yes Integer 1 ~ 10
segmentDuration Yes Integer 1000 ~ 10000
필드명 타입 설명 비고
enableHlsTimedMetadata Boolean
timedMetadata Object
timedMetadata.interval Integer
timedMetadata.key String
timedMetadata.header String
id Integer
status String
genType String
name String
createdTime Integer
segmentDuration Integer
segmentCount Integer
inUseChannelNames String[]
qualities[] Object[]
qualities[].id Integer
qualities[].name String 화질 프로파일 이름
qualities[].type String AUDIO, NORMAL
qualities[].genType String CUSTOM,SYSTEM
qualities[].status String
qualities[].video Object if type = AUDIO, video Object doesn not need.
qualities[].video.fps Integer 1 ~ 60 fps
qualities[].video.birate Integer 1 ~ 204800000 bps
qualities[].video.bframes Integer 0 ~ 4 사이 정수
qualities[].video.level Integer -1
qualities[].video.width Integer 16 ~ 4096
qualities[].video.height Integer 16 ~ 4096
qualities[].video.bypass Boolean
qualities[].video.orientation String FIX, FREE FIX
qualities[].video.keepRatio Boolean
qualities[].video.codec String H264
qualities[].video.profile String BASELINE, MAIN, HIGH
qualities[].video.rateControl Integer VBR,CBR VBR
qualities[].video.videoH264ParamRefFrames Integer 1 1
qualities[].audio Object
qualities[].audio.codec String AAC, MP3 AAC
qualities[].audio.profile String LC LC
qualities[].audio.samplerate Integer AAC : [8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000, 64000, 88200, 96000]
MP3 : [8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000]		 44100
qualities[].audio.channels Integer AAC : 0 ~ 8
MP3 : 0 ~ 2		 0
qualities[].audio.bitrate Integer 16 ~ 320 kbps
qualities[].audio.bypass Boolean false 
PUT /api/fin-v2/qualitySets/68
HOST: livestation.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:FKR

{  
   "segmentCount":3,
   "segmentDuration":3000
}
HTTP
HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{   
   "content":{     
      "id":68,
      "status":"CREATED",
      "createdTime":1585243037000,
      "genType":"CUSTOM",
      "name":"myqualityset",
      "segmentDuration":3000,
      "segmentCount":3,
      "qualities":[      
         {           
            "id":5,
            "status":"CREATED",
            "genType":"SYSTEM",
            "name":"720p-9-16",
            "type":"NORMAL",
            "video":{
               "fps":30,
               "bitrate":2500000,
               "bframes":0,
               "level":-1,
               "width":720,
               "height":1280,
               "bypass":false,
               "codec":"H264",
               "profile":"MAIN",
               "rateControl":"VBR",
               "videoH264ParamRefFrames":1
            },
            "audio":{
               "codec":"AAC",
               "profile":"LC",
               "samplerate":48000,
               "channels":0,
               "bitrate":128,
               "bypass":false
            }
         },
         {            
            "id":4,
            "status":"CREATED",
            "genType":"SYSTEM",
            "name":"720p-16-9",
            "type":"NORMAL",
            "video":{
               "fps":30,
               "bitrate":2500000,
               "bframes":0,
               "level":-1,
               "width":1280,
               "height":720,
               "bypass":false,
               "codec":"H264",
               "profile":"MAIN",
               "rateControl":"VBR",
               "videoH264ParamRefFrames":1
            },
            "audio":{
               "codec":"AAC",
               "profile":"LC",
               "samplerate":48000,
               "channels":0,
               "bitrate":128,
               "bypass":false
            }
         }
      ],
      "inUseChannelNames":[  ],
      "enableHlsTimedMetadata":true,
      "timedMetadata":{
         "interval":1000,
         "key":"utc",
         "header":"ncloud.livestation.metadata"
      }
   }
}
HTTP