AudioParameter.h revision db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903
1db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin/* 2db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * Copyright (C) 2008-2011 The Android Open Source Project 3db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * 4db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * Licensed under the Apache License, Version 2.0 (the "License"); 5db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * you may not use this file except in compliance with the License. 6db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * You may obtain a copy of the License at 7db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * 8db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * http://www.apache.org/licenses/LICENSE-2.0 9db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * 10db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * Unless required by applicable law or agreed to in writing, software 11db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * distributed under the License is distributed on an "AS IS" BASIS, 12db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * See the License for the specific language governing permissions and 14db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin * limitations under the License. 15db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin */ 16db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 17db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin#ifndef ANDROID_AUDIOPARAMETER_H_ 18db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin#define ANDROID_AUDIOPARAMETER_H_ 19db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 20db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin#include <utils/Errors.h> 21db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin#include <utils/KeyedVector.h> 22db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin#include <utils/String8.h> 23db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 24db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavinnamespace android { 25db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 26db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavinclass AudioParameter { 27db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 28db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavinpublic: 29db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin AudioParameter() {} 30db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin AudioParameter(const String8& keyValuePairs); 31db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin virtual ~AudioParameter(); 32db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 33db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // reserved parameter keys for changing standard parameters with setParameters() function. 34db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // Using these keys is mandatory for AudioFlinger to properly monitor audio output/input 35db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // configuration changes and act accordingly. 36db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // keyRouting: to change audio routing, value is an int in AudioSystem::audio_devices 37db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // keySamplingRate: to change sampling rate routing, value is an int 38db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // keyFormat: to change audio format, value is an int in AudioSystem::audio_format 39db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // keyChannels: to change audio channel configuration, value is an int in AudioSystem::audio_channels 40db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // keyFrameCount: to change audio output frame count, value is an int 41db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // keyInputSource: to change audio input source, value is an int in audio_source 42db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin // (defined in media/mediarecorder.h) 43db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin static const char *keyRouting; 44db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin static const char *keySamplingRate; 45db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin static const char *keyFormat; 46db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin static const char *keyChannels; 47db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin static const char *keyFrameCount; 48db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin static const char *keyInputSource; 49db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 50db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin String8 toString(); 51db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 52db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t add(const String8& key, const String8& value); 53db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t addInt(const String8& key, const int value); 54db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t addFloat(const String8& key, const float value); 55db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 56db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t remove(const String8& key); 57db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 58db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t get(const String8& key, String8& value); 59db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t getInt(const String8& key, int& value); 60db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t getFloat(const String8& key, float& value); 61db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin status_t getAt(size_t index, String8& key, String8& value); 62db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 63db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin size_t size() { return mParameters.size(); } 64db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 65db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavinprivate: 66db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin String8 mKeyValuePairs; 67db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin KeyedVector <String8, String8> mParameters; 68db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin}; 69db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 70db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin}; // namespace android 71db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin 72db5cb14318bb24cd6ea14ff7ceea0d5e1f83d903Dima Zavin#endif /*ANDROID_AUDIOPARAMETER_H_*/ 73