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 do 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 extrair informações de estatísticas de cada frame usando a classe MediaFormat.

Atualizações do 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 de bloco médio por frame.

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

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

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

  • O codificador do 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 QP significativa é 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, conforme abaixo:

  • Quando o codificador não gera informações sobre as 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 conferir uma implementação de referência.

Validação

Execute o teste CTS VideoEncodingStatisticsTest para validar se a parte média de QP 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 um 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 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 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);