Exportar estatísticas de codificação de vídeo

No Android 13 e versões mais recentes, os clientes de apps podem solicitar que o codificador de vídeo exporte estatísticas para cada frame de vídeo codificado. Com as estatísticas coletadas no codificador de vídeo, os apps podem otimizar tarefas relacionadas a codificação de vídeo, como a codificação de várias transmissões e o pré-processamento de frames antes da codificação.

Para exportar estatísticas de codificação de vídeo, os fornecedores de SoC precisam mudar o driver do codificador de vídeo, conforme descrito em Atualizações no driver do codificador de vídeo.

Dados de estatísticas de codificação de vídeo

No Android 13, o codificador de vídeo exporta dados de estatísticas, conforme mostrado na tabela a seguir.

Os desenvolvedores podem recuperar informações de estatísticas para cada frame usando a classe de desenvolvedor MediaFormat.

Atualizações no driver do codificador de vídeo

Para oferecer suporte à exportação de estatísticas de codificação de vídeo, os fornecedores de SoC precisam mudar o driver do codificador de vídeo. As chaves a seguir foram adicionadas à base do Codec 2.0 no Android 13:

• KEY_VIDEO_QP_AVERAGE descreve o QP médio do bloco por frame.

  As seguintes regras se aplicam à implementação da chave KEY_VIDEO_QP_AVERAGE:

  • O codificador do SoC precisa arredondar a média dos QPs do bloco para o número inteiro mais próximo antes de emitir para o Codec 2.0.

  • O valor médio é calculado apenas com base em um plano de luminância.

  • O codificador de SoC precisa retornar INT_MAX se todos os blocos no frame atual estiverem no modo ignorado. Essa condição ocorre quando nenhum coeficiente é codificado e nenhuma informação significativa de QP é codificada no frame.

• KEY_PICTURE_TYPE descreve o tipo de imagem do frame codificado como PICTURE_TYPE_I, PICTURE_TYPE_P, PICTURE_TYPE_B, ou PICTURE_TYPE_UNKNOWN.

• KEY_VIDEO_ENCODING_STATISTICS_LEVEL descreve o nível de informações de estatísticas de codificação emitidas pelo codificador de vídeo, da seguinte forma:

  • Quando o codificador não gera informações sobre estatísticas de codificação, essa chave é definida como VIDEO_ENCODING_STATISTICS_LEVEL_NONE.

  • Quando o codificador gera KEY_VIDEO_QP_AVERAGE e KEY_PICTURE_TYPE para cada frame, essa chave é definida como VIDEO_ENCODING_STATISTICS_LEVEL_1.

Consulte VideoEncodingStatisticsTest para uma implementação de referência.

Validação

Execute o teste CTS VideoEncodingStatisticsTest para validar se a parte QP média das estatísticas de codificação de vídeo funciona corretamente. O CTS executa duas codificações do mesmo vídeo de entrada, uma com uma taxa de bits mais alta e outra com uma taxa de bits mais baixa. Em seguida, o CTS compara os dois valores médios de QP exportados das duas codificações. Se o QP médio da codificação com a taxa de bits mais baixa for maior do que o QP médio da codificação com a taxa de bits mais alta, o CTS será aprovado.

Para validar a desativação do recurso de exportação de estatísticas de codificação de vídeo quando ele está ativado, use a chave VIDEO_ENCODING_STATISTICS_LEVEL_NONE da seguinte maneira:

format.setInteger(MediaFormat.KEY_VIDEO_ENCODING_STATISTICS_LEVEL, MediaFormat.VIDEO_ENCODING_STATISTICS_LEVEL_NONE);