246 lines
8.8 KiB
Text
246 lines
8.8 KiB
Text
/*
|
|
* Copyright (C) 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 android.hardware.audio@2.0;
|
|
|
|
import android.hardware.audio.common@2.0;
|
|
import IStreamIn;
|
|
import IStreamOut;
|
|
|
|
interface IDevice {
|
|
typedef android.hardware.audio@2.0::Result Result;
|
|
|
|
/*
|
|
* Returns whether the audio hardware interface has been initialized.
|
|
*
|
|
* @return retval OK on success, NOT_INITIALIZED on failure.
|
|
*/
|
|
initCheck() generates (Result retval);
|
|
|
|
/*
|
|
* Sets the audio volume for all audio activities other than voice call. If
|
|
* NOT_SUPPORTED is returned, the software mixer will emulate this
|
|
* capability.
|
|
*
|
|
* @param volume 1.0f means unity, 0.0f is zero.
|
|
* @return retval operation completion status.
|
|
*/
|
|
setMasterVolume(float volume) generates (Result retval);
|
|
|
|
/*
|
|
* Get the current master volume value for the HAL, if the HAL supports
|
|
* master volume control. For example, AudioFlinger will query this value
|
|
* from the primary audio HAL when the service starts and use the value for
|
|
* setting the initial master volume across all HALs. HALs which do not
|
|
* support this method must return NOT_SUPPORTED in 'retval'.
|
|
*
|
|
* @return retval operation completion status.
|
|
* @return volume 1.0f means unity, 0.0f is zero.
|
|
*/
|
|
getMasterVolume() generates (Result retval, float volume);
|
|
|
|
/*
|
|
* Sets microphone muting state.
|
|
*
|
|
* @param mute whether microphone is muted.
|
|
* @return retval operation completion status.
|
|
*/
|
|
setMicMute(bool mute) generates (Result retval);
|
|
|
|
/*
|
|
* Gets whether microphone is muted.
|
|
*
|
|
* @return retval operation completion status.
|
|
* @return mute whether microphone is muted.
|
|
*/
|
|
getMicMute() generates (Result retval, bool mute);
|
|
|
|
/*
|
|
* Set the audio mute status for all audio activities. If the return value
|
|
* is NOT_SUPPORTED, the software mixer will emulate this capability.
|
|
*
|
|
* @param mute whether audio is muted.
|
|
* @return retval operation completion status.
|
|
*/
|
|
setMasterMute(bool mute) generates (Result retval);
|
|
|
|
/**
|
|
* Get the current master mute status for the HAL, if the HAL supports
|
|
* master mute control. AudioFlinger will query this value from the primary
|
|
* audio HAL when the service starts and use the value for setting the
|
|
* initial master mute across all HALs. HAL must indicate that the feature
|
|
* is not supported by returning NOT_SUPPORTED status.
|
|
*
|
|
* @return retval operation completion status.
|
|
* @return mute whether audio is muted.
|
|
*/
|
|
getMasterMute() generates (Result retval, bool mute);
|
|
|
|
/*
|
|
* Returns audio input buffer size according to parameters passed or
|
|
* INVALID_ARGUMENTS if one of the parameters is not supported.
|
|
*
|
|
* @param config audio configuration.
|
|
* @return retval operation completion status.
|
|
* @return bufferSize input buffer size in bytes.
|
|
*/
|
|
getInputBufferSize(AudioConfig config)
|
|
generates (Result retval, uint64_t bufferSize);
|
|
|
|
/*
|
|
* This method creates and opens the audio hardware output stream.
|
|
* If the stream can not be opened with the proposed audio config,
|
|
* HAL must provide suggested values for the audio config.
|
|
*
|
|
* @param ioHandle handle assigned by AudioFlinger.
|
|
* @param device device type and (if needed) address.
|
|
* @param config stream configuration.
|
|
* @param flags additional flags.
|
|
* @return retval operation completion status.
|
|
* @return outStream created output stream.
|
|
* @return suggestedConfig in case of invalid parameters, suggested config.
|
|
*/
|
|
openOutputStream(
|
|
AudioIoHandle ioHandle,
|
|
DeviceAddress device,
|
|
AudioConfig config,
|
|
AudioOutputFlag flags) generates (
|
|
Result retval,
|
|
IStreamOut outStream,
|
|
AudioConfig suggestedConfig);
|
|
|
|
/*
|
|
* This method creates and opens the audio hardware input stream.
|
|
* If the stream can not be opened with the proposed audio config,
|
|
* HAL must provide suggested values for the audio config.
|
|
*
|
|
* @param ioHandle handle assigned by AudioFlinger.
|
|
* @param device device type and (if needed) address.
|
|
* @param config stream configuration.
|
|
* @param flags additional flags.
|
|
* @param source source specification.
|
|
* @return retval operation completion status.
|
|
* @return inStream in case of success, created input stream.
|
|
* @return suggestedConfig in case of invalid parameters, suggested config.
|
|
*/
|
|
openInputStream(
|
|
AudioIoHandle ioHandle,
|
|
DeviceAddress device,
|
|
AudioConfig config,
|
|
AudioInputFlag flags,
|
|
AudioSource source) generates (
|
|
Result retval,
|
|
IStreamIn inStream,
|
|
AudioConfig suggestedConfig);
|
|
|
|
/*
|
|
* Returns whether HAL supports audio patches.
|
|
*
|
|
* @return supports true if audio patches are supported.
|
|
*/
|
|
supportsAudioPatches() generates (bool supports);
|
|
|
|
/*
|
|
* Creates an audio patch between several source and sink ports. The handle
|
|
* is allocated by the HAL and must be unique for this audio HAL module.
|
|
*
|
|
* @param sources patch sources.
|
|
* @param sinks patch sinks.
|
|
* @return retval operation completion status.
|
|
* @return patch created patch handle.
|
|
*/
|
|
createAudioPatch(vec<AudioPortConfig> sources, vec<AudioPortConfig> sinks)
|
|
generates (Result retval, AudioPatchHandle patch);
|
|
|
|
/*
|
|
* Release an audio patch.
|
|
*
|
|
* @param patch patch handle.
|
|
* @return retval operation completion status.
|
|
*/
|
|
releaseAudioPatch(AudioPatchHandle patch) generates (Result retval);
|
|
|
|
/*
|
|
* Returns the list of supported attributes for a given audio port.
|
|
*
|
|
* As input, 'port' contains the information (type, role, address etc...)
|
|
* needed by the HAL to identify the port.
|
|
*
|
|
* As output, 'resultPort' contains possible attributes (sampling rates,
|
|
* formats, channel masks, gain controllers...) for this port.
|
|
*
|
|
* @param port port identifier.
|
|
* @return retval operation completion status.
|
|
* @return resultPort port descriptor with all parameters filled up.
|
|
*/
|
|
getAudioPort(AudioPort port)
|
|
generates (Result retval, AudioPort resultPort);
|
|
|
|
/*
|
|
* Set audio port configuration.
|
|
*
|
|
* @param config audio port configuration.
|
|
* @return retval operation completion status.
|
|
*/
|
|
setAudioPortConfig(AudioPortConfig config) generates (Result retval);
|
|
|
|
/*
|
|
* Gets the HW synchronization source of the device. Calling this method is
|
|
* equivalent to getting AUDIO_PARAMETER_HW_AV_SYNC on the legacy HAL.
|
|
*
|
|
* @return hwAvSync HW synchronization source
|
|
*/
|
|
getHwAvSync() generates (AudioHwSync hwAvSync);
|
|
|
|
/*
|
|
* Sets whether the screen is on. Calling this method is equivalent to
|
|
* setting AUDIO_PARAMETER_KEY_SCREEN_STATE on the legacy HAL.
|
|
*
|
|
* @param turnedOn whether the screen is turned on.
|
|
* @return retval operation completion status.
|
|
*/
|
|
setScreenState(bool turnedOn) generates (Result retval);
|
|
|
|
/*
|
|
* Generic method for retrieving vendor-specific parameter values.
|
|
* The framework does not interpret the parameters, they are passed
|
|
* in an opaque manner between a vendor application and HAL.
|
|
*
|
|
* @param keys parameter keys.
|
|
* @return retval operation completion status.
|
|
* @return parameters parameter key value pairs.
|
|
*/
|
|
getParameters(vec<string> keys)
|
|
generates (Result retval, vec<ParameterValue> parameters);
|
|
|
|
/*
|
|
* Generic method for setting vendor-specific parameter values.
|
|
* The framework does not interpret the parameters, they are passed
|
|
* in an opaque manner between a vendor application and HAL.
|
|
*
|
|
* @param parameters parameter key value pairs.
|
|
* @return retval operation completion status.
|
|
*/
|
|
setParameters(vec<ParameterValue> parameters) generates (Result retval);
|
|
|
|
/*
|
|
* Dumps information about the stream into the provided file descriptor.
|
|
* This is used for the dumpsys facility.
|
|
*
|
|
* @param fd dump file descriptor.
|
|
*/
|
|
debugDump(handle fd);
|
|
};
|