Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Executar testes de reprodução de mídia do CTS Verifier

Esta página aborda as instruções para executar os testes de reprodução de mídia no CTS Verifier (CTS-V), incluído no Android 17.

O conjunto de testes de reprodução de mídia localizado no conector de teste CTS-V em cts/apps/SecurePlaybackTestApp verifica se a reprodução segura mostra frames na tela do dispositivo sem quedas.

O conjunto de testes de reprodução de mídia testa as seguintes APIs:

O pacote de testes de reprodução de mídia verifica os seguintes codecs: AVC, HEVC, VP9 e AV1.

Configurar o ambiente de teste

Para executar testes de reprodução segura, configure o seguinte:

Um dispositivo em teste (DUT)
Uma máquina host
Ferramenta de análise de reprodução (PAT) para dispositivos móveis. É possível comprar um PAT na Tempo Manufacturing (em inglês).

Configurar o DUT

Para configurar um DUT, siga estas etapas:

Conecte o DUT a uma máquina host por USB.
Conceda permissões para que o host acesse o DUT via ADB.
Instale o app CTS-V (CtsVerifier.apk) no dispositivo. Para mais informações, consulte Executar testes do CTS-V.
Conecte o DUT à Internet.
Conecte o PAT ao host.
1. Com o DUT na vertical, coloque o lado acolchoado do PAT sobre a tela com a seta branca do PAT apontando para cima.
2. Enrole as duas faixas ao redor do DUT e puxe o cordão com uma extremidade branca para apertar.

Configurar o host

Para configurar o ambiente de teste, faça o download dos arquivos de configuração do PAT e extraia o conteúdo para um novo diretório pat-cts:

cd pat-cts/v2.4.0
./setup.sh

Esse comando configura a interface de linha de comando do PAT e entra em um ambiente virtual com o Python instalado. Se ele não entrar automaticamente no ambiente, execute:

source venv/bin/activate

Recomendamos atualizar o PAT para corresponder à versão do firmware incluída nos arquivos de configuração. Para verificar a versão do firmware, execute:

(venv) patctl --usb --info | grep "Firmware version"

Se a versão do firmware for anterior a 2.4.0, atualize-o. Execute:

(venv) patctl --usb --update pat_fw_v2.4.0rc2.bin

Para testes do CTS, instale a estrutura de teste do Mobly e snippet-uiautomator no ambiente virtual:

(venv) pip install mobly
(venv) pip install snippet-uiautomator

Antes de executar os testes, também é necessário definir uma variável de ambiente que identifique o local dos recursos de teste enquanto o ambiente virtual estiver ativo. Para fazer isso, execute:

(venv) cd SecurePlaybackTestApp
(venv) source build/envsetup.sh

Para reentrar no ambiente, execute:

source pat-cts/v2.4.0/venv/bin/activate

Crie os arquivos de configuração.

Usando o framework Mobly, crie um arquivo de configuração config.yml para definir o ambiente de teste do Mobly.

Confira abaixo um exemplo de arquivo config.yml. Um modelo é fornecido no diretório SecurePlaybackTestApp/.

TestBeds:
  # A testbed where adb will find Android devices.
  - Name: PlaybackAnalysisTestBed
    Controllers:
        AndroidDevice:
        - serial: 8A9X0NS5Z  # quotes are needed if serial id is entirely numeric
          label: dut
    TestParams:
        video_scaling: 1.0  # from 0.0 to 1.0, used if the test video is too large to fit the Playback Analysis Tool

Executar testes

Para executar os testes de reprodução de mídia do CTS-V:

No ambiente virtual do Python na máquina host, navegue até o diretório SecurePlaybackTestApp/.
Execute o teste:
```
python ./secure_playback_test.py -c config.yml
```
Após cerca de 10 segundos, um vídeo começa a ser reproduzido no dispositivo.
Alinhe os sulcos no PAT com as cinco barras pretas e brancas do vídeo, conforme mostrado no diagrama a seguir. Verifique se o PAT está alinhado com a seta apontando para a esquerda em relação à orientação do vídeo.

Figura 1. PAT alinhado corretamente.

Observação: se as barras do vídeo forem muito largas para caber nos encaixes, como no diagrama a seguir, o script vai pedir que você insira um número de 0,0 a 1,0 para reduzir o tamanho do vídeo até que os encaixes se ajustem à largura da barra. Também é possível definir esse valor video_scaling em config.yml, como mostrado em Criar arquivos de configuração.

Figura 2. O PAT precisa de escalonamento.
Depois de alinhar o PAT, enrole os dois cabos ao redor do dispositivo e aperte-os com a aba de puxar saindo do lado esquerdo do PAT. Verifique se o alinhamento não mudou e realinhe se necessário. Para isso, desconecte o DUT do host, mas verifique se ele está reconectado antes de continuar. Confira se o PAT está totalmente plano contra o DUT, conforme mostrado na Figura 4. Coloque o dispositivo em um local onde ele não será tocado por alguns minutos e insira y para continuar o teste. Verifique se o dispositivo não se move após o alinhamento.

Figura 3. PAT e DUT, vista de cima.

Figura 4. PAT e DUT, visualização lateral.

Observação :a luz no PAT deve ficar verde em até cinco segundos. Se ele continuar vermelho, verifique o alinhamento de novo e reinicie o teste. Verifique se a seta está apontando na direção correta, como mostrado na Figura 1.

Quando o teste é aprovado, o botão Aprovar é ativado. Toque neste botão para gravar um teste aprovado.