As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Extraia imagens de streams de vídeo

Você pode usar o Amazon Kinesis APIs Video SDKs Streams para ajudá-lo a extrair imagens dos seus streams de vídeo. Você pode usar essas imagens para aplicativos de reprodução aprimorados, como miniaturas ou depuração aprimorada, ou para uso em pipelines de aprendizado de máquina. O Kinesis Video Streams oferece extração de imagens sob demanda por meio de uma API ou extração automática de imagens de tags de metadados em um vídeo ingerido.

Para obter informações sobre como usar o suporte gerenciado do Kinesis Video Streams para imagens, consulte:

Geração automatizada de imagens (entrega do Amazon S3)

Atualmente, os clientes executam e gerenciam seu próprio pipeline de transcodificação de imagens para criar imagens para várias finalidades, como depuração, visualização de imagens, execução de modelos de ML em imagens e muito mais. O Kinesis Video Streams oferece a capacidade de transcodificar e entregar as imagens. O Kinesis Video Streams extrairá automaticamente imagens dos dados de vídeo em tempo real com base em uma tag e entregará as imagens a um bucket S3 especificado pelo cliente.

UpdateImageGenerationConfiguration

{
 "StreamName": "TestStream",
 "ImageGenerationConfiguration":
 {
  "Status": "ENABLED",
  "DestinationConfig":
  {
   "DestinationRegion": "us-east-1",
   "Uri": "s3://bucket-name"
  },
  "SamplingInterval": 200,
  "ImageSelectorType": "PRODUCER_TIMESTAMP",
  "Format": "JPEG",
  "FormatConfig": {
                "JPEGQuality": "80"
       },
  "WidthPixels": 320,
  "HeightPixels": 240
 }
}

Você pode usar o AWS CLI para invocar a operação de UpdateImageGenerationConfigurationAPI para adicionar o ARN do Amazon S3 criado anteriormente e alterar o status para. ENABLED

aws kinesisvideo update-image-generation-configuration \
--cli-input-json file://./update-image-generation-input.json \

Solicitação:

UpdateImageGenerationConfiguration HTTP/1.1
                 
  Method: 'POST'
  Path: '/updateImageGenerationConfiguration' 
  Body: {
    StreamName: 'String', // Optional. Either stream name or arn should be passed
    StreamArn: 'String', // Optional. Either stream name or arn should be passed
    ImageGenerationConfiguration : {
        // required
        Status: 'Enum', // ENABLED | DISABLED,
       ImageSelectorType: 'Enum', // SERVER_TIMESTAMP | PRODUCER_TIMESTAMP..      
        DestinationConfig: {
            DestinationRegion: 'String', 
            Uri: string,
        },
        SamplingInterval: 'Number'//
        Format: 'Enum', // JPEG | PNG
        // Optional parameters
        FormatConfig: {
                'String': 'String',
       },
        WidthPixels: 'Number', // 1 - 3840 (4k).   
        HeightPixels: 'Number' // 1 - 2160 (4k).  
    }
  }
  

Resposta:

  HTTP/1.1 200 
  Content-type: application/json
  Body: {
  }  
            

DescribeImageGenerationConfiguration

Para visualizar as configurações de geração de imagens que já estão definidas para um stream, os clientes podem fazer uma DescribeImageGenerationConfiguration solicitação da seguinte maneira.

Solicitação:

 DescribeImageGenerationConfiguration HTTP/1.1

 
  Method: 'POST'
  Path: '/describeImageGenerationConfiguration' 
  Body: {
    StreamName: 'String', // Optional. Either stream name or arn should be passed
    StreamArn: 'String', // Optional. Either stream name or arn should be passed
  }
        

Resposta:

HTTP/1.1 200 
  Content-type: application/json
  Body: {
    ImageGenerationConfiguration : {
        Status: 'Enum',
        ImageSelectorType: 'Enum', // SERVER_TIMESTAMP | PRODUCER_TIMESTAMP
        DestinationConfig: {
            DestinationRegion: 'String'
            Uri: 'string',
        },
        SamplingInterval: 'Number',
        Format: 'Enum', 
        FormatConfig: {
                'String': 'String',
        },
        WidthPixels: 'Number',
        HeightPixels: 'Number'
    }
  } 

Para saber mais sobre o DescribeImageGenerationConfiguration recurso, consulte DescribeImageGenerationConfiguration o Guia do desenvolvedor do Amazon Kinesis Video Streams.

Etiquetas MKV do produtor

Você pode usar o SDK produtor do Kinesis Video Streams para marcar fragmentos específicos de interesse expondo uma operação de API no SDK. Para ver um exemplo de tag, consulte esse código. Ao chamar essa API, o SDK adicionará um conjunto de tags MKV predefinidas junto com os dados do fragmento. O Kinesis Video Streams reconhecerá essas tags MKV especiais e iniciará o fluxo de trabalho de geração de imagens com base na configuração de processamento de imagem desse stream.

Todos os metadados de fragmentos fornecidos junto com as tags de geração de imagem do Amazon S3 serão salvos como metadados do Amazon S3.

Sintaxe para tags MKV do produtor

|+ 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 m

| // 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
           

Adicione tags de metadados no SDK do produtor usando PutEventMetaData

A PutEventMetaData função anexa um arquivo MKV associado a um evento. PutEventMetaDatausa dois parâmetros. O primeiro parâmetro é um evento cujo valor vem da STREAM_EVENT_TYPE enumeração. O segundo parâmetro, pStreamEventMetadata, é opcional e pode ser usado para incluir metadados adicionais como pares de valores-chave. Há um limite de cinco pares de metadados de valores-chave que podem ser adicionados.

Limites

A tabela a seguir lista as limitações associadas às tags de metadados. Se o limite da tag de metadados for ajustável, você poderá solicitar um aumento por meio do seu gerente de conta.

Metadados do objeto S3

Por padrão, o Kinesis Video Streams definirá o número do fragmento, o produtor e a data e hora do servidor da imagem gerada como metadados do objeto Amazon S3. Se algum dado de fragmento adicional for especificado nas tags MKV, essas tags também serão adicionadas aos metadados do objeto Amazon S3. O exemplo a seguir mostra a sintaxe correta para os metadados do objeto Amazon S3.

 {
  // KVS S3 object metadata
  x-amz-meta-aws_kinesisvideo_fragment_number : 'string', 
  x-amz-meta-aws_kinesisvideo_producer_timestamp: 'number',
  x-amz-meta-aws_kinesisvideo_server_timestamp: 'number',
  
  // Optional key value pair sent as part of the MKV tags
  custom_key_1: custom_value_1,
  custom_key_2: custom_value_2,
}
                

Caminho do objeto Amazon S3 (imagem)

A lista a seguir mostra o formato correto do caminho do objeto e descreve cada elemento dentro do caminho.

Formato:

ImagePrefix_AccountID_StreamName_ImageTimecode_RandomID.file-extension

1. ImagePrefix - Valor deAWS_KINESISVIDEO_IMAGE_PREFIX.

2.AccountID - ID da conta sob a qual o stream é criado.

3. StreamName - Nome do fluxo para o qual a imagem é gerada.

4. ImageTimecode - Timecode de época no fragmento no qual a imagem é gerada.

5. RandomID - GUID aleatório.

6. file-extension - JPG ou PNG com base no formato de imagem solicitado.

Recomendações de URI do Amazon S3 para proteção contra limitação

Se você gravar milhares de imagens no Amazon S3, há o risco de limitação. Para obter mais informações, consulte S3 Prefix Put Request Limits.

Um prefixo do Amazon S3 começa com um limite PUT de 3.500 solicitações PUT por segundo e aumentará gradualmente com o tempo para prefixos exclusivos. Evite usar datas e horários como prefixos do Amazon S3. Os dados codificados por tempo afetarão um prefixo por vez e também mudarão regularmente, invalidando os aumentos de prefixo anteriores. Para permitir uma escalabilidade mais rápida e consistente do Amazon S3, recomendamos adicionar um prefixo aleatório, como um código hexadecimal ou UUID ao URI de destino do Amazon S3. Por exemplo, prefixos de código hexadecimal naturalmente dividirão suas solicitações aleatoriamente entre 16 prefixos diferentes (um prefixo para cada caractere hexadecimal exclusivo), o que permitirá 56.000 solicitações PUT por segundo após a escalabilidade automática do Amazon S3.