MENU
      チャンネルの作成

        チャンネルの作成


        記事の要約

        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 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
        • 認証トークン発行の際は、SignedURLに acl入力フィールド、JWTに path入力フィールドがあり、それぞれに wildcard pathを入力します。認証トークン発行方法の詳細は、ご利用ガイドをご参照ください。
          • wildcard path: '/live/video/{channelId}/*'

        コンテンツ保護設定

        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
        HTTP

        リクエストヘッダ

        ヘッダ名必須の有無説明
        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文字以内で入力可能
        記号の「_」を使用可能
        作成するチャンネルの名前
        envTypeOptionalStringDEV
        STAGE
        REAL
        入力しない場合はデフォルトで REALに設定
        outputProtocolOptionalStringHLS
        HLS、DASH
        LL_HLS
        入力しない場合はデフォルトで HLSに設定
        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の場合、必ず設定
        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の公開範囲を指定するオプション
        デフォルト: 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.cdnTypeStringGLOBAL_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",
              "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

        レスポンス例

        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
          }
        }
        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.