GetClip - Amazon Kinesis Video Streams
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

GetClip

Télécharge un fichier MP4 (clip) contenant le contenu multimédia archivé à la demande à partir du flux vidéo spécifié pendant la période spécifiée.

Les paramètres StreamName et StreamArn sont facultatifs, mais vous devez spécifier le StreamName ou le StreamArn lorsque vous appelez cette opération d'API.

Note

Vous devez d'abord appeler l'GetDataEndpointAPI pour obtenir un point de terminaison. Envoyez ensuite les GetClip demandes à ce point de terminaison à l'aide du paramètre --endpoint-url.

Un flux vidéo Amazon Kinesis doit répondre aux exigences suivantes pour fournir des données via MP4 :

Vous pouvez contrôler la quantité de données sortantes en surveillant la CloudWatch métrique GetClip.OutgoingBytes Amazon. Pour plus d'informations sur l'utilisation CloudWatch de Kinesis Video Streams pour surveiller les Kinesis Video Streams, consultez la section Surveillance des Kinesis Video Streams. Pour plus d'informations sur les tarifs, consultez la section Tarification AWS et tarification d'Amazon Kinesis Video Streams. Des frais s'appliquent pour AWS les données sortantes.

Important

Les données privées du codec (CPD) contenues dans chaque fragment contiennent des informations d'initialisation spécifiques au codec, telles que la fréquence d'images, la résolution et le profil de codage, qui sont nécessaires pour décoder correctement le fragment. Les modifications du CPD ne sont pas prises en charge entre les fragments cibles du clip obtenu. Le CPD doit rester cohérent sur le support demandé, sinon une erreur sera renvoyée.

Important

Le suivi des modifications n'est pas pris en charge. Les pistes doivent rester cohérentes sur l'ensemble du support demandé. Une erreur est renvoyée si les fragments du flux ne contiennent plus que de la vidéo mais contiennent à la fois du son et de la vidéo, ou si une piste audio AAC est remplacée par une piste audio A-Law.

Syntaxe de la demande

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

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

Paramètres de demande URI

La demande n’utilise pas de paramètres URI.

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

ClipFragmentSelector

La plage horaire du clip demandé et la source des horodatages.

Type : objet ClipFragmentSelector

Obligatoire : oui

StreamARN

Le nom de ressource Amazon (ARN) du flux pour lequel vous souhaitez récupérer le clip multimédia.

Vous devez spécifier le StreamName ou le StreamArn.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.

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

Obligatoire : non

StreamName

Nom du flux pour lequel vous souhaitez récupérer le clip multimédia.

Vous devez spécifier le StreamName ou le StreamArn.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.

Modèle : [a-zA-Z0-9_.-]+

Obligatoire : non

Syntaxe de la réponse

HTTP/1.1 200
Content-Type: ContentType

Payload

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

La réponse renvoie les en-têtes HTTP suivants.

ContentType

Type de contenu du média contenu dans le clip demandé.

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 128.

Modèle : ^[a-zA-Z0-9_\.\-]+$

La réponse renvoie ce qui suit en tant que corps HTTP.

Payload

Fichier MP4 traditionnel contenant le clip multimédia du flux vidéo spécifié. La sortie contiendra les 100 premiers Mo ou les 200 premiers fragments de l'horodatage de début spécifié. Pour plus d'informations, consultez Kinesis Video Streams Limits.

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

ClientLimitExceededException

Kinesis Video Streams a limité la demande car vous avez dépassé une limite. Essayez de passer l'appel plus tard. Pour plus d'informations sur les limites, consultez Kinesis Video Streams Limits.

Code d’état HTTP : 400

InvalidArgumentException

Un paramètre spécifié dépasse ses restrictions, n'est pas pris en charge ou ne peut pas être utilisé.

Code d’état HTTP : 400

InvalidCodecPrivateDataException

Les données privées du codec contenues dans au moins une des pistes du flux vidéo ne sont pas valides pour cette opération.

Code d’état HTTP : 400

InvalidMediaFrameException

Une ou plusieurs images du clip demandé n'ont pas pu être analysées en fonction du codec spécifié.

Code d’état HTTP : 400

MissingCodecPrivateDataException

Aucune donnée privée du codec n'a été trouvée dans au moins une des pistes du flux vidéo.

Code d’état HTTP : 400

NoDataRetentionException

GetImagesa été demandé pour un flux qui ne conserve pas de données (c'est-à-dire qui a une DataRetentionInHours valeur de 0).

Code d’état HTTP : 400

NotAuthorizedException

Code d'état : 403, l'appelant n'est pas autorisé à effectuer une opération sur le flux donné, ou le jeton a expiré.

Code d'état HTTP : 401

ResourceNotFoundException

GetImagesgénère cette erreur lorsque Kinesis Video Streams ne trouve pas le flux que vous avez spécifié.

GetHLSStreamingSessionURLet GetDASHStreamingSessionURL génère cette erreur si une session avec un PlaybackMode de ON_DEMAND ou LIVE_REPLAY est demandée pour un flux qui ne contient aucun fragment dans la plage de temps demandée, ou si une session avec un PlaybackMode of LIVE est demandée pour un flux qui ne contient aucun fragment au cours des 30 dernières secondes.

Code d’état HTTP : 404

UnsupportedStreamMediaTypeException

Le type de média (par exemple, vidéo h.264 ou h.265 ou audio AAC ou G.711) n'a pas pu être déterminé à partir des identifiants de codec des pistes du premier fragment d'une session de lecture. L'identifiant du codec pour la piste 1 doit être V_MPEG/ISO/AVC et, éventuellement, l'identifiant du codec pour la piste 2 doit être. A_AAC

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :