Recuperar miniaturas de forma programática - MediaLive

Recuperar miniaturas de forma programática

Quando o recurso de miniaturas está habilitado, o MediaLive gera miniaturas para a entrada atualmente ativa em um canal em execução. Para um canal padrão, o MediaLive gera duas miniaturas. Para um canal de pipeline único, o MediaLive gera uma miniatura.

Você pode usar a AWS CLI para trabalhar com as miniaturas programaticamente. As informações a seguir pressupõem que você esteja familiarizado com os princípios básicos do uso da AWS CLI. Para obter informações sobre os fundamentos, consulte a Referência de comandos da AWS CLI.

Use o comando DescribeThumbnails. Esse comando é representado de forma diferente em interfaces diferentes:

  • Na AWS CLI, o comando é describe-thumbnails.

  • Na API, o comando é representado por um HTTP GET em describe-thumbnails/kmsKeyId.

  • Nos AWS SDKs, o comando é representado por constructos adequados para a linguagem do SDK.

Para recuperar miniaturas usando a AWS CLI.

  1. Verifique se você habilitou as miniaturas no canal e se o canal está em execução.

  2. Insira este comando:

    aws medialive describe-thumbnails --channel-id value --pipeline-id value --thumbnail-type value

    Em que:

    channel-id é necessário.

    pipeline-id é 0 ou 1. Se você quiser miniaturas para os dois pipelines, insira o comando duas vezes.

    thumbnail-type é sempre CURRENT_ACTIVE. Essa opção é obrigatória, mesmo que tenha apenas um valor.

  3. A resposta é exibida na tela. Por exemplo:

    {
    "ThumbnailDetails": [
        {
            "PipelineId": "0",
            "Thumbnails": [
                {
                    "Body"base64 string of the JPEG image",
                    "ContentType": "image/jpeg",
                    "ThumbnailType": "CURRENT_ACTIVE",
                    "TimeStamp": "2023-07-15T21:01:11"
                }
            ]
        }
    ]
}

    Se as miniaturas estiverem desabilitadas, a resposta será semelhante a:

    {
    "ThumbnailDetails": []
}