ライブカーテンを開始する
- 印刷する
- PDF
ライブカーテンを開始する
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Live Stationのライブカーテンの動作のための APIです。作成したライブカーテンのコンテンツリストの照会のために、ライブカーテンコンテンツリストの照会 APIを提供します。
注意
- ライブカーテンリクエスト時のご注意
- ライブカーテンをご利用いただくために、ライブカーテンコンテンツを必ず作成してください。
- ライブカーテン機能は、 配信中 のチャネルでのみご利用いただけます。
- 複数のライブカーテンコンテンツの mp4をご利用される場合、同じ解像度の mp4のみリクエストできます。
- ライブカーテン機能は、以下の条件を満たすチャネルでのみご利用いただけます。
- チャンネル: Generalチャンネル(HLSチャンネルのみ対応)
- V2Lチャンネル、Re-Streamチャンネルは未対応
- 画質設定: bypass(passthrough)、audio only画質が含まれていない画質設定
- チャンネル: Generalチャンネル(HLSチャンネルのみ対応)
- ライブカーテン中に、 録画終了 をリクエストすると、処理中のライブカーテンが終了されます。(既存の配信動画に切り替え)
- ライブカーテンのリクエスト以降、ライブカーテンコンテンツの HLS url露出反映時間は、ts duration X ts count時間と比例します。
- 例) ts durationが2秒、ts count 3の場合、ライブカーテンをリクエストして7-8秒程度経過してから HLS urlを通じて確認可能
- ライブカーテンをご利用いただくために、ライブカーテンコンテンツを必ず作成してください。
参考
- ライブカーテン
- 作成したライブカーテンコンテンツを通じて、指定する時点からライブカーテン機能をご利用いただけます。
- ライブカーテンを開始すると、即時リクエストしたライブカーテンに切り替えられます。
- 入力時間(ライブカーテンの維持時間)を通じて、ライブカーテンを維持する時間を設定することができます。
- ライブカーテンの処理時間を入力しない場合、ライブカーテン機能がデフォルトで3分間維持されます。
- 入力時間によってライブカーテンの維持時間が過ぎた後には、既存配信動画に切り替えられます。
リクエスト
POST https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/curtain/insert
リクエストヘッダ
| ヘッダ名 | 必須有無 | 説明 |
|---|---|---|
| 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) |
リクエストボディ
| フィールド名 | 必須有無 | タイプ | 制限事項 | 説明 |
|---|---|---|---|---|
| contentId | Yes | Array | ライブカーテンを開始するライブカーテンコンテンツ ID | |
| insertTime | No | Integer | - 1,2,3,4,5,6,7,8,9,10 | ライブカーテン機能を維持する時間(単位: 分) - insertTimeを入力しない場合、デフォルトで3分に設定 |
レスポンス
| フィールド名 | タイプ | 説明 | 備考 |
|---|---|---|---|
| content | Object | ライブカーテンのオブジェクト | |
| content.content | Object | ライブカーテンのコンテンツオブジェクト | |
| content.content.ids | Integer | ライブカーテンのコンテンツ ID | |
| content.content.insertTime | Integer | ライブカーテン機能を維持する時間(単位: 分) | |
| content.content.responseTime | Timestamp | ライブカーテン処理リクエストのレスポンス時間 | |
| content.channelId | String | ライブカーテンを実施するチャンネル ID | |
| content.isLiveCurtain | Boolean | ライブカーテンの処理中の有無 |
例
レスポンス例
HTTP/1.1 200 OK
Server: nginx
Date: Fri, 19 Jul 2022 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
{
"content": {
"content": {
"ids": [
1162
],
"insertTime": 10,
"responseTime": 1658229073776
},
"channelId": "ls-20220623115623-fHnXy",
"isLiveCurtain": true
}
}
この記事は役に立ちましたか?