GetClip - Amazon Kinesis Video Streams
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

GetClip

Lädt eine MP4-Datei (Clip) mit den archivierten On-Demand-Medien aus dem angegebenen Videostream über den angegebenen Zeitraum herunter.

StreamName Sowohl der Parameter als auch der StreamArn-Parameter sind optional, aber Sie müssen entweder den StreamName oder den StreamArn angeben, wenn Sie diesen API-Vorgang aufrufen.

Anmerkung

Sie müssen zuerst die GetDataEndpoint API aufrufen, um einen Endpunkt zu erhalten. Senden Sie dann die GetClip Anfragen mit dem Parameter --endpoint-url an diesen Endpunkt.

Für einen Amazon Kinesis Kinesis-Videostream gelten die folgenden Anforderungen für die Bereitstellung von Daten über MP4:

Sie können die Menge der ausgehenden Daten überwachen, indem Sie die GetClip.OutgoingBytes CloudWatch Amazon-Metrik überwachen. Informationen CloudWatch zur Überwachung von Kinesis Video Streams finden Sie unter Kinesis Video Streams überwachen. Preisinformationen finden Sie unter Amazon Kinesis Video Streams — Preise und AWS Preise. Für ausgehende AWS Daten fallen Gebühren an.

Wichtig

Die in jedem Fragment enthaltenen privaten Codec Data (CPD) enthalten codecspezifische Initialisierungsinformationen wie Bildrate, Auflösung und Kodierungsprofil, die für die korrekte Dekodierung des Fragments erforderlich sind. CPD-Änderungen zwischen den Zielfragmenten des resultierenden Clips werden nicht unterstützt. Die CPD muss auf den abgefragten Medien konsistent bleiben, andernfalls wird ein Fehler zurückgegeben.

Wichtig

Änderungen nachverfolgen wird nicht unterstützt. Die Titel müssen in den abgefragten Medien einheitlich sein. Es wird ein Fehler zurückgegeben, wenn die Fragmente im Stream nicht mehr nur Video enthalten, sondern sowohl Audio als auch Video enthalten, oder wenn eine AAC-Audiospur in eine A-Law-Audiospur umgewandelt wird.

Anforderungssyntax

POST /getClip HTTP/1.1
Content-type: application/json

{
   "ClipFragmentSelector": { 
      "FragmentSelectorType": "string",
      "TimestampRange": { 
         "EndTimestamp": number,
         "StartTimestamp": number
      }
   },
   "StreamARN": "string",
   "StreamName": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ClipFragmentSelector

Der Zeitbereich des angeforderten Clips und die Quelle der Zeitstempel.

Typ: ClipFragmentSelector Objekt

Erforderlich: Ja

StreamARN

Der Amazon-Ressourcenname (ARN) des Streams, für den der Medienclip abgerufen werden soll.

Sie müssen entweder den StreamName oder den StreamArn angeben.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.

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

Erforderlich: Nein

StreamName

Der Name des Streams, für den der Medienclip abgerufen werden soll.

Sie müssen entweder den StreamName oder den StreamArn angeben.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-Type: ContentType

Payload

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die Antwort gibt die folgenden HTTP-Header zurück.

ContentType

Der Inhaltstyp der Medien im angeforderten Clip.

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

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

Die Antwort gibt folgendes als HTTP-Hauptteil zurück.

Payload

Herkömmliche MP4-Datei, die den Medienclip aus dem angegebenen Videostream enthält. Die Ausgabe enthält die ersten 100 MB oder die ersten 200 Fragmente des angegebenen Startzeitstempels. Weitere Informationen finden Sie unter Limits für Kinesis Video Streams.

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

ClientLimitExceededException

Kinesis Video Streams hat die Anfrage gedrosselt, weil Sie ein Limit überschritten haben. Versuchen Sie später, den Anruf zu tätigen. Informationen zu Limits finden Sie unter Kinesis Video Streams Streams-Limits.

HTTP Status Code: 400

InvalidArgumentException

Ein angegebener Parameter überschreitet seine Beschränkungen, wird nicht unterstützt oder kann nicht verwendet werden.

HTTP Status Code: 400

InvalidCodecPrivateDataException

Die privaten Codec-Daten in mindestens einem der Tracks des Videostreams sind für diesen Vorgang nicht gültig.

HTTP Status Code: 400

InvalidMediaFrameException

Ein oder mehrere Frames im angeforderten Clip konnten nicht auf der Grundlage des angegebenen Codecs analysiert werden.

HTTP Status Code: 400

MissingCodecPrivateDataException

In mindestens einem der Spuren des Videostreams wurden keine privaten Codec-Daten gefunden.

HTTP Status Code: 400

NoDataRetentionException

GetImageswurde für einen Stream angefordert, der keine Daten speichert (d. h. einen Wert DataRetentionInHours von 0 hat).

HTTP Status Code: 400

NotAuthorizedException

Statuscode: 403, Der Aufrufer ist nicht berechtigt, einen Vorgang mit dem angegebenen Stream auszuführen, oder das Token ist abgelaufen.

HTTP-Statuscode: 401

ResourceNotFoundException

GetImageslöst diesen Fehler aus, wenn Kinesis Video Streams den von Ihnen angegebenen Stream nicht finden kann.

GetHLSStreamingSessionURLund GetDASHStreamingSessionURL gibt diesen Fehler aus, wenn eine Sitzung mit einem PlaybackMode of ON_DEMAND oder für einen Stream angefordert LIVE_REPLAY wird, der innerhalb des angeforderten Zeitraums keine Fragmente enthält, oder wenn eine Sitzung mit einem PlaybackMode of für einen Stream angefordert LIVE wird, der innerhalb der letzten 30 Sekunden keine Fragmente enthält.

HTTP Status Code: 404

UnsupportedStreamMediaTypeException

Der Medientyp (z. B. h.264- oder h.265-Video oder AAC- oder G.711-Audio) konnte anhand der Codec-IDs der Titel im ersten Fragment für eine Wiedergabesitzung nicht bestimmt werden. Die Codec-ID für Track 1 sollte V_MPEG/ISO/AVC und optional die Codec-ID für Track 2 sein. A_AAC

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: