cmds/media/src/com/android/commands/media/VolumeCtrl.java

/*
**
** Copyright 2016, 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.commands.media;

import android.content.Context;
import android.media.AudioManager;
import android.media.AudioSystem;
import android.media.IAudioService;
import android.os.ServiceManager;
import android.util.AndroidException;

import com.android.internal.os.BaseCommand;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintStream;
import java.lang.ArrayIndexOutOfBoundsException;

/**
 * Command line tool to exercise AudioService.setStreamVolume()
 *                           and AudioService.adjustStreamVolume()
 */
public class VolumeCtrl {

    private final static String TAG = "VolumeCtrl";

    // --stream affects --set, --adj or --get options.
    // --show affects --set and --adj options.
    // --get can be used with --set, --adj or by itself.
    public final static String USAGE = new String(
            "the options are as follows: \n" +
            "\t\t--stream STREAM selects the stream to control, see AudioManager.STREAM_*\n" +
            "\t\t                controls AudioManager.STREAM_MUSIC if no stream is specified\n"+
            "\t\t--set INDEX     sets the volume index value\n" +
            "\t\t--adj DIRECTION adjusts the volume, use raise|same|lower for the direction\n" +
            "\t\t--get           outputs the current volume\n" +
            "\t\t--show          shows the UI during the volume change\n" +
            "\texamples:\n" +
            "\t\tadb shell media volume --show --stream 3 --set 11\n" +
            "\t\tadb shell media volume --stream 0 --adj lower\n" +
            "\t\tadb shell media volume --stream 3 --get\n"
            );

    private final static int VOLUME_CONTROL_MODE_SET = 1;
    private final static int VOLUME_CONTROL_MODE_ADJUST = 2;

    private final static String ADJUST_LOWER = "lower";
    private final static String ADJUST_SAME = "same";
    private final static String ADJUST_RAISE = "raise";

    public static void run(BaseCommand cmd) throws Exception {
        //----------------------------------------
        // Default parameters
        int stream = AudioManager.STREAM_MUSIC;
        int volIndex = 5;
        int mode = 0;
        int adjDir = AudioManager.ADJUST_RAISE;
        boolean showUi = false;
        boolean doGet = false;

        //----------------------------------------
        // read options
        String option;
        String adjustment = null;
        while ((option = cmd.nextOption()) != null) {
            switch (option) {
                case "--show":
                    showUi = true;
                    break;
                case "--get":
                    doGet = true;
                    log(LOG_V, "will get volume");
                    break;
                case "--stream":
                    stream = Integer.decode(cmd.nextArgRequired()).intValue();
                    log(LOG_V, "will control stream=" + stream + " (" + streamName(stream) + ")");
                    break;
                case "--set":
                    volIndex = Integer.decode(cmd.nextArgRequired()).intValue();
                    mode = VOLUME_CONTROL_MODE_SET;
                    log(LOG_V, "will set volume to index=" + volIndex);
                    break;
                case "--adj":
                    mode = VOLUME_CONTROL_MODE_ADJUST;
                    adjustment = cmd.nextArgRequired();
                    log(LOG_V, "will adjust volume");
                    break;
                default:
                    throw new IllegalArgumentException("Unknown argument " + option);
            }
        }

        //------------------------------
        // Read options: validation
        if (mode == VOLUME_CONTROL_MODE_ADJUST) {
            if (adjustment == null) {
                cmd.showError("Error: no valid volume adjustment (null)");
                return;
            }
            switch (adjustment) {
                case ADJUST_RAISE: adjDir = AudioManager.ADJUST_RAISE; break;
                case ADJUST_SAME: adjDir = AudioManager.ADJUST_SAME; break;
                case ADJUST_LOWER: adjDir = AudioManager.ADJUST_LOWER; break;
                default:
                    cmd.showError("Error: no valid volume adjustment, was " + adjustment
                            + ", expected " + ADJUST_LOWER + "|" + ADJUST_SAME + "|"
                            + ADJUST_RAISE);
                    return;
            }
        }

        //----------------------------------------
        // Test initialization
        log(LOG_V, "Connecting to AudioService");
        IAudioService audioService = IAudioService.Stub.asInterface(ServiceManager.checkService(
                Context.AUDIO_SERVICE));
        if (audioService == null) {
            System.err.println(BaseCommand.NO_SYSTEM_ERROR_CODE);
            throw new AndroidException(
                    "Can't connect to audio service; is the system running?");
        }

        if (mode == VOLUME_CONTROL_MODE_SET) {
            if ((volIndex > audioService.getStreamMaxVolume(stream))
                    || (volIndex < audioService.getStreamMinVolume(stream))) {
                cmd.showError(String.format("Error: invalid volume index %d for stream %d "
                        + "(should be in [%d..%d])", volIndex, stream,
                        audioService.getStreamMinVolume(stream),
                        audioService.getStreamMaxVolume(stream)));
                return;
            }
        }

        //----------------------------------------
        // Non-interactive test
        final int flag = showUi? AudioManager.FLAG_SHOW_UI : 0;
        final String pack = cmd.getClass().getPackage().getName();
        if (mode == VOLUME_CONTROL_MODE_SET) {
            audioService.setStreamVolume(stream, volIndex, flag, pack/*callingPackage*/);
        } else if (mode == VOLUME_CONTROL_MODE_ADJUST) {
            audioService.adjustStreamVolume(stream, adjDir, flag, pack);
        }
        if (doGet) {
            log(LOG_V, "volume is " + audioService.getStreamVolume(stream) +
                       " in range [" + audioService.getStreamMinVolume(stream) +
                       ".." + audioService.getStreamMaxVolume(stream) + "]");
        }
    }

    //--------------------------------------------
    // Utilities

    static final String LOG_V = "[v]";
    static final String LOG_W = "[w]";
    static final String LOG_OK = "[ok]";

    static void log(String code, String msg) {
        System.out.println(code + " " + msg);
    }

    static String streamName(int stream) {
        try {
            return AudioSystem.STREAM_NAMES[stream];
        } catch (ArrayIndexOutOfBoundsException e) {
            return "invalid stream";
        }
    }

}