A partir de 27 de março de 2025, recomendamos usar android-latest-release
em vez de aosp-main
para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Notas da versão do pacote de testes de imagens da câmera do Android 14
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A versão do Android 14 inclui várias mudanças no
ITS da câmera.
Esta página resume as mudanças do ITS da câmera para o Android
14. As mudanças se enquadram em cinco categorias amplas:
Python e versões do pacote
O Android 14 oferece suporte às seguintes versões do Python,
além das versões e bibliotecas do Python compatíveis com o Android
12 e 13:
Aumento dos testes de câmera LIMITED
No Android 14, os testes a seguir foram reestruturados
para permitir o teste de câmeras LIMITADAS com testes existentes.
Scene |
Nome do teste |
Descrição |
1_1 |
test_jpeg |
Refactorizado para eliminar o método manual_capture() . |
1_2 |
test_yuv_jpeg_all |
Refactorizado para eliminar o método manual_capture() . |
1_2 |
test_yuv_plus_jpeg |
Refactorizado para eliminar o método manual_capture() . |
1_2 |
test_yuv_plus_raw |
Refactorizado para o método manual_capture() .
Os testes RAW/RAW10/RAW12 foram mesclados em um único teste. |
4 |
test_multi_camera_alignment |
Refactorizado para o método manual_capture() . |
No Android 14, os seguintes testes de detecção facial
são reestruturados.
Scene |
Nome do teste |
Descrição |
2 |
test_num_faces |
Novos rostos para aumentar a diversidade. Os locais do rosto foram confirmados. |
Outras mudanças de teste
No Android 14, os testes a seguir são reestruturados para
aumentar a cobertura de teste.
Scene |
Nome do teste |
Descrição |
0 |
test_read_write |
Refactorizado para sinalizar valores de metadados de captura para sensibilidade que estão fora
de android.sensor.sensitivityRange . |
1_1 |
test_burst_sameness_manual |
Refactorizado para fazer duas rajadas de 50 frames em vez de cinco rajadas de 50
frames. |
1_2 |
test_yuv_jpeg_all |
Refactorizado para usar o caso de uso STILL_CAPTURE , se disponível. |
1_2 |
test_yuv_plus_jpeg |
Refactorizado para usar o caso de uso STILL_CAPTURE , se disponível. |
4 |
test_multi_camera_alignment |
Refactorizado para adicionar capturas YUV e capturas 640x360 às
capturas 640x480 existentes. |
Novos testes
O Android 14 inclui os novos testes abaixo.
Scene |
Nome do teste |
Descrição |
2_a |
test_autoframing |
Verifica se o enquadramento automático pode ajustar o FoV para incluir todos os rostos com
tons de pele diferentes, independentemente da proporção de zoom definida. |
2_a |
test_display_p3 |
Verifica se a saída de P3 JPEG está correta. |
2_a |
test_preview_min_frame_rate |
Verifica se a taxa de quadros da visualização atinge o mínimo definido pelas propriedades da câmera em
condições de pouca luz. |
3 |
test_landscape_to_portrait |
A substituição de paisagem para retrato verifica se a imagem é girada corretamente. |
4 |
test_preview_aspect_ratio_and_crop |
Verifica se a proporção, o corte e o campo de visão do stream Preview são
adequados para os formatos aceitos. |
6 |
test_in_sensor_zoom |
Verifica o comportamento do zoom do sensor da câmera. |
6 |
test_low_latency_zoom |
Verifica se a proporção do zoom é dimensionada corretamente quando o zoom de substituição de configurações está definido. |
6 |
test_preview_video_zoom_match |
Verifica se o zoom se comporta da mesma forma em transmissões Preview e Video . |
extensões |
test_hdr_extension |
Verifica se a extensão HDR é ativada corretamente quando solicitada. |
extensões |
test_night_extension |
Verifica se a extensão Night é ativada corretamente quando solicitada. |
sensor_fusion |
test_led_snapshot |
Verifica se os snapshots de LED não saturam ou matizam a imagem. |
Teste de DUT paralelo
O Android 14 oferece suporte a testes de DUT paralelos, o que permite
testar DUTs em paralelo com várias plataformas para acelerar o teste geral. Por
exemplo, o teste paralelo permite testar a câmera 0 em uma plataforma e a câmera 1 em
outra ao mesmo tempo.
Para mais detalhes, consulte
Testes de DUT paralelos.
Requisitos de teste
A Figura 1 mostra o anel de
decodificador secreto do ITS do Android 14. O anel de decodificação secreto mostra quais configurações de teste são
bloqueadas por testes individuais. As configurações de teste bloqueadas por
android.request.availableCapabilities
são em letras maiúsculas.
Os principais itens de restrição são:
MANUAL_SENSOR
READ_3A
PER_FRAME_CONTROL
RAW
faceDetectModes
timestampSource
flash.info.available
Figura 1. Anel de decodificação secreto do ITS do Android 14
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Android 14 Camera Image Test Suite Release Notes\n\nThe Android 14 release includes a number of changes to\n[Camera ITS](/docs/compatibility/cts/camera-hal#its_tests).\n\nThis page summarizes the Camera ITS changes for Android\n14. The changes fall into five broad categories:\n\n- [Python and package versions](#package-versions)\n- [Increased LIMITED camera testing](#increased-limited-camera-testing)\n- [Increased face-related testing](#increased-face-related-testing)\n- [Other test changes](#other-test-changes)\n- [New tests](#new-tests)\n- [Parallel DUT testing](#parallel-dut-testing)\n\nPython and package versions\n---------------------------\n\nAndroid 14 supports the following Python versions in\naddition to the Python versions and libraries supported in Android\n12 and 13:\n\n- [Python 3.9.2](https://www.python.org/downloads/)\n- [OpenCV 4.2.0](https://opencv.org/)\n- [Numpy 1.20.3](https://numpy.org/)\n- [Matplotlib 3.4.1](https://matplotlib.org/)\n- [Scipy 1.6.2](https://docs.scipy.org/doc/)\n- [pySerial 3.5](https://pyserial.readthedocs.io/)\n- [Pillow 8.3.1](https://pypi.org/project/Pillow/)\n- [PyYAML 5.4.1](https://pypi.org/project/PyYAML/)\n- [Mobly 1.11](https://github.com/google/mobly)\n- [FFmpeg 4.4.1](https://ffmpeg.org/)\n- (For Display P3 tests only) [Colour-science 0.4.2](https://pypi.org/project/colour-science/)\n\nIncreased LIMITED camera testing\n--------------------------------\n\nIn Android 14, the following tests are refactored\nto enable testing of LIMITED cameras with existing tests.\n\n| **Scene** | **Test name** | **Description** |\n|-----------|-----------------------------|-----------------------------------------------------------------------------------------------|\n| 1_1 | test_jpeg | Refactored to eliminate the `manual_capture()` method. |\n| 1_2 | test_yuv_jpeg_all | Refactored to eliminate the `manual_capture()` method. |\n| 1_2 | test_yuv_plus_jpeg | Refactored to eliminate the `manual_capture()` method. |\n| 1_2 | test_yuv_plus_raw | Refactored to the `manual_capture()` method. RAW/RAW10/RAW12 testing merged to a single test. |\n| 4 | test_multi_camera_alignment | Refactored to the `manual_capture()` method. |\n\nIncreased face-related testing\n------------------------------\n\nIn Android 14, the following face detection\ntests are refactored.\n\n| **Scene** | **Test name** | **Description** |\n|-----------|----------------|-------------------------------------------------------------------|\n| 2 | test_num_faces | New faces for increased face diversity. Face locations confirmed. |\n\n\u003cbr /\u003e\n\nOther test changes\n------------------\n\nIn Android 14, the following tests are refactored to\nincrease test coverage.\n\n| **Scene** | **Test name** | **Description** |\n|-----------|-----------------------------|--------------------------------------------------------------------------------------------------------------------|\n| 0 | test_read_write | Refactored to flag capture metadata values for sensitivity that fall outside of `android.sensor.sensitivityRange`. |\n| 1_1 | test_burst_sameness_manual | Refactored to do two bursts of 50 frames rather than five bursts of 50 frames. |\n| 1_2 | test_yuv_jpeg_all | Refactored to use the `STILL_CAPTURE` use case if available. |\n| 1_2 | test_yuv_plus_jpeg | Refactored to use the `STILL_CAPTURE` use case if available. |\n| 4 | test_multi_camera_alignment | Refactored to add YUV captures and to add `640x360` captures to the existing `640x480` captures. |\n\n\u003cbr /\u003e\n\nNew tests\n---------\n\nAndroid 14 includes the following new tests.\n\n| **Scene** | **Test name** | **Description** |\n|---------------|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|\n| 2_a | test_autoframing | Verifies that autoframing can adjust the FoV to include all faces with different skin tones regardless of the zoom ratio set. |\n| 2_a | test_display_p3 | Verifies `P3 JPEG` output is correct. |\n| 2_a | test_preview_min_frame_rate | Verifies that preview FPS reaches minimum defined by camera properties under low light conditions. |\n| 3 | test_landscape_to_portrait | Verifies landscape to portrait override rotates image properly. |\n| 4 | test_preview_aspect_ratio_and_crop | Verifies `Preview` stream aspect ratio, crop, and FoV are appropriate for supported formats. |\n| 6 | test_in_sensor_zoom | Verifies the camera in-sensor zoom behavior. |\n| 6 | test_low_latency_zoom | Verifies zoom ratio scales correctly if settings override zoom is set. |\n| 6 | test_preview_video_zoom_match | Verifies that zoom behaves the same in `Preview` and `Video` streams. |\n| extensions | test_hdr_extension | Verifies `HDR` extension activates correctly when requested. |\n| extensions | test_night_extension | Verifies `Night` extension activates correctly when requested. |\n| sensor_fusion | test_led_snapshot | Verifies LED snapshots don't saturate or tint image. |\n\nParallel DUT testing\n--------------------\n\nAndroid 14 supports parallel DUT testing, which lets\nyou test DUTs in parallel with multiple rigs to speed up overall testing. For\nexample, parallel testing lets you test camera 0 in one rig and camera 1 in\nanother rig at the same time.\n\nFor more details, see\n[Parallel DUT testing](/docs/compatibility/cts/camera-its#parallel-dut-testing).\n\nTest requirements\n-----------------\n\nFigure 1 shows the Android 14 ITS *secret\ndecoder ring* . The secret decoder ring shows what test settings individual\ntests are gated by. Test settings gated by\n`android.request.availableCapabilities` are in uppercase letters.\nThe main gating items are:\n\n- `MANUAL_SENSOR`\n- `READ_3A`\n- `PER_FRAME_CONTROL`\n- `RAW`\n- `faceDetectModes`\n- `timestampSource`\n- `flash.info.available`\n\n**Figure 1.** Android 14 ITS secret decoder ring"]]