Notas da versão do pacote de testes de imagens da câmera do Android 13

A versão do Android 13 inclui várias mudanças no ITS da câmera. Além de mudanças incrementais, como versões atualizadas do Python e do pacote e atualizações de hardware de teste, o Android 13 oferece suporte a testes de vídeo.

Esta página resume as mudanças do ITS da câmera para o Android 13. As mudanças se enquadram em sete categorias amplas:

Python e versões do pacote

O Android 13 oferece suporte às seguintes versões do Python, além das versões e bibliotecas do Python compatíveis com o Android 12:

Adições ao arquivo de configuração

Devido à adição do controle de iluminação para o teste test_auto_flash.py, o arquivo config.yml precisa de dois parâmetros adicionais para o controlador e o canal de iluminação. Para identificar se o dispositivo em teste (DUT) é dobrável ou não, o arquivo config.yml requer um terceiro parâmetro adicional que precisa ser adicionado às seções de fusão de sensores e baseadas em tablet.

TestBeds:
  - Name: TEST_BED_TABLET_SCENES
    # Test configuration for scenes[0:4, 6, _change]
    Controllers:
        AndroidDevice:
          - serial: 8A9X0NS5Z
            label: dut
          - serial: 5B16001229
            label: tablet

    TestParams:
      brightness: 192
      chart_distance: 22.0
      debug_mode: "False"  # "True" or "False"; quotes needed
      lighting_cntl: <controller-type>  # "arduino" or "None"; quotes needed
      lighting_ch: <controller-channel>
      camera: 0
      foldable_device: "False". # set "True" if testing foldable
      scene: <scene-name>  # if <scene-name> runs all scenes

Testar mudanças

scene1_1/test_black_white.py

O teste test_black_white tem a verificação de saturação de canal consistente com versões anteriores do Android, o que significa que o primeiro nível da API necessário para a verificação de saturação de canal é o Android 10.

scene1_2/test_yuv_plus_raw.py

O teste test_yuv_plus_raw processa sensores que não são 16:9 ou 4:3 para oferecer melhor suporte ao RAW. Se o teste não encontrar um formato comum entre o formato RAW do sensor e os formatos de captura YUV, ele vai comparar a captura RAW com a captura YUV maior, mesmo que as proporções sejam diferentes.

scene2_a/test_faces.py

O test_faces é refatorado para test_num_faces.

scene2_a/test_num_faces.py

O teste test_num_faces processa o corte do sensor e posiciona os retângulos do rosto corretamente nas capturas da câmera UW que são cortadas.

scene3/test_lens_position.py

O teste test_lens_position foi descontinuado no Android 13.

scene6/test_zoom.py

O teste test_zoom foi refatorado para facilitar o teste de sistemas de três e quatro câmeras. Se a câmera for testada corretamente em uma faixa de proporção de 10x no zoom, o teste será encerrado corretamente. Isso permite que o teste de zoom seja realizado em uma única distância do gráfico.

scene_change/test_scene_change.py

O teste test_scene_change foi descontinuado no Android 13.

Novos testes baseados em tablet

O Android 13 inclui dois novos testes baseados em tablet. Ambos os testes são obrigatórios para dispositivos lançados com o Android 13, mas são pulados para dispositivos que fazem upgrade para o Android 13.

Scene Nome do teste Primeiro nível da API Descrição
2_a test_auto_flash 33 Confirma que as cenas escuras acionam o flash automático.
2_b test_yuv_jpg_capture_sameness 33 Confirma que as capturas YUV e JPEG ainda são idênticas em termos de bits.

scene2_a/test_auto_flash.py

O Android 13 adiciona o teste test_auto_flash.

Parâmetros

  • flash: pula o teste se o flash não estiver disponível.

Método

O teste configura a solicitação de captura para flash automático e apresenta uma cena que exige um evento de flash. A iluminação no equipamento de teste e no tablet é desativada para apresentar uma cena escura para o algoritmo de exposição automática. O teste configura uma sequência de capturas de NUM_FRAMES com o flash automático ativado. Se a configuração AE_STATE retornar FLASH_REQUIRED, o teste vai verificar se um flash é acionado nas capturas.

A iluminação pode ser controlada manualmente quando solicitado ou automaticamente com um controlador Arduino com controle de iluminação adicionado para testes automatizados. Uma nova pasta de utilitários lighting_control_utils centraliza o código para controlar a iluminação nos testes.

scene2_a/test_yuv_jpeg_capture_sameness.py

O Android 13 adiciona o teste test_yuv_jpeg_capture_sameness.

Parâmetros

  • streamUseCase: determina se a câmera oferece suporte ao caso de uso de streaming.
  • android.jpeg.quality: define a qualidade JPEG como 100.

Método

Esse teste captura duas imagens usando os formatos YUV e JPEG mais comuns com a mesma proporção do formato JPEG mais amplo, sem exceder uma resolução de 1920x1440. O teste define jpeg.quality como 100 e captura uma solicitação de superfície dupla. Em seguida, ele converte as duas imagens em matrizes RGB e calcula a raiz quadrada média (RMS) 3D entre as duas imagens. A tolerância de diferença é definida como 1%.

Testes de vídeo

O ITS da câmera adiciona suporte a testes de vídeo no Android 13.

O Android 13 adiciona os seguintes testes:

Scene Nome do teste Primeiro nível da API Descrição
4 test_preview_stabilization_fov 33 Confirma que a visualização do vídeo não é cortada demais com a estabilização ativada.
4 test_video_aspect_ratio_and_crop 33 Confirma o FoV, a proporção e o corte dos formatos de vídeo.
sensor_fusion test_preview_stabilition 33 Confirma que a estabilização da visualização funciona.
sensor_fusion test_video_stabilition 33 Confirma que a estabilização de vídeo funciona.

scene4/test_preview_stabilization_fov.py

O Android 13 adiciona o teste test_preview_stabilization_fov. Esse teste verifica os tamanhos de visualização compatíveis para garantir que o FoV não seja recortado de forma inadequada.

Método

O teste captura dois vídeos, um com a estabilização de visualização ativada e outro desativada. Um frame representativo é selecionado em cada vídeo e analisado para garantir que as mudanças de FoV nos dois vídeos estejam dentro das especificações.

Especificamente, o teste verifica os seguintes parâmetros com e sem estabilização de visualização:

  • A circunferência do círculo permanece constante.
  • O centro do círculo permanece estável.
  • O tamanho do círculo muda em até 20%, o que significa que o FoV muda até 20%.

scene4/test_video_aspect_ratio_and_crop.py

O Android 13 adiciona o teste test_video_aspect_ratio_and_crop. Assim como o teste test_aspect_ratio_and_crop para capturas de fotos, esse teste verifica os formatos de vídeo compatíveis para garantir que os frames de vídeo não sejam esticados ou cortados de forma inadequada. Todas as qualidades de vídeo informadas pelo usuário são testadas. Além disso, se a câmera oferece suporte a vídeo HLG10, o vídeo de 10 bits é testado.

O Android 13 adiciona o método get_available_video_qualities ao its_session_utils. Para compartilhar o código comum com os testes existentes, o Android 13 também inclui duas novas funções utilitárias, image_fov_utils e video_processing_utils.

Método

O teste captura uma imagem de referência com o formato RAW ou o formato JPEG de resolução mais alta, se o RAW não for compatível. A partir da imagem de referência, o tamanho e a localização do círculo são determinados. Vídeos curtos são gravados com todas as qualidades de vídeo compatíveis. O frame de referência final é extraído de cada qualidade de vídeo. A partir do frame de referência, o campo de visão (FoV), o centro (recorte) e a proporção são calculados para cada qualidade de vídeo.

Para o cálculo do FoV, o teste compara o tamanho do círculo do frame do vídeo com o tamanho do círculo calculado a partir dos tamanhos da imagem de referência e do formato de vídeo. Para a verificação de corte, o teste compara a centralização do frame do vídeo com a centralização da imagem de referência. Para a verificação da proporção, usando a cena, que é um círculo preto grande em um fundo branco, o teste determina a proporção do círculo e verifica se o frame não está distorcido.

sensor_fusion/test_preview_stabilization.py

O Android 13 adiciona o teste test_preview_stabilization, que testa todas as qualidades de visualização com suporte até 1920x1080. O teste usa a plataforma de teste de fusão de sensores e requer o novo controlador de fusão de sensores da revisão 2 ou um upgrade de firmware de versões anteriores do controlador Arduino. Para mais detalhes sobre o novo controlador, consulte Atualizações e adições de hardware.

Método

O smartphone é movido lentamente em um ângulo de aproximadamente 15 graus com a estabilização de visualização ativada. A rotação das imagens é comparada à rotação do giroscópio.

sensor_fusion/test_video_stabilization.py

O Android 13 adiciona o teste test_video_stabilization, que testa qualidades de vídeo com suporte até 1920x1080. A qualidade de vídeo de baixa resolução QCIF é excluída. O teste usa o equipamento de teste da fusão de sensores e requer o novo controlador de fusão de sensores da revisão 2 ou um upgrade de firmware de versões anteriores do controlador Arduino. Para mais detalhes sobre o novo controlador, consulte Atualizações e adições de hardware.

Método

O equipamento de teste move o smartphone lentamente em um ângulo de aproximadamente 15 graus com a estabilização de visualização ativada. A rotação das imagens é comparada à rotação do giroscópio.

Atualizações e adições de hardware

O Android 13 inclui um upgrade para o controlador de fusão de sensores da revisão 2 baseado em Arduino. Esse upgrade inclui mudanças de hardware e firmware. A atualização permite que o controlador defina a velocidade de rotação e o controle de iluminação. O upgrade também inclui um novo escudo (mostrado na Figura 1), que oferece três canais de rotação e três canais de controle de iluminação.

Arduino shield rev2.0

Figura 1. Arduino shield rev2.0 com controle de rotação e iluminação

Além disso, para a versão 13, o firmware dos controladores atualizados precisa ser atualizado para ativar o controle de velocidade de rotação. Esse firmware pode ser baixado em:

Para mais informações sobre o novo controlador, consulte Controlador de fusão de sensores do Android 13.

Suporte a testes dobráveis

O Android 13 inclui suporte a testes para dispositivos dobráveis. Para ativar a API de várias câmeras em dispositivos dobráveis, o estado do smartphone (Folded ou Unfolded) é necessário durante o teste. Para ativar a pesquisa do estado do smartphone para todos os DUTs, incluindo smartphones não dobráveis, execute o comando adb abaixo depois que o DUT for conectado ao host.

adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier