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

Com o Android 13, o codificador de vídeo exporta dados estatísticos, conforme mostrado na tabela abaixo.

Os desenvolvedores podem extrair informações estatísticas de cada frame usando a classe de desenvolvedor 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 na base do codec 2.0 no Android 13:

• KEY_VIDEO_QP_AVERAGE descreve o QP médio de bloco 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 somente a partir de um plano de luma.

  • O codificador SoC precisa retornar INT_MAX se todos os blocos no frame atual estão no modo ignorado. Essa condição ocorre quando nenhum coeficiente é codificado e nenhuma informação significativa do 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, conforme abaixo:

  • 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 conferir 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 maior e outra com menor taxa de bits. Em seguida, o CTS compara os dois valores médios de qualidade 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 tecla VIDEO_ENCODING_STATISTICS_LEVEL_NONE da seguinte maneira:

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