aosp12/cts/tests/media

Media V2 CTS Tests

Current folder comprises of files necessary for testing media extractor, media muxer, media codec SDK and NDK Api. These tests aims to test all codecs advertised in MediaCodecList, available muxers and extractors.

The aim of these tests is not solely to verify the CDD requirements but also to test components, their plugins and their interactions with media framework.

The test vectors used by the test suite is available at link and is downloaded automatically while running tests. Manual installation of these can be done using copy_media.sh script in this directory.

The test suite looks to cover sdk/ndk api in normal and error scenarios. Error scenarios are separated from regular usage and are placed under class *UnitTest (MuxerUnitTest, ExtractorUnitTest, ...).

Commands

$ atest android.mediav2.cts
$ atest android.mediav2.cts.CodecEncoderTest android.mediav2.cts.CodecDecoderTest
$ atest android.mediav2.cts.MuxerTest android.mediav2.cts.MuxerUnitTest
$ atest android.mediav2.cts.ExtractorTest android.mediav2.cts.ExtractorUnitTest

Features

All tests accepts attributes that offer selective run of tests.

Select codecs by name

To select codecs by name, codec-prefix can be passed to media codec tests to select one or more codecs that start with a given prefix.

Example: To limit the tests to run for codecs whose names start with c2.android.

atest CtsMediaV2TestCases -- --module-arg CtsMediaV2TestCases:instrumentation-arg:codec-prefix:=c2.android.

Example: To limit the tests to run for c2.android.hevc.decoder

atest CtsMediaV2TestCases -- --module-arg CtsMediaV2TestCases:instrumentation-arg:codec-prefix:=c2.android.hevc.decoder

Select codecs by type

To select codecs by type, mime-sel can be passed to media codec tests to select one or more codecs.

Example: To limit media codec decoder tests to mp3 and vorbis decoder

atest android.mediav2.cts.CodecDecoderTest -- --module-arg  CtsMediaV2TestCases:instrumentation-arg:mime-sel:=mp3,vorbis

Select extractors by type

To select extractors by type, ext-sel can be passed to extractor tests to select one or more extractors.

Example: To limit extractor tests to mp4 and webm types

atest android.mediav2.cts.ExtractorTest -- --module-arg  CtsMediaV2TestCases:instrumentation-arg:ext-sel:=mp4,webm

Select muxers by type

To select muxers by type, mux-sel can be passed to muxer tests to select one or more muxers.

Example: To limit muxer tests to mp4 and webm types

atest android.mediav2.cts.MuxerTest -- --module-arg  CtsMediaV2TestCases:instrumentation-arg:mux-sel:=mp4,webm

Appendix

Identifier for codec-sel	Mime
default	all
vp8	mimetype_video_vp8
vp9	mimetype_video_vp9
av1	mimetype_video_av1
avc	mimetype_video_avc
hevc	mimetype_video_hevc
mpeg4	mimetype_video_mpeg4
h263	mimetype_video_h263
mpeg2	mimetype_video_mpeg2
vraw	mimetype_video_raw
amrnb	mimetype_audio_amr_nb
amrwb	mimetype_audio_amr_wb
mp3	mimetype_audio_mpeg
aac	mimetype_audio_aac
vorbis	mimetype_audio_vorbis
opus	mimetype_audio_opus
g711alaw	mimetype_audio_g711_alaw
g711mlaw	mimetype_audio_g711_mlaw
araw	mimetype_audio_raw
flac	mimetype_audio_flac
gsm	mimetype_audio_msgsm

Identifier for ext-sel	Extractor format
mp4	Mpeg4
webm	Matroska
3gp	Mpeg4
mkv	Matroska
ogg	Ogg

Identifier for mux-sel	Muxer Format
mp4	muxer_output_mpeg4
webm	muxer_output_webm
3gp	muxer_output_3gpp
ogg	muxer_output_ogg