チャンネルの作成

Live Stationのチャンネルを作成する APIです。作成したチャンネルを照会するためのチャンネルリスト照会 APIとチャンネル情報照会 APIを提供します。

コンテンツ保護設定

Live Station DRM Encryptionはリアルタイムコンテンツの Multi DRMをサポートします。
チャンネル作成内の DRM設定領域て簡単に DRM機能を設定できます。選択した OutputProtocolに応じて Multi DRM Encryptionをサポートします。
DRM技術別暗号化方式と対応する端末、他のプラットフォームとバージョンの詳細は、リンクをご参照ください。

| 暗号化方式 | プロトコル | DRMタイプ | 暗号化アルゴリズム | 対応する端末 |
|--- |--- |--- |--- |--- |
| DRM | HLS | FairPlay | AES-CBC | Mac/iOS Safariブラウザ、iOS/iPadOS/tvOSアプリ、HLS HTML5 |
| DRM | DASH | PlayReady、Widevine | CENC (Common Encryption) | MS Edge、Internet Explorer 11、Google Chrome、Firefox、Opera DASH HTML5 |

• 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",
      "cdnDomain": "mycdn.edge.naverncp.com",
      "profileId": 299,
      "cdnInstanceNo": 1541959
   },
   "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",
      "cdnDomain": "mycdn.edge.naverncp.com",
      "profileId": 299,
      "cdnInstanceNo": 1541959
    },
    "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
  }
}