채널 생성

Live Station 의 채널을 생성하는 API 입니다. 생성한 채널 조회를 위해 채널 목록 조회 API와 채널 정보 조회 API를 제공합니다.

콘텐츠 보호 설정

Live Station DRM Encryption 은 실시간 콘텐츠의 Multi DRM 을 지원합니다.
채널 생성 내 DRM 설정 영역에서 간편하게 DRM 기능을 설정할 수 있으며 선택한 OutputProtocol 에 따라 Multi DRM Encryption 을 지원합니다.
DRM 기술별 암호화 방식 및 지원 단말과 다른 플랫폼 및 버전에 대한 상세 정보는 링크를 참고해 주십시오.

• DRM 유형
  • FairPlay: Apple에서 제공하는 DRM 기술 규격입니다. 각 HLS 세그먼트를 AES-CBC 방식으로 암호화합니다.
  • Widevine: Google에서 제공하는 DRM 기술 규격입니다. Common Encryption 규격에 따라 AES-128 방식으로 암호화합니다.
  • PlayReady: Microsoft에서 제공하는DRM 기술 규격입니다. Common Encryption 규격에 따라 AES-128 방식으로 암호화합니다.

요청

POST https://livestation.apigw.ntruss.com/api/v2/channels

요청 헤더

요청 바디

응답

예시

요청 예시

POST /api/v2/channels
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

Request body (if cdn.createCdn == true) 
{  
   "channelName" : "testchannel",
   "cdn" : {
     "createCdn":true,
      "cdnType":"GLOBAL_EDGE",
      "profileId" : 291,
      "regionType" : "KOREA"
   },
   "qualitySetId" : 12345,
   "useDvr" : true,
   "immediateOnAir" : true,
   "timemachineMin" : 360,
   "envType" : "DEV",
   "outputProtocol" : "LL_HLS",
    "record": {
         "type": "AUTO_UPLOAD",
         "format": "MP4",
         "bucketName": "hls",
         "filePath": "/livestation",
         "accessControl": "PRIVATE"
  },
  "isStreamFailOver": true,
  "drmEnabledYn": true,
      "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
      }
}

Request body (if cdn.createCdn == false) 
{  
   "channelName" : "testchannel",
   "cdn" : {
      "createCdn" : false,
      "cdnType" : "GLOBAL_EDGE",
      "cdnInstanceNo" : 123456
   },
   "qualitySetId" : 12345,
   "useDvr" : true,
   "immediateOnAir" : true,
   "timemachineMin" : 360,
   "envType" : "DEV",
   "outputProtocol" : "HLS",
    "record": {
         "type": "AUTO_UPLOAD",
         "format": "MP4",
         "bucketName": "hls",
         "filePath": "/livestation",
         "accessControl": "PRIVATE"
  },
  "isStreamFailOver": true,
  "drmEnabledYn": true,
      "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
      }
}

응답 예시

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

{
  "content": {
     "channelName" : "testchannel",
     "channelId" : "ls-20200217154656-Rnd49",
     "cdn" : {
        "createCdn" : false,
        "cdnType" : "GLOBAL_EDGE",
        "profileId" : 223
        "cdnInstanceNo" : 123456
     }
     "qualitySetId" : 12345,
     "useDvr" : true,
     "immediateOnAir" : true,
     "timemachineMin" : 360,
     "envType": "DEV",
     "outputProtocol": "HLS,DASH",
     "uploadPath": "/hls/livestation",
      "record": {
          "type": "AUTO_UPLOAD",
          "bucketName": "hls",
          "filePath": "/livestation",
          "format": "MP4",
          "accessControl": "PRIVATE"
    },
    "origin": {
    "originDomain": "ls-k1.video.media.ntruss.com",
    "originPath": "1"
    },
  "drmEnabledYn": true,
      "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
      }
     "backupStreamKey": "lbuy4dcrxk2ctxs8uqxanpy833p08vvz?backup=true",
     "isStreamFailOver": true
  }
}