Uso de metadatos de streaming con Kinesis Video Streams - Amazon Kinesis Video Streams
Añadir metadatos a una transmisión de vídeo de Kinesis

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de metadatos de streaming con Kinesis Video Streams

Puede utilizar el SDK productor de Amazon Kinesis Video Streams para incrustar metadatos a nivel de fragmentos individuales en una transmisión de vídeo de Kinesis. Los metadatos de Kinesis Video Streams son un par clave-valor mutable. Puede utilizarlos para describir el contenido del fragmento, incrustar las lecturas de los sensores asociadas que deben transferirse junto con el fragmento real o satisfacer otras necesidades personalizadas. Los metadatos están disponibles como parte de las GetMediaForFragmentList API operaciones GetMedia o. Se almacenan junto con los fragmentos durante todo el período de retención de la transmisión. Las aplicaciones consumidoras pueden leer, procesar y reaccionar en función de los metadatos que utilizanVea la salida de las cámaras mediante la biblioteca de analizadores.

Hay dos formas de insertar los metadatos con los fragmentos de una secuencia:

  • No persistente: puede añadir metadatos una sola vez o de forma puntual a los fragmentos de una transmisión, en función de los criterios empresariales específicos que se hayan aplicado. Un ejemplo es una cámara inteligente que detecta movimiento y añade metadatos a los fragmentos correspondientes que contienen el movimiento antes de enviarlos a su transmisión de vídeo de Kinesis. Puede aplicar los metadatos al fragmento en el siguiente formato: Motion = true.

  • Persistente: puede adjuntar metadatos a fragmentos sucesivos y consecutivos de una transmisión en función de una necesidad continua. Un ejemplo es una cámara inteligente que envía las coordenadas de latitud y longitud actuales asociadas a todos los fragmentos que envía a su transmisión de vídeo de Kinesis. Puede aplicar los metadatos a todos los fragmentos en el siguiente formato: Lat = 47.608013N , Long = -122.335167W.

Puede asociar metadatos simultáneamente en los dos modos al mismo fragmento en función de las necesidades de la aplicación. Los metadatos incrustados pueden incluir objetos detectados, actividad rastreada, GPS coordenadas o cualquier otro dato personalizado que desee asociar a los fragmentos de la transmisión. Los metadatos se codifican como pares de cadenas clave-valor.

Añadir metadatos a una transmisión de vídeo de Kinesis

Los metadatos que se añaden a una transmisión de vídeo de Kinesis se modelan como MKV etiquetas, que se implementan como pares clave-valor.

Los metadatos pueden ser transitorios, como los que marcan un evento dentro de la secuencia, o persistentes, como los que identifican los fragmentos en los que se está produciendo un evento concreto. Un elemento de metadatos persistente permanece y se aplica a cada fragmento consecutivo hasta que se cancele.

nota

Los elementos de metadatos que se añaden mediante el uso de Cargar a Kinesis Video Streams son distintos del etiquetado a nivel de flujo APIs implementado conTagStream, yUntagStream. ListTagsForStream

Transmisión de metadatos API

Puede utilizar las siguientes operaciones en el productor SDK para implementar los metadatos de streaming.

PIC

PUBLIC_API STATUS putKinesisVideoFragmentMetadata(STREAM_HANDLE streamHandle, 
    PCHAR name, 
    PCHAR value, 
    BOOL persistent);

Productor de C++ SDK

/**
 * Appends a "tag" or metadata - a key/value string pair into the stream.
 */
bool putFragmentMetadata(const std::string& name, const std::string& value, bool persistent = true);

Productor de Java SDK

Puede utilizar el productor SDK de Java para añadir metadatos a un MediaSource uso deMediaSourceSink.onCodecPrivateData:

void onFragmentMetadata(final @Nonnull String metadataName, final @Nonnull String metadataValue, final boolean persistent)
throws KinesisVideoException;

Metadatos persistentes y no persistentes

En el caso de los metadatos no persistentes, puede agregar varios elementos de metadatos con el mismo nombre. El productor SDK recopila los elementos de metadatos de la cola de metadatos hasta que se añadan al siguiente fragmento. La cola de metadatos se vacía a medida que los elementos de metadatos se aplican a la secuencia. Para repetir los metadatos, llame de nuevo a putKinesisVideoFragmentMetadata o a putFragmentMetadata.

En el caso de los metadatos persistentes, el productor SDK recopila los elementos de metadatos de la cola de metadatos del mismo modo que en el caso de los metadatos no persistentes. Sin embargo, los elementos de metadatos no se eliminan de la cola cuando se añaden al siguiente fragmento.

Llamar a putKinesisVideoFragmentMetadata o putFragmentMetadata con persistent establecido como true provoca el siguiente comportamiento:

  • Al llamar a, se API coloca el elemento de metadatos en la cola. Los metadatos se añaden como una MKV etiqueta a cada fragmento mientras el elemento está en la cola.

  • Al llamar al elemento API con el mismo nombre y un valor diferente al de un elemento de metadatos agregado anteriormente, se sobrescribe el elemento.

  • Si se llama API con un valor vacío, se elimina (cancela) el elemento de metadatos de la cola de metadatos.