スナップショット作成
- 印刷する
- PDF
スナップショット作成
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
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 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) |
レスポンス
| フィールド名 | タイプ | 説明 | 備考 |
|---|---|---|---|
| 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://myTestCdn.ntruss.com/dvr/snapshot/1655982268177/ls-nmssencg001/mtfpkgmjxmyecget2wjzthbeplp5vk9a7o6c/480p-16-9/1047-1655978668177.m3u8",
"createdTime": 1660637947987,
"expireTime": 1660641547987,
"duration": 1
}
}
}
この記事は役に立ちましたか?