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.

Intégration de métadonnées dans un flux vidéo

Les métadonnées temporisées Amazon Interactive Video Service (IVS) permettent d'intégrer des métadonnées dans un flux Amazon IVS. Elles garantissent que tous vos utilisateurs reçoivent les métadonnées en même temps dans le flux vidéo, indépendamment de la latence du flux ou de l'emplacement géographique.

Que sont les métadonnées temporisées ?

Les métadonnées temporisées sont des métadonnées avec des horodatages. Elles peuvent être insérées dans un flux par programmation, à l’aide de l’API IVS ou du SDK de diffusion IVS. Lorsqu’Amazon IVS traite un flux, les métadonnées temporisées sont synchronisées avec les images audio et vidéo. Pendant la lecture, tous les utilisateurs du flux obtiennent les métadonnées en même temps par rapport au flux. Le code horaire sert de point de repère qui peut être utilisé pour déclencher une action basée sur les données, par exemple :

Les métadonnées temporisées Amazon IVS utilisent des balises ID3 intégrées dans les segments vidéo. Ils sont donc disponibles dans la vidéo enregistrée.

Configuration des autorisations IAM

Prérequis : avant de continuer, nous vous recommandons de passer en revue Mise en route avec le streaming à faible latence IVS (y compris la création d'un utilisateur IAM et la configuration d'autorisations).

Ensuite, vous devez donner à votre utilisateur IAM l’autorisation d’utiliser des métadonnées temporisées. Procédez comme suit :

Insertion de métadonnées temporisées

Vous pouvez insérer des métadonnées temporisées uniquement dans un flux actif sur un canal spécifié.

Utilisation de l'AWS CLI

Pour les tests, le moyen le plus simple d'ajouter des métadonnées termporisées est d'utiliser l'AWS CLI. Pour utiliser l’AWS CLI, il est nécessaire de télécharger et de configurer la CLI au préalable sur votre ordinateur. Vous l'avez peut-être déjà fait lorsque vous avez passé en revue Mise en route avec le streaming à faible latence IVS, mais si ce n'est pas le cas, faites-le maintenant. Pour plus de détails, consultez le ‭‬Guide de l'utilisateur de l'Interface de ligne de commande AWS‭.

Une fois que vous avez la CLI :

Utilisation de l’API Amazon IVS

Pour insérer des métadonnées temporisées par programmation, utilisez le point de terminaison PutMetadata.

Voici un exemple de requête HTTP :

POST /PutMetadata HTTP/1.1
{
    "channelArn": "my_channel",
    "metadata": "{\"question\": \"What does IVS stand for?\", \"correctIndex\": 0, \"answers\": [\"interactive video service\", \"interesting video service\", \"ingenious video service\"]}"
}

Utilisation du SDK de diffusion IVS

Vous pouvez insérer des métadonnées temporisées en bande à l’aide du SDK de diffusion IVS. Cela peut être utile pour synchroniser les métadonnées avec le contenu audio et vidéo.

Consommation de métadonnées temporisées

Utilisez le lecteur Amazon IVS pour utiliser les métadonnées temporisées intégrées dans un flux vidéo. Consultez Kit SDK du lecteur Amazon IVS et le reste de la documentation sur le lecteur.

Vous trouverez ci-dessous des exemples d'extraits qui impriment toutes les métadonnées reçues sur la console à l'aide du kit SDK du lecteur Amazon IVS. Un événement est déclenché chaque fois que la lecture atteint un segment avec des métadonnées intégrées. (L’événement est TEXT_METADATA_CUE pour le Web, onCue() pour Android et player(_:didOutputCue:) pour iOS.) Vous pouvez utiliser cet événement pour initier des fonctionnalités au sein de votre application client, telles que la mise à jour d'un widget interactif. Cet événement est déclenché à la fois pour le contenu en direct et le contenu enregistré.

Kit SDK du lecteur Amazon IVS pour le Web :

const player = IVSPlayer.create();
player.addEventListener(IVSPlayer.PlayerEventType.TEXT_METADATA_CUE,
    function (cue) {
  console.log('Timed metadata: ', cue.text);
});

Kit SDK du lecteur Amazon IVS pour Android :

@Override
public void onCue(@NonNull Cue cue) {
  if(cue instanceof TextMetadataCue) {
    Log.i("Timed Metadata: ", ((TextMetadataCue)cue).text);
  }
}

Kit SDK du lecteur Amazon IVS pour iOS :

func player(_ player: IVSPlayer, didOutputCue cue: IVSCue) {
  if let textMetadataCue = cue as? IVSTextMetadataCue {
    print("Timed Metadata: \(textMetadataCue.text)")
  }
}

Remarque : les métadonnées temporisées sont prises en charge pour iOS Safari et iOS Chrome dans la version 1.3.0 et les versions ultérieures du lecteur.

Exemple de démonstration : appli de quiz

Des exemples de code d’une appli de quiz interactive sont disponibles sur GitHub. Nous utilisons JSON via des métadonnées temporisées pour remplir une interface utilisateur de quiz et afficher les questions et les réponses. Les réponses peuvent être sélectionnées et indiquent si la sélection est correcte.

Affichage des métadonnées temporisées

Si vous le souhaitez, vous pouvez afficher les métadonnées temporisées intégrées dans votre flux en direct dans la console :

Pour en savoir plus

Consultez Using Amazon Interactive Video Service Timed Metadata, la première partie d'un billet de blog en deux parties sur l'utilisation des métadonnées temporisées Amazon IVS.