1## Media V2 CTS Tests
2Current 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.
3
4The 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.
5
6The test vectors used by the test suite is available at [link](https://storage.googleapis.com/android_media/cts/tests/media/CtsMediaV2TestCases-1.14.zip) and is downloaded automatically while running tests. Manual installation of these can be done using copy_media.sh script in this directory.
7
8The 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, ...).
9
10### Commands
11```sh
12$ atest android.mediav2.cts
13$ atest android.mediav2.cts.CodecEncoderTest android.mediav2.cts.CodecDecoderTest
14$ atest android.mediav2.cts.MuxerTest android.mediav2.cts.MuxerUnitTest
15$ atest android.mediav2.cts.ExtractorTest android.mediav2.cts.ExtractorUnitTest
16```
17
18### Features
19All tests accepts attributes that offer selective run of tests.
20
21#### Select codecs by name
22To 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.
23
24Example: To limit the tests to run for codecs whose names start with c2.android.
25
26```sh
27atest CtsMediaV2TestCases -- --module-arg CtsMediaV2TestCases:instrumentation-arg:codec-prefix:=c2.android.
28```
29
30Example: To limit the tests to run for c2.android.hevc.decoder
31
32```sh
33atest CtsMediaV2TestCases -- --module-arg CtsMediaV2TestCases:instrumentation-arg:codec-prefix:=c2.android.hevc.decoder
34```
35
36#### Select codecs by type
37To select codecs by type, *mime-sel* can be passed to media codec tests to select one or more codecs.
38
39Example: To limit media codec decoder tests to mp3 and vorbis decoder
40
41```sh
42atest android.mediav2.cts.CodecDecoderTest -- --module-arg  CtsMediaV2TestCases:instrumentation-arg:mime-sel:=mp3,vorbis
43```
44
45#### Select extractors by type
46To select extractors by type, *ext-sel* can be passed to extractor tests to select one or more extractors.
47
48Example: To limit extractor tests to mp4 and webm types
49```sh
50atest android.mediav2.cts.ExtractorTest -- --module-arg  CtsMediaV2TestCases:instrumentation-arg:ext-sel:=mp4,webm
51```
52
53#### Select muxers by type
54To select muxers by type, *mux-sel* can be passed to muxer tests to select one or more muxers.
55
56Example: To limit muxer tests to mp4 and webm types
57```sh
58atest android.mediav2.cts.MuxerTest -- --module-arg  CtsMediaV2TestCases:instrumentation-arg:mux-sel:=mp4,webm
59```
60
61### Appendix
62| Identifier for codec-sel | Mime |
63| ------ | ------ |
64|default|all|
65|vp8|mimetype_video_vp8|
66|vp9|mimetype_video_vp9|
67|av1|mimetype_video_av1|
68|avc|mimetype_video_avc|
69|hevc|mimetype_video_hevc|
70|mpeg4|mimetype_video_mpeg4|
71|h263|mimetype_video_h263|
72|mpeg2|mimetype_video_mpeg2|
73|vraw|mimetype_video_raw|
74|amrnb|mimetype_audio_amr_nb|
75|amrwb|mimetype_audio_amr_wb|
76|mp3|mimetype_audio_mpeg|
77|aac|mimetype_audio_aac|
78|vorbis|mimetype_audio_vorbis|
79|opus|mimetype_audio_opus|
80|g711alaw|mimetype_audio_g711_alaw|
81|g711mlaw|mimetype_audio_g711_mlaw|
82|araw|mimetype_audio_raw|
83|flac|mimetype_audio_flac|
84|gsm|mimetype_audio_msgsm|
85
86
87| Identifier for ext-sel | Extractor format |
88| ------ | ------ |
89|mp4|Mpeg4|
90|webm|Matroska|
91|3gp|Mpeg4|
92|mkv|Matroska|
93|ogg|Ogg|
94
95
96| Identifier for mux-sel | Muxer Format |
97| ------ | ------ |
98|mp4|muxer_output_mpeg4|
99|webm|muxer_output_webm|
100|3gp|muxer_output_3gpp|
101|ogg|muxer_output_ogg|
102