チャンネルの作成
    • PDF

    チャンネルの作成

    • PDF

    記事の要約

    Live Stationの VODチャンネルを作成する 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/vod/channels
    

    リクエストヘッダ

    ヘッダ名必須の有無説明
    x-ncp-apigw-timestampYES1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyYESNAVERクラウドプラットフォームポータルから発行された 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)

    リクエストボディ

    フィールド名必須の有無タイプ制限事項説明
    channelNameYesString3~20文字以内で入力可能
    記号の「_」を使用可能
    作成するチャンネルの名前
    outputProtocolOptionalStringHLS
    HLS、DASH
    LL_HLS
    出力プロトコル設定
    入力しない場合、HLSに設定される
    envTypeOptionalStringDEV、STAGE、REAL作成するチャンネルの使用区分のための設定
    入力しない場合は REALに設定される
    cdnYesObjectCDN Object
    cdn.createCdnYesBooleantrue、falseCDN Object
    cdn.cdnTypeYesStringGLOBAL_CDN、GLOBAL_EDGECDN+はサポートしない
    cdn.profileIdYesIntegerGLOBAL_EDGE新規作成時に必要な Global Edgeのプロファイル
    cdn.regionTypeYesStringKOREA、JAPAN、GLOBALGlobal Edgeのサービス地域
    cdn.cdnInstanceNoOptionalIntegercdn.createCdnが falseの場合、必ず設定
    qualitySetIdYesInteger
    drmEnabledYnYesBooleanDRM Encryption設定の適用有無
    drmOptionalObjectLive Stationを利用した DRM Encryption設定
    DRM設定時、FairPlay、Widevine/PlayReady DRMをサポート
    drm.siteIdOptionalStringOne Click Multi DRMサービスで作成した site id
    drm.contentIdOptionalStringDRM Encryption適用対象コンテンツの固有 ID
    DRMパッケージングに使用され、英数字、記号の「-」(ハイフン)、「_」(アンダースコア)のみ使用して3~100文字以内で入力できます。

    レスポンス

    フィールド名タイプ説明備考
    channelIdString
    channelNameString
    outputProtocolStringHLS
    HLS、DASH
    LL_HLS
    envTypeStringDEV、STAGE、REAL
    cdnObject
    cdn.createCdnBoolean
    cdn.cdnTypeStringGLOBAL_CDN、GLOBAL_EDGE
    cdn.profileIdIntegerGLOBAL_EDGE新規作成時に必要な Global Edgeのプロファイル
    cdn.regionTypeStringGlobal Edgeのサービス地域KOREA、JAPAN、GLOBAL
    cdn.cdnInstanceNoIntegercdn.createCdnが falseの場合、必ず設定
    qualitySetIdInteger
    typeString
    drmEnabledYnBooleanDRM Encryption設定の適用有無
    drmObjectLive Stationを利用した DRM Encryption設定
    DRM設定時、FairPlay、Widevine/PlayReady DRMをサポート
    drm.siteIdStringOne Click Multi DRMサービスで作成した site id
    drm.contentIdStringDRM Encryption適用対象コンテンツの固有 ID
    DRMパッケージングに使用され、英数字、記号の「-」(ハイフン)、「_」(アンダースコア)のみ使用して3~100文字以内で入力できます。

    リクエスト例

    POST /api/v2/vod/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": "myTestChannel",
      "cdn": {
        "createCdn": true,
        "cdnType": "GLOBAL_EDGE"
      },
      "qualitySetId": 5,
      "envType": "REAL",
      "outputProtocol": "HLS",
      "drmEnabledYn": true,
      "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
      }
    }
    
    Request body (if cdn.createCdn == false) 
    {
        "channelName": "myTestChannel",
        "cdn": {
          "createCdn": false,
          "cdnType": "GLOBAL_EDGE",
          "cdnDomain": "mycdn.edge.naverncp.com",
          "profileId": 299,
          "cdnInstanceNo": 1541959,
          "regionType": "KOREA"
        },
        "qualitySetId": 4,
        "envType": "REAL",
        "outputProtocol": "HLS",
        "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": "myTestChannel",
        "cdn": {
          "createCdn": false,
          "cdnType": "GLOBAL_EDGE",
          "cdnDomain": "mycdn.edge.naverncp.com",
          "profileId": 299,
          "cdnInstanceNo": 1541959,
          "regionType": "KOREA"
        },
        "qualitySetId": 4,
        "envType": "REAL",
        "outputProtocol": "HLS",
        "channelId": "ls-20211122220557-mUv3r",
        "type": "VOD",
        "drmEnabledYn": true,
        "drm": {
            "siteId": "drm-20231115142326-nHyNw",
            "contentId": "my-Test-Multidrm"
        }
      }
    }
    

    この記事は役に立ちましたか?

    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.