スナップショットの作成
- 印刷する
- PDF
スナップショットの作成
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Live Stationのショートクリップ作成のためのスナップショット作成用 APIです。作成したスナップショットを照会するためのスナップショット情報照会 APIを提供します。
参考
- ショートクリップ機能
- チャンネルに設定されたタイムシフト(useDVR==true)設定で、目的の時点のショートクリップを作成できます。
- 作成されたスナップショットで最小100ms、最大4時間分のショートクリップを作成できます。
- スナップショット
- ショートクリップ作成のためのスナップショットを提供します。
- 録画開始から終了時まで最大4時間分の映像を提供し、スナップショットリクエスト時点に応じて複数のスナップショットを作成することができます。
- 有効なスナップショット IDは、チャンネルリスト、情報照会を通じて取得できます。
注意
- スナップショット作成時の注意点
- スナップショットは録画中の状態でのみ作成できます。
- スナップショットは、録画時間が100msを超えた後から作成できます。
- limitedDurationをリクエストする場合、直近の時点から limitedDuration時点までのスナップショットを作成できます。
- スナップショットリクエスト時間の最小時間は1分です。
- チャンネルを削除する場合、作成したスナップショットはすべて削除されます。
- 録画を再開する場合、提供するスナップショット時点も同じくリセットされます。
- 作成したスナップショットは作成時から1時間だけ有効です (1時間で有効期限切れ)。
リクエスト
POST https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/snapshot?limitedDuration={limitedDuration}
リクエストパラメータ
| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
|---|---|---|---|---|
| limitedDuration | No | Integer | 1 ~ 240 | 直近の時点から作成するスナップショットの再生時間(単位: 分) 例: 01:00に limitedDurationを1にしてリクエストする場合、00:59 ~ 01:00時点の映像を提供 |
リクエストヘッダ
| ヘッダ名 | 必須の有無 | 説明 |
|---|---|---|
| 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) |
レスポンス
| フィールド名 | タイプ | 説明 | 備考 |
|---|---|---|---|
| channelId | String | スナップショットを作成したチャンネル ID | |
| channelStatus | String | スナップショットを作成したチャンネルの状態 | CREATING、READY、PUBLISH、DELETED、BLOCK、FORCE_BLOCK、FORCE_DELETED |
| snapshot | Object | スナップショット Object | |
| snapshot.snapshotId | Integer | スナップショット ID | |
| snapshot.snapshotUrl | String | スナップショット再生 URL | スナップショット URLは作成時点から1時間まで有効です。 |
| snapshot.createdTime | Integer | スナップショットの作成時間 | |
| snapshot.expireTime | Integer | スナップショットの期限切れ時間 | |
| snapshot.duration | Integer | スナップショット作成リクエスト時間 | 単位: 分 |
例
レスポンス例
HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Jun 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": {
"channelId": "ls-20220623115623-fHnXy",
"channelStatus": "PUBLISHING",
"snapshot": {
"snapshotId": 1047,
"snapshotUrl": "https://mytest.edge.naverncp.com/dvr/snapshot/1655982268177/ls-nmssencg001/mtfpkgmjxmyecget2wjzthbeplp5vk9a7o6c/480p-16-9/1047-1655978668177.m3u8",
"createdTime": 1660637947987,
"expireTime": 1660641547987,
"duration": 1
}
}
}
この記事は役に立ちましたか?