チャンネルの作成
- 印刷する
- PDF
チャンネルの作成
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
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-timestamp | YES | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなすx-ncp-apigw-timestamp:{Timestamp} |
x-ncp-iam-access-key | YES | NAVERクラウドプラットフォームポータルから発行された Access Key ID値x-ncp-iam-access-key:{Sub Account Access Key} |
x-ncp-apigw-signature-v2 | YES | Access Key ID値と Secret Keyで暗号化した署名x-ncp-apigw-signature-v2:{API Gateway Signature} |
Content-Type | YES | Request body content typeを application/jsonに指定Content-Type: application/json |
x-ncp-region_code | YES | リージョンコード(KR) |
リクエストボディ
フィールド名 | 必須有無 | タイプ | 制限事項 | 説明 |
---|---|---|---|---|
channelName | Yes | String | 最小3文字以上、最大20文字まで入力可能 記号の「_」を許可 | 作成するチャンネル名 |
outputProtocol | Optional | String | HLS HLS,DASH LL_HLS | 出力プロトコルの設定 入力しない場合、HLSに設定される |
envType | Optional | String | DEV, STAGE, REAL | 作成するチャンネルの使用区分のための設定 入力しない場合、REALに設定される |
cdn | Yes | Object | CDN Object | |
cdn.createCdn | Yes | Boolean | true, false | CDN Object |
cdn.cdnType | Yes | String | CDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE | |
cdn.profileId | Yes | Integer | GLOBAL_EDGEの新規作成時に必要な Global Edgeのプロファイル | |
cdn.regionType | Yes | String | KOREA,JAPAN,GLOBAL | Global Edgeのサービスエリア |
cdn.cdnInstanceNo | Optional | Integer | cdn.createCdnが falseの場合、必ず設定すること | |
qualitySetId | Yes | Integer | ||
drmEnabledYn | Yes | Boolean | DRM Encryption設定の適用有無 | |
drm | Optional | Object | Live Stationを活用した DRM Encryption設定 DRM設定時、FairPlay、Widevine/PlayReady DRMサポート | |
drm.siteId | Optional | String | One Click Multi DRMサービスで作成した site id | |
drm.contentId | Optional | String | DRM Encryptionを適用するコンテンツの固有 ID DRMパッケージのために使用し、最低3文字以上の英数字または 「-」(ハイフン)、「_」(アンダースコア)を含む最大100文字まで入力可能です。 |
レスポンス
フィールド名 | タイプ | 説明 | 備考 |
---|---|---|---|
channelId | String | ||
channelName | String | ||
outputProtocol | String | HLS HLS, DASH LL_HLS | |
envType | String | DEV, STAGE, REAL | |
cdn | Object | ||
cdn.createCdn | Boolean | ||
cdn.cdnType | String | CDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE | |
cdn.profileId | Integer | GLOBAL_EDGEの新規作成時に必要な Global Edgeのプロファイル | |
cdn.regionType | String | Global Edgeのサービスエリア | KOREA,JAPAN,GLOBAL |
cdn.cdnInstanceNo | Integer | cdn.createCdnが falseの場合、必ず設定すること | |
qualitySetId | Integer | ||
type | String | ||
drmEnabledYn | Boolean | DRM Encryption設定の適用有無 | |
drm | Object | Live Stationを活用した DRM Encryption設定 DRM設定時、FairPlay、Widevine/PlayReady DRMサポート | |
drm.siteId | String | One Click Multi DRMサービスで作成した site id | |
drm.contentId | String | DRM 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": "CDN_PLUS"
},
"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": "CDN_PLUS",
"cdnInstanceNo": 1541959
},
"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": "CDN_PLUS",
"cdnInstanceNo": 1541959
},
"qualitySetId": 4,
"envType": "REAL",
"outputProtocol": "HLS",
"channelId": "ls-20211122220557-mUv3r",
"type": "VOD",
"drmEnabledYn": true,
"drm": {
"siteId": "drm-20231115142326-nHyNw",
"contentId": "my-Test-Multidrm"
}
}
}
この記事は役に立ちましたか?