MENU
      화질 세트 생성

        화질 세트 생성


        기사 요약

        Live Station 에서 사용할 화질 세트를 생성하는 API 입니다. 생성한 화질 세트 조회를 위해 화질 세트 목록 조회 API화질 세트 정보 조회 API를 제공합니다.

        주의
        • Low latency 화질 세트는 베타 서비스로 제공되고 있습니다.
        • 베타 기간 동안 Low latency 화질은 네이버 클라우드 Video Player Enhancement만을 이용해 안정적인 재생 가능합니다.

        요청

        POST https://livestation.apigw.ntruss.com/api/v2/qualitySets
        HTTP

        요청 헤더

        헤더명필수 여부설명
        x-ncp-apigw-timestampYES1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYES네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESAccess Key ID 값과 Secret Key로 암호화한 서명
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeYESRequest body content type을 application/json으로 지정
        Content-Type: application/json
        x-ncp-region_codeYES리전 코드 (KR)

        요청 바디

        필드명필수 여부타입제약 사항설명
        nameYesString화질명은 숫자,영문으로 최소 3글자 이상 최대 20자까지 입력 가능
        특수 문자“-” 허용
        qualityIdsYesInteger[]화질 구성 갯수는 1~ 4
        segmentCountNoInteger1 ~ 10LL-HLS, DASH 일 경우 무시됨 (if protolType is ll-hls or dash, the option should be ignored.)
        isEnabledUllYesBooleanLow Latency 용 화질 세트 생성할 경우 true
        segmentDurationNoInteger1000 ~ 10000HLS 프로토콜의 segment duration 길이 설정 (in milliseconds.)
        LL-HLS, DASH 일 경우 무시됨
        enableHlsTimedMetadataYesBoolean
        timedMetadataNoObject
        timedMetadata.headerNoString
        timedMetadata.intervalNoInteger
        timedMetadata.keyNoString

        응답

        필드명타입설명비고
        enableHlsTimedMetadataBoolean
        timedMetadataObject
        timedMetadata.intervalInteger
        timedMetadata.keyString
        timedMetadata.headerString
        idInteger
        statusString
        genTypeString
        nameString
        createdTimeInteger
        segmentDurationInteger
        segmentCountInteger
        isEnabledUllBooleanLow Latency 화질 세트 여부
        targetLatencyIntegerLow Latency 화질 세트의 target latency
        qualityIds[]Integer[]
        qualities[]Object[]
        qualities[].idInteger
        qualities[].nameString화질 프로파일 이름
        qualities[].typeStringAUDIO, NORMAL
        qualities[].genTypeStringCUSTOM,SYSTEM
        qualities[].statusString
        qualities[].videoObjectif type = AUDIO, video Object doesn not need.
        qualities[].video.fpsInteger1 ~ 60 fps
        qualities[].video.birateInteger1 ~ 204800000 bps
        qualities[].video.bframesInteger0 ~ 4 사이 정수
        qualities[].video.levelInteger-1
        qualities[].video.widthInteger16 ~ 4096
        qualities[].video.heightInteger16 ~ 4096
        qualities[].video.bypassBoolean
        qualities[].video.orientationStringFIX, FREEFIX
        qualities[].video.keepRatioBoolean
        qualities[].video.codecStringH264
        qualities[].video.profileStringBASELINE, MAIN, HIGH
        qualities[].video.rateControlIntegerVBR,CBRVBR
        qualities[].video.videoH264ParamRefFramesInteger11
        qualities[].audioObject
        qualities[].audio.codecStringAAC, MP3AAC
        qualities[].audio.profileStringLCLC
        qualities[].audio.samplerateIntegerAAC : [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.channelsIntegerAAC : 0 ~ 8
        MP3 : 0 ~ 2
        0
        qualities[].audio.bitrateInteger16 ~ 320 bps
        qualities[].audio.bypassBooleanfalse

        예시

        요청 예시

        HLS 용 화질 세트 생성

        POST /api/v2/qualitySets
        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:KR
        
        {
           "enableHlsTimedMetadata":true,
           "name":"myqualityset",
           "qualityIds":[
              4,
              5
           ],
           "segmentCount":3,
           "segmentDuration":3000,
           "timedMetadata":{
              "header":"ncloud.livestation.metadata",
              "interval":1000,
              "key":"utc"
           }
        }
        HTTP

        Low Latency 용 화질 세트 생성

        POST /api/v2/qualitySets
        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:KR
        {
          "enableHlsTimedMetadata": true,
          "isEnabledUll": true,
          "name": "myqualityset",
          "qualityIds": [
            1,2
          ],
          "timedMetadata": {
            "header": "ncloud.livestation.metadata",
            "interval": 1000,
            "key": "utc"
          }
        }
        HTTP

        응답 예시

        HLS 용 화질 세트 생성 응답

        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": {
                "createdTime": 1585656720798,
                "enableHlsTimedMetadata": true,
                "genType": "CUSTOM",
                "id": 23,
                "name": "testquality-api",
                "qualities": [
                    {
                        "audio": {
                            "bypass": false,
                            "bitrate": 128,
                            "channels": 0,
                            "codec": "AAC",
                            "profile": "LC",
                            "samplerate": 48000
                        },
                        "genType": "SYSTEM",
                        "id": 4,
                        "name": "720p-16-9",
                        "status": "CREATED",
                        "type": "NORMAL",
                        "video": {
                            "bypass": false,
                            "bframes": 0,
                            "bitrate": 2500000,
                            "codec": "H264",
                            "fps": 30.0,
                            "height": 720,
                            "level": -1,
                            "profile": "MAIN",
                            "rateControl": "VBR",
                            "videoH264ParamRefFrames": 1,
                            "width": 1280
                        }
                    },
                    {
                        "audio": {
                            "bypass": false,
                            "bitrate": 128,
                            "channels": 0,
                            "codec": "AAC",
                            "profile": "LC",
                            "samplerate": 48000
                        },
                        "genType": "SYSTEM",
                        "id": 5,
                        "name": "720p-9-16",
                        "status": "CREATED",
                        "type": "NORMAL",
                        "video": {
                            "bypass": false,
                            "bframes": 0,
                            "bitrate": 2500000,
                            "codec": "H264",
                            "fps": 30.0,
                            "height": 1280,
                            "level": -1,
                            "profile": "MAIN",
                            "rateControl": "VBR",
                            "videoH264ParamRefFrames": 1,
                            "width": 720
                        }
                    }
                ],
                "qualityIds": [
                    4,
                    5
                ],
                "segmentCount": 3,
                "segmentDuration": 3000,
                "status": "CREATED",
                "timedMetadata": {
                    "header": "ncloud.livestation.metadata",
                    "interval": 1000,
                    "key": "utc"
                }
            },
            "result": "success"
        }
        HTTP

        Low Latency 화질 세트 생성 응답

        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": {
            "disabled": false,
            "id": 246,
            "status": "CREATED",
            "createdTime": 1666009295544,
            "genType": "CUSTOM",
            "name": "testquality-llhls",
            "qualityIds": [
              1,
              2
            ],
            "qualities": [
              {
                "disabled": false,
                "id": 1,
                "status": "CREATED",
                "createdTime": 1546300800000,
                "genType": "SYSTEM",
                "name": "bypass",
                "type": "BYPASS",
                "video": {},
                "audio": {
                  "bypass": true
                }
              },
              {
                "disabled": false,
                "id": 2,
                "status": "CREATED",
                "createdTime": 1546300800000,
                "genType": "SYSTEM",
                "name": "1080p-16-9",
                "type": "NORMAL",
                "video": {
                  "fps": 30,
                  "bitrate": 5000000,
                  "bframes": 0,
                  "level": -1,
                  "width": 1920,
                  "height": 1080,
                  "bypass": false,
                  "codec": "H264",
                  "profile": "HIGH",
                  "rateControl": "VBR",
                  "videoH264ParamRefFrames": 1
                },
                "audio": {
                  "codec": "AAC",
                  "profile": "LC",
                  "samplerate": 48000,
                  "channels": 0,
                  "bitrate": 192,
                  "bypass": false
                }
              }
            ],
            "enableHlsTimedMetadata": true,
            "isEnabledUll": true,
            "targetLatency": 3,
            "timedMetadata": {
              "key": "utc",
              "header": "ncloud.livestation.metadata",
              "interval": 1000
            }
          }
        }
        HTTP

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.