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.

Génération automatique d'images en temps réel

Amazon Kinesis Video Streams permet de transcoder et de diffuser des images. Kinesis Video Streams extrait automatiquement les images des données vidéo en temps réel et les diffuse vers le compartiment Amazon S3 que vous avez spécifié. La mise en œuvre de l'extraction automatique d'images en temps réel implique les étapes suivantes :

Les procédures suivantes fournissent des instructions pour effectuer chacune de ces étapes.

Si vous utilisez une clé gérée par le client, assurez-vous que le rôle effectuant les PutMedia appels (uploader) dispose des autorisations suivantes, qui sont requises pour chiffrer et déchiffrer les données, ainsi que pour accéder au compartiment Amazon S3.

Pour de plus amples informations, veuillez consulter Comment démarrer avec le chiffrement côté serveur ?.

Kinesis Video Streams génère et diffuse des images uniquement pour les fragments dotés de la balise de génération d'images. Toutes les métadonnées de fragment supplémentaires fournies avec les balises de génération d'images Amazon S3 seront enregistrées en tant que métadonnées Amazon S3.

Voici un exemple de ce à quoi ressemble la structure des balises de métadonnées des fragments à l'aide de cet mkvinfo utilitaire. La balise de génération d'image est une balise MKV simple avec une clé de AWS_KINESISVIDEO_IMAGE_GENERATION et aucune valeur. Pour plus d'informations, consultez la section Exemple de balises vidéo dans la documentation Matroska.

|+ Tags
| + Tag
|  // MANDATORY: Predefined MKV tag to trigger image generation for the fragment
|  + Simple
|   + Name: AWS_KINESISVIDEO_IMAGE_GENERATION

|  // OPTIONAL: S3 prefix which will be set as prefix for generated image.
|  + Simple
|   + Name: AWS_KINESISVIDEO_IMAGE_PREFIX 
|   + String: image_prefix_in_s3 // 256 bytes max

| // OPTIONAL: Key value pairs that will be persisted as S3 Image object metadata.
|  + Simple
|   + Name: CUSTOM_KEY_1 // Max 128 bytes
|   + String: CUSTOM_VALUE_1 // Max 256 bytes
|  + Simple
|   + Name: CUSTOM_KEY_2 // Max 128 bytes
|   + String: CUSTOM_VALUE_2 // Max 256 bytes

Ajouter des balises de génération d'images à des fragments

Kinesis Video Streams génère et diffuse des images uniquement pour les fragments dotés de la balise de génération d'image. Kinesis Video Streams reconnaît ces balises MKV spéciales et lance le processus de génération d'images en fonction de la configuration de traitement d'image du flux.

Lorsque vous utilisez le SDK Kinesis Video Streams Producer pour télécharger du contenu multimédia, vous utilisez la putKinesisVideoEventMetadata méthode pour ajouter la balise de génération d'image à chaque fragment que vous souhaitez baliser. Un nouveau fragment commence lorsqu'il putFrame est appelé avec un cadre contenant le keyframe drapeau.

Si vous mettez en ligne une vidéo préenregistrée, elle peut être mise en ligne à un débit différent de celui auquel elle a été enregistrée, en fonction de la vitesse de votre réseau. Nous vous recommandons d'utiliser l'horodatage du producteur pour configurer la génération d'images si vous souhaitez générer des images à intervalles réguliers sur la base des horodatages d'origine de la vidéo, et de ne pas utiliser les horodatages du serveur générés en fonction de la fréquence à laquelle Amazon Kinesis Video Streams a reçu votre vidéo.

Pour voir un exemple complet de ce code, consultez l'exemple de VideoOnlyRealtimeStreamingSample code dans GitHub.

// Setup sample frame
MEMSET(frameBuffer, 0x00, frameSize);
frame.frameData = frameBuffer;
frame.version = FRAME_CURRENT_VERSION;
frame.trackId = DEFAULT_VIDEO_TRACK_ID;
frame.duration = HUNDREDS_OF_NANOS_IN_A_SECOND / DEFAULT_FPS_VALUE;
frame.decodingTs = defaultGetTime(); // current time
frame.presentationTs = frame.decodingTs;

Frame eofr = EOFR_FRAME_INITIALIZER;

while(defaultGetTime() > streamStopTime) {
    frame.index = frameIndex;
    frame.flags = fileIndex % DEFAULT_KEY_FRAME_INTERVAL == 0 ? FRAME_FLAG_KEY_FRAME : FRAME_FLAG_NONE;
    frame.size = SIZEOF(frameBuffer);

    CHK_STATUS(readFrameData(&frame, frameFilePath));

    // 1. End the previous fragment
    if (frame.flags == FRAME_FLAG_KEY_FRAME && !firstFrame) {
        putKinesisVideoFrame(streamHandle, &eofr);
    }

    // 2. putFrame call
    CHK_STATUS(putKinesisVideoFrame(streamHandle, &frame));

    if (frame.flags == FRAME_FLAG_KEY_FRAME) {
        // 3. Adding the image generation tag
        CHK_STATUS(putKinesisVideoEventMetadata(streamHandle, STREAM_EVENT_TYPE_IMAGE_GENERATION, NULL);)

        // 4. Adding fragment metadata
        for (n = 1; n <= 5; n++) {
            SNPRINTF(metadataKey, METADATA_MAX_KEY_LENGTH, "SAMPLE_KEY_%d", n);
            SNPRINTF(metadataValue, METADATA_MAX_VALUE_LENGTH, "SAMPLE_VALUE_%d", frame.index + n);
            CHK_STATUS(putKinesisVideoFragmentMetadata(streamHandle, metadataKey, metadataValue, FALSE));
        }
    }
    defaultThreadSleep(frame.duration);

    frame.decodingTs += frame.duration;
    frame.presentationTs = frame.decodingTs;
    frameIndex++;
    fileIndex++;
    fileIndex = fileIndex % NUMBER_OF_FRAME_FILES;
    firstFrame = TRUE;
}

// 5. End the final fragment
putKinesisVideoFrame(streamHandle, &eofr);

Les éléments de l'exemple de code permettant de configurer des cadres d'échantillonnage sont expliqués comme suit :

Utilisation des exemples pour ajouter des balises de génération d'images

Vous pouvez l'utiliser kvs_gstreamer_audio_video_sample dans le SDK C++ Producer si vous souhaitez une option de ligne de commande pour ajouter des balises de génération d'images. Activez cette fonctionnalité en ajoutant l'-e bothargument -e image ou, comme illustré dans l'exemple suivant.

./kvs_gstreamer_audio_video_sample stream-name \
  -f video-to-upload.mp4 \
  -e both

Pour plus d'informations sur cet exemple d'application, consultez Amazon Kinesis Video Streams CPP Producer, le plug-in GStreamer et le fichier JNI README dans. GitHub

Trajectoire de l'objet Amazon S3 (image)

Le chemin de l'objet S3 décrit l'emplacement dans le compartiment S3 configuré où l'image générée sera diffusée. Il utilise le format suivant :

ImagePrefix_AccountID_StreamName_ImageTimecode_RandomID.file-extension

Les éléments du chemin de l'objet sont définis comme suit :

Dans cet exemple, le chemin de l'objet pour les images générées se présente comme suit :

111122223333_demo-stream_16907729324_f20f9add-75e7-4399-a30f-fc7aefb1bab7.jpg

Récupération des métadonnées d'une image

Vous pouvez utiliser la console S3 ou l'interface de ligne de commande pour récupérer les métadonnées des images générées.

Kinesis Video Streams définit le numéro du fragment, l'horodatage du producteur et du serveur, ainsi que les métadonnées du type de contenu de l'image générée, le tout formaté en tant que métadonnées d'objet Amazon S3. Si des balises MKV supplémentaires sont présentes, elles seront également ajoutées en tant que métadonnées d'objet Amazon S3. L'exemple suivant montre comment utiliser la commande d'API head-object d'Amazon S3 pour récupérer les métadonnées de l'objet. La réponse inclut les métadonnées créées par Kinesis Video Streams.

aws s3api head-object --bucket my-bucket-name --key 111122223333_demo-stream_1690707290324_f20f9add-7e57-4399-a30f-fc7aefb1bab7.jpg
{
    "AcceptRanges": "bytes",
    "LastModified": "2023-07-30T08:54:51+00:00",
    "ContentLength": 22693,
    "ETag": "\"63e03cb6d57f77e2db984c1d344b1083\"",
    "ContentType": "image/jpeg",
    "ServerSideEncryption": "AES256",
    "Metadata": {
        "aws_kinesisvideo_producer_timestamp": "1690707290324",
        "aws_kinesisvideo_server_timestamp": "1690707289209",
        "aws_kinesisvideo_fragment_number": "91343852333182036507421233921329142742245756394"
    }
}

Pour plus d'informations sur les métadonnées des objets S3, consultezhttps://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html.

Recommandations d'URI Amazon S3 pour se protéger contre la limitation

Si vous écrivez des milliers d'images sur Amazon S3, il existe un risque d'étranglement. Pour plus d'informations, consultez la section Limites de requêtes de saisie du préfixe S3.

Un préfixe Amazon S3 commence par une limite PUT de 3 500 requêtes PUT par seconde, et augmentera progressivement au fil du temps pour les préfixes uniques. Évitez d'utiliser des dates et des heures comme préfixes Amazon S3. Les données codées temporelles auront un impact sur un préfixe à la fois et changeront également régulièrement, invalidant les mises à l'échelle des préfixes précédents.

Pour permettre une mise à l'échelle plus rapide et cohérente d'Amazon S3, nous vous recommandons d'ajouter un préfixe aléatoire, tel qu'un code hexadécimal ou un UUID, à l'URI de destination Amazon S3. Par exemple, les préfixes de code hexadécimal répartiront naturellement vos demandes de manière aléatoire entre 16 préfixes différents (un préfixe pour chaque caractère hexadécimal unique), ce qui autorisera 56 000 requêtes PUT par seconde après la mise à l'échelle automatique d'Amazon S3.