Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit b33ab125 authored by Jingwei Guo's avatar Jingwei Guo
Browse files

Android template test apk for Audio Test Harness. 

AudioTestHarnessTemplateAndroidTest class defines all the APIs that will
be executed by the actual AudioTestHarnessTemplateTest class.
If you wish to add coverage for certain Android APIs, this should be the
place to append.
Meanwhile AudioTestHarnessTemplateRunner class will extract all the test
methods defined in AudioTestHarnessTemplateAndroidTest class and add
them to the test suite.

Bug: 148106105
Test: This is an instrumentation test apk itself and it runs with the
test class defined in ag/10195888

Change-Id: I09ef70d468ed7c806e24916000a53f3bbf5bc6f3
parent 6e67cfc2

media/tests/MediaFrameworkTest/AndroidManifest.xml

+5 −0
Original line number Diff line number Diff line
@@ -71,6 +71,11 @@ 
            android:label="MediaRecorder stress tests InstrumentationRunner">

    </instrumentation>



    <instrumentation android:name=".AudioTestHarnessTemplateRunner"

            android:targetPackage="com.android.mediaframeworktest"

            android:label="Audio Test Harness tests InstrumentationRunner">

    </instrumentation>



    <instrumentation android:name=".MediaFrameworkPowerTestRunner"

            android:targetPackage="com.android.mediaframeworktest"

            android:label="Media Power tests InstrumentationRunner">

media/tests/MediaFrameworkTest/src/com/android/mediaframeworktest/AudioTestHarnessTemplateRunner.java

0 → 100644
+51 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2020 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */

package com.android.mediaframeworktest;



import android.os.Bundle;

import android.test.InstrumentationTestRunner;

import android.test.InstrumentationTestSuite;



import com.android.mediaframeworktest.template.AudioTestHarnessTemplateAndroidTest;



import junit.framework.TestSuite;



/**

 * Runner class for Audio Test Harness.

 *

 * This will add all test methods defined in AudioTestHarnessTemplateAndroidTest class to the test

 * suite and execute them.

 */

public class AudioTestHarnessTemplateRunner extends InstrumentationTestRunner {



    @Override

    public TestSuite getAllTests() {

        TestSuite suite = new InstrumentationTestSuite(this);

        suite.addTestSuite(AudioTestHarnessTemplateAndroidTest.class);

        return suite;

    }



    @Override

    public ClassLoader getLoader() {

        return AudioTestHarnessTemplateRunner.class.getClassLoader();

    }



    @Override

    public void onCreate(Bundle icicle) {

        super.onCreate(icicle);

    }



}

media/tests/MediaFrameworkTest/src/com/android/mediaframeworktest/template/AudioTestHarnessTemplateAndroidTest.java

0 → 100644
+127 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2020 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */



package com.android.mediaframeworktest.template;



import android.media.AudioAttributes;

import android.media.MediaPlayer;

import android.os.Bundle;

import android.test.ActivityInstrumentationTestCase2;

import android.test.suitebuilder.annotation.LargeTest;

import android.util.Log;



import com.android.mediaframeworktest.AudioTestHarnessTemplateRunner;

import com.android.mediaframeworktest.MediaFrameworkTest;



import java.io.IOException;



/**

 * Junit / Instrumentation test case for Audio Test Harness.

 *

 * This test class is the place where Android APIs are invoked. Any public method that starts with

 * prefix test will be added to test suite and get executed.

 */

public class AudioTestHarnessTemplateAndroidTest extends

        ActivityInstrumentationTestCase2<MediaFrameworkTest> {



    private static final String TAG = "AudioTestHarnessTemplateAndroidTest";



    private static final String AUDIO_FILE_KEY = "audioFile";

    private static final String AUDIO_PLAY_DURATION_KEY = "audioPlayDuration";



    private String mAudioFile = "";

    private int mAudioPlayDuration;



    public AudioTestHarnessTemplateAndroidTest() {

        super("com.android.mediaframeworktest", MediaFrameworkTest.class);

    }



    @Override

    protected void setUp() throws Exception {

        super.setUp();

        extractArguments();

    }





    // Extracts test params from passed in arguments.

    private void extractArguments() {

        AudioTestHarnessTemplateRunner runner =

                (AudioTestHarnessTemplateRunner) getInstrumentation();

        Bundle arguments = runner.getArguments();

        mAudioFile = arguments.getString(AUDIO_FILE_KEY);

        mAudioPlayDuration = Integer.parseInt(arguments.getString(AUDIO_PLAY_DURATION_KEY));

        Log.i(TAG, String

                .format("Extracted arguments from runner. Audio file: %s, play duration: %d",

                        mAudioFile,

                        mAudioPlayDuration));

    }



    @Override

    protected void tearDown() throws Exception {

        super.tearDown();

        // Here is where you can put custom methods at tearDown method.

    }



    /**

     * Plays audio file for given amount of time.

     *

     * Instantiates a MediaPlayer and plays the passed in audioFile for audioPlayDuration

     * milliseconds. If the player fails to instantiate or any exception happened during the play,

     * the test will fail.

     */

    private static void playAudioFile(String audioFile, int audioPlayDuration) {

        Log.v(TAG, String.format("Playing audio file: %s", audioFile));

        MediaPlayer mp = new MediaPlayer();

        try {

            mp.setAudioAttributes(

                    new AudioAttributes.Builder()

                            .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)

                            .setUsage(AudioAttributes.USAGE_MEDIA)

                            .build());

            mp.setDataSource(audioFile);

            mp.prepare();

            int duration = mp.getDuration();

            if (duration <= 0) {

                Log.e(TAG, "Failed to grab duration from audio file.");

                fail("AudioFileWithNegativeDuration");

            }

            mp.start();

            // This test demonstrates how to play the audio file from device for certain amount of

            // time, and the test actually runs on host machine so the listener is not adapted here.

            Log.v(TAG,

                    String.format("Wait for audio file to play for duration: %d",

                            audioPlayDuration));

            Thread.sleep(audioPlayDuration);

        } catch (IOException | InterruptedException e) {

            Log.e(TAG, String.format("Exception happened while playing audio file: %s", audioFile),

                    e);

            fail("FailedToPlayAudioFile");

        } finally {

            if (mp != null) {

                Log.v(TAG, "Release media player.");

                mp.release();

            }

        }

    }



    // This test method will play the audioFile for audioPlayDuration milliseconds as passed in from

    // AudioTestHarnessTemplateTest class.

    @LargeTest

    public void testPlayAudioFile() throws Exception {

        playAudioFile(mAudioFile, mAudioPlayDuration);

    }



}