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 Camera ITS. Além das mudanças incrementais, como versões atualizadas do Python e do pacote e atualizações do hardware de teste, o Android 13 oferece suporte a testes de vídeo.

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

Versões do Python e de pacotes

O Android 13 oferece suporte às seguintes versões do Python, além das versões e bibliotecas 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 extras 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 exige um terceiro parâmetro adicional que precisa ser adicionado às seções baseadas em tablet e de fusão de sensores.

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 uma verificação de saturação de canais consistente com versões anteriores do Android. Isso significa que o nível mínimo da API necessário para a verificação de saturação de canais é 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 a 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 maior captura YUV, mesmo que as proporções sejam diferentes.

scene2_a/test_faces.py

O test_faces é refatorado em test_num_faces.

scene2_a/test_num_faces.py

O teste test_num_faces processa o corte do sensor e posiciona os retângulos de 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á concluído 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 tablets

O Android 13 inclui dois novos testes baseados em tablets. Os dois testes são obrigatórios para dispositivos lançados com o Android 13, mas são ignorados 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 cenas escuras acionam o flash automático.
2_b test_yuv_jpg_capture_sameness 33 Confirma que as capturas de 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: ignora 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 é desligada para apresentar uma cena escura ao 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 é disparado nas capturas.

A iluminação pode ser controlada manualmente quando solicitada 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 transmissão.
  • android.jpeg.quality: define a qualidade JPEG como 100.

Método

Esse teste captura duas imagens usando os maiores formatos comuns YUV e JPEG com a mesma proporção que o maior formato JPEG, sem exceder uma resolução de 1920 x 1440. 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 diferença de raiz quadrada média (RMS) 3D entre elas. A tolerância de diferença é definida como 1%.

Teste de vídeo

O Camera ITS adiciona suporte para 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 prévia do vídeo não corta demais com a estabilização ativada.
4 test_video_aspect_ratio_and_crop 33 Confirma o campo de visão, a proporção e o corte dos formatos de vídeo.
sensor_fusion test_preview_stabilition 33 Confirma se a estabilização da prévia funciona.
sensor_fusion test_video_stabilition 33 Confirma se 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 campo de visão não seja cortado de maneira inadequada.

Método

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

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

  • A redondez do círculo permanece constante.
  • O centro do círculo permanece estável.
  • O tamanho do círculo muda em no máximo 20%, o que significa que o campo de visão muda em no máximo 20%.

scene4/test_video_aspect_ratio_and_crop.py

O Android 13 adiciona o teste test_video_aspect_ratio_and_crop. Semelhante ao teste de test_aspect_ratio_and_crop para capturas estáticas, este teste verifica os formatos de vídeo compatíveis para garantir que os frames não sejam esticados ou cortados de maneira inadequada. Todas as qualidades de vídeo informadas são testadas. Além disso, se a câmera for compatível com vídeo HLG10, o vídeo de 10 bits será testado.

O Android 13 adiciona o método get_available_video_qualities ao its_session_utils. Para compartilhar código comum com testes atuais, 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 maior resolução, se RAW não for compatível. Com base na imagem de referência, o tamanho e a localização do círculo são determinados. Em seguida, os vídeos curtos são gravados com todas as qualidades de vídeo disponíveis. O frame de referência final é extraído de cada qualidade de vídeo. Do frame de referência, o campo de visão (FoV), o centralização (corte) 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 de vídeo com o tamanho calculado do círculo da imagem de referência e os tamanhos de formato de vídeo. Para a verificação de corte, o teste compara o 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 prévia compatíveis até 1920x1080. O teste usa o equipamento de teste de fusão de sensores e exige 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 à do giroscópio.

sensor_fusion/test_video_stabilization.py

O Android 13 adiciona o teste test_video_stabilization, que testa qualidades de vídeo compatíveis de até 1920 x 1080. A qualidade de vídeo de baixa resolução QCIF é excluída. O teste usa o equipamento 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 equipamento de teste move o smartphone lentamente em um ângulo de aproximadamente 15 graus com a estabilização de prévia 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 do controlador de fusão de sensores da revisão 2 baseado em Arduino. Este upgrade inclui mudanças de hardware e firmware. Com o upgrade, o controlador pode definir 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.

Shield Arduino rev2.0

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

Além disso, no Android 13, o firmware dos controladores precisa ser atualizado para ativar o controle de velocidade de rotação. Este 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 para testes em 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 em todos os DUTs, incluindo smartphones não dobráveis, execute o seguinte comando adb depois que o DUT for conectado ao host.

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