チャンネルの作成
- 印刷する
- 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-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 IDx-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 | GLOBAL_CDN、GLOBAL_EDGE | CDN+はサポートしない |
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 | 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": "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"
}
}
}
この記事は役に立ちましたか?