チャンネルの作成
    • PDF

    チャンネルの作成

    • PDF

    Article Summary

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

    参考

    チャンネル作成時の注意事項は、次の通りです。

    • 配信冗長化設定を使用する場合、必ずメインストリームを先に配信する必要があります。
    • LL-HLSチャンネル作成が必要な場合は、必ず Low Latency用の画質セットを活用する必要があります。
    • LL-HLSの正式版は、Global Edge CDN連携環境でのみサポートします。
    • 既に作成されている CDNを使用する場合、既存の CDNを更新する必要があります。CDNの更新方法は、ご利用ガイドをご参照ください。
    • LL-HLSチャンネルをスムーズに使用するために、キーフレームを1秒に設定することをお勧めします。配信方法の詳細は、ご利用ガイドをご参照ください。
    • Live Stationは、One Click Multi DRMと簡単な連携をサポートするもので、Single-keyパッケージのみサポートしています。
    • Passthrough画質を含む画質設定を使用するチャンネルは DRM Encryptionをサポートしません。
    参考

    Live Stationと連携した Global Edgeのコンテンツ認証(Signed URL/JWT)制御使用時の留意事項は次の通りです。

    • Global Edgeのキャッシュ設定中、Edge Authを作成したチャンネルの outputProtocolに合わせて設定します。Global Edge Auth設定変更方法の詳細は、APIガイドをご参照ください。
      • 認証除外拡張子
        • HLS : .ts, .jpg
        • HLS,DASH : .ts, .jpg, .m4s, .m4v, .m4a
        • LL_HLS: .jpg, .m4s, .m4v, .m4a
      • 認証トークンを原本に渡す拡張子
        • HLS : .m3u8
        • HLS/DASH : .m3u8, .mpd
        • LL_HLS : playlist.m3u8
    • 認証トークン発行時、Signed URL、JWTそれぞれ acl、pathに wildcard pathを入力します。認証トークン発行の詳細は、ご利用ガイドをご参照ください。
      • wildcard path : '/live/video/{channelId}/*'

    コンテンツ保護設定

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

    暗号化方式プロトコルDRMのタイプ暗号化アルゴリズムサポートデバイス
    DRMHLSFairPlayAES-CBCMac/iOS Safariブラウザ、iOS/iPadOS/tvOSアプリ、HLS HTML5
    DRMDASHPlayReady, WidevineCENC (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
    

    リクエストヘッダ

    ヘッダ名必須有無説明
    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)

    リクエストボディ

    フィールド名必須有無タイプ制限事項説明
    channelNameYesString最小3文字以上、最大20文字まで入力可能
    特殊文字の(-)を許可
    作成するチャンネル名
    envTypeOptionalStringDEV
    STAGE
    REAL
    入力しない場合、REALにデフォルト設定
    outputProtocolOptionalStringHLS
    HLS,DASH
    LL_HLS
    入力しない場合、HLSにデフォルト設定
    cdnYesObjectCDN Object
    cdn.createCdnYesBooleantrue, falseCDN Object
    cdn.cdnTypeYesStringCDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE
    cdn.profileIdYesIntegerGLOBAL_EDGEの新規作成時に必要な Global Edgeのプロファイル
    cdn.regionTypeYesStringKOREA,JAPAN,GLOBALGlobal Edgeのサービスエリア
    cdn.cdnInstanceNoOptionalIntegercdn.createCdnが falseの場合、必ず設定すること
    qualitySetIdYesIntegerLL-HLSチャネルを作成する場合に、Low Latency用の画質セットをリクエスト
    useDvrYesBooleantrue, false
    immediateOnAirOptionalBooleantrue, false配信と同時に録画が作動する自動録画オプション
    timemachineMinOptionalInteger単位は分(minutes)であり、360のみ設定可能録画開始時まで動画を見返すことができるタイムマシン機能に関するオプション
    useDvrが trueの場合、必ず設定すること
    recordYesObject
    record.formatOptionalStringMP4,HLS,ALLバケットで自動保存される録画ファイルのタイプを指定
    record.typeYesStringNO_RECORD, AUTO_UPLOAD, MANUAL_UPLOAD保存された録画ファイルのアップロードタイプを指定
    「NO_RECORD」に設定時、録画機能を利用不可
    record.bucketNameOptionalString自動保存機能を通じてライブ配信の終了後、入力した Bucketに録画ファイルが自動保存
    record.filePathOptionalString自動保存機能を通じてライブ配信の終了後、指定した filePathに録画ファイルが自動保存
    filePathは「/」から始めること
    record.accessControlOptionalStringPRIVATE, PUBLIC_READ自動保存機能を通じて録画ファイルをアップロード時、Object Storage Bucketの公開範囲を指定するオプション
    Default: PRIVATE
    isStreamFailOverOptionalBooleantrue, false配信冗長化適用のためのオプション
    配信冗長化設定で配信エンコーダーの冗長化を構成
    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
    envTypeString入力しない場合、REALにデフォルト設定DEV
    STAGE
    REAL
    outputProtocolString入力しない場合、HLSにデフォルト設定HLS
    HLS,DASH
    LL_HLS
    cdnObject
    cdn.createCdnBoolean
    cdn.cdnTypeStringCDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE
    cdn.profileIdIntegerGLOBAL_EDGEの新規作成時に必要な Global Edgeのプロファイル
    cdn.regionTypeStringGlobal EdgeのサービスエリアKOREA,JAPAN,GLOBAL
    cdn.cdnInstanceNoIntegercdn.createCdnが falseの場合、必ず設定すること
    qualitySetIdInteger
    useDvrBoolean
    immediateOnAirBoolean
    timemachineMinInteger
    recordObject
    record.formatStringMP4,HLS,ALL
    record.typeStringNO_RECORD, AUTO_UPLOAD, MANUAL_UPLOAD
    record.bucketNameString
    record.filePathString
    record.accessControlStringPRIVATE, PUBLIC_READ
    uploadPathStringAUTO_UPLOADオプション時の録画ファイルアップロードパス
    backupStreamKeyString配信冗長化のためのバックアップストリームキー
    isStreamFailOverBoolean配信冗長化設定の適用有無true, false
    originObjectCDN連携のための Live stationソース情報
    origin.originDomainStringCDN連携のための Live stationソースドメイン
    origin.originPathStringCDN連携のための Live stationソースの詳細パス
    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/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
      }
    }
    

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

    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.