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 MP4 fichier (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'`GetDataEndpoint`API pour obtenir un point de terminaison. Envoyez ensuite les `GetClip` demandes à ce point de terminaison à l'aide du paramètre [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). Un flux vidéo Amazon Kinesis doit répondre aux exigences suivantes pour fournir des données via : MP4 + [Exigences relatives aux pistes de lecture vidéo](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + La conservation des données doit être supérieure à 0. + La piste vidéo de chaque fragment doit contenir des données privées de codec en Advanced Video Coding (AVC) pour le format H.264 et en HEVC pour le format H.265. Pour plus d'informations, consultez la [spécification ISO/IEC MPEG-4 14496-15](https://www.iso.org/standard/55980.html). Pour plus d'informations sur l'adaptation des données de flux à un format donné, voir [Indicateurs d'adaptation NAL](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html). + [La piste audio (le cas échéant) de chaque fragment doit contenir des données privées du codec au format AAC ([spécification AAC ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) ou au format MS Wave.](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html) 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html) Video Streams. Pour plus d'informations sur les tarifs, consultez la section Tarification [AWS et](https://aws.amazon.com/pricing/) tarification d'[Amazon Kinesis Video Streams](https://aws.amazon.com/kinesis/video-streams/pricing/). 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](#API_reader_GetClip_RequestSyntax) ** La plage horaire du clip demandé et la source des horodatages. Type : objet [ClipFragmentSelector](API_reader_ClipFragmentSelector.md) Obligatoire : oui ** [StreamARN](#API_reader_GetClip_RequestSyntax) ** Le nom de ressource Amazon (ARN) du flux pour lequel vous souhaitez récupérer le clip multimédia. Vous devez spécifier soit le StreamArn, StreamName soit 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](#API_reader_GetClip_RequestSyntax) ** Nom du flux pour lequel vous souhaitez récupérer le clip multimédia. Vous devez spécifier soit le StreamArn, StreamName soit 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](#API_reader_GetClip_ResponseSyntax) ** Type de contenu du média contenu dans le clip demandé. Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 128. Modèle : `^[a-zA-Z0-9_\.\-]+$` La réponse renvoie ce qui suit en tant que corps HTTP. ** [Payload](#API_reader_GetClip_ResponseSyntax) ** MP4 Fichier 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 la section [Quotas Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md). ** 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 la section [Quotas Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). 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 ** `GetImages`a été demandé pour un flux qui ne conserve pas de données (c'est-à-dire dont la valeur est `DataRetentionInHours` égale à 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 ** `GetImages`génère cette erreur lorsque Kinesis Video Streams ne trouve pas le flux que vous avez spécifié. `GetHLSStreamingSessionURL`et `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 du codec IDs 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 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetClip)