GetClip - Amazon Kinesis Video Streams

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

GetClip

在指定時間範圍內,從指定的視訊串流下載包含已封存的隨選媒體的 MP4 檔案 (剪輯片段)。

StreamName 和 Streamarn 參數都是選擇性的,但您必須在呼叫此 API 作業時指定 StreamName 或 StreamArn。

注意

您必須先呼叫 GetDataEndpoint API 以取得端點。然後使用 --end 點 url 參數將GetClip請求發送到此端點。

Amazon Kinesis 影片串流對於透過 MP4 提供資料有以下要求:

您可以透過監控 GetClip.OutgoingBytes Amazon CloudWatch 指標來監控傳出資料量。如需使用 CloudWatch 監視 Kinesis Video Streams 的相關資訊,請參閱監控 Kinesis Video Streams。如需定價資訊,請參閱 Amazon Kinesis Video Streams 定價和定AWS。外寄資 AWS 料需支付費用。

請求語法

POST /getClip HTTP/1.1 Content-type: application/json { "ClipFragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "StreamARN": "string", "StreamName": "string" }

URI 請求參數

請求不會使用任何 URI 參數。

請求主體

請求接受採用 JSON 格式的下列資料。

ClipFragmentSelector

要求的剪輯片段的時間範圍和時間戳記的來源。

類型:ClipFragmentSelector 物件

必要:是

StreamARN

要擷取媒體剪輯的資料流的 Amazon 資源名稱 (ARN)。

您必須指定 StreamName 或串流網路。

類型:字串

長度限制:長度下限為 1。長度上限為 1024。

模式:arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

必要:否

StreamName

要擷取媒體片段的資料流名稱。

您必須指定 StreamName 或串流網路。

類型:字串

長度限制:長度下限為 1。長度上限為 256。

模式:[a-zA-Z0-9_.-]+

必要:否

回應語法

HTTP/1.1 200 Content-Type: ContentType Payload

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

回應會傳回下列 HTTP 標頭。

ContentType

要求剪輯片段中媒體的內容類型。

長度限制:長度下限為 1。長度上限為 128。

模式:^[a-zA-Z0-9_\.\-]+$

回應傳回以下內容作為 HTTP 主體。

Payload

傳統的 MP4 文件,其中包含來自指定視頻流的媒體剪輯。輸出將包含指定開始時間戳記的前 100 MB 或前 200 個片段。如需詳細資訊,請參閱 Kinesis Video Streams 限制

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

ClientLimitExceededException

Kinesis Video Streams 已限制要求,因為您已超過限制。稍後再嘗試撥打電話。如需有關限制的資訊,請參閱 Kinesis Video Streams 限制

HTTP 狀態碼:400

InvalidArgumentException

指定的參數超出其限制、不受支援或無法使用。

HTTP 狀態碼:400

InvalidCodecPrivateDataException

視訊串流中至少一個軌道中的編解碼器私人資料對此作業無效。

HTTP 狀態碼:400

InvalidMediaFrameException

根據指定的編解碼器,無法剖析要求剪輯片段中的一個或多個影格。

HTTP 狀態碼:400

MissingCodecPrivateDataException

在視訊串流的至少一個軌道中找不到轉碼器私人資料。

HTTP 狀態碼:400

NoDataRetentionException

GetImages要求不保留資料的串流 (也就是說,a DataRetentionInHours 為 0)。

HTTP 狀態碼:400

NotAuthorizedException

狀態碼:403,調用者未授權在給定流上執行操作,或令牌已過期。

狀態碼:

ResourceNotFoundException

GetImages當 Kinesis 影片串流找不到您指定的串流時,就會擲回此錯誤。

GetHLSStreamingSessionURL如果在請求的時間範圍內沒有片段PlaybackMode的流請求具有 ON_DEMAND or LIVE_REPLAY 的會話,或者如果在過去 30 秒內沒有片段PlaybackModeLIVE流請求具有 of 的會話,則GetDASHStreamingSessionURL拋出此錯誤。

HTTP 狀態碼:404

UnsupportedStreamMediaTypeException

媒體類型 (例如 h.264 或 h.265 視訊或 AAC 或 G.711 音訊) 無法從播放工作階段的第一個片段中曲目的轉碼器識別碼來決定。音軌 1 的轉碼器 ID 應該是V_MPEG/ISO/AVC音軌 2 的編解碼器識別碼 (選擇性) A_AAC

HTTP 狀態碼:400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: