Home | History | Annotate | Download | only in media
      1 /*
      2  * Copyright (C) 2009 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #ifndef ANDROID_IAUDIOPOLICYSERVICE_H
     18 #define ANDROID_IAUDIOPOLICYSERVICE_H
     19 
     20 #include <stdint.h>
     21 #include <sys/types.h>
     22 #include <unistd.h>
     23 
     24 #include <utils/RefBase.h>
     25 #include <utils/Errors.h>
     26 #include <binder/IInterface.h>
     27 #include <media/AudioSystem.h>
     28 
     29 #include <system/audio_policy.h>
     30 
     31 namespace android {
     32 
     33 // ----------------------------------------------------------------------------
     34 
     35 class IAudioPolicyService : public IInterface
     36 {
     37 public:
     38     DECLARE_META_INTERFACE(AudioPolicyService);
     39 
     40     //
     41     // IAudioPolicyService interface (see AudioPolicyInterface for method descriptions)
     42     //
     43     virtual status_t setDeviceConnectionState(audio_devices_t device,
     44                                               audio_policy_dev_state_t state,
     45                                               const char *device_address) = 0;
     46     virtual audio_policy_dev_state_t getDeviceConnectionState(audio_devices_t device,
     47                                                                   const char *device_address) = 0;
     48     virtual status_t setPhoneState(audio_mode_t state) = 0;
     49     virtual status_t setForceUse(audio_policy_force_use_t usage,
     50                                     audio_policy_forced_cfg_t config) = 0;
     51     virtual audio_policy_forced_cfg_t getForceUse(audio_policy_force_use_t usage) = 0;
     52     virtual audio_io_handle_t getOutput(audio_stream_type_t stream,
     53                                         uint32_t samplingRate = 0,
     54                                         audio_format_t format = AUDIO_FORMAT_DEFAULT,
     55                                         audio_channel_mask_t channelMask = 0,
     56                                         audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE,
     57                                         const audio_offload_info_t *offloadInfo = NULL) = 0;
     58     virtual status_t startOutput(audio_io_handle_t output,
     59                                  audio_stream_type_t stream,
     60                                  int session = 0) = 0;
     61     virtual status_t stopOutput(audio_io_handle_t output,
     62                                 audio_stream_type_t stream,
     63                                 int session = 0) = 0;
     64     virtual void releaseOutput(audio_io_handle_t output) = 0;
     65     virtual audio_io_handle_t getInput(audio_source_t inputSource,
     66                                     uint32_t samplingRate = 0,
     67                                     audio_format_t format = AUDIO_FORMAT_DEFAULT,
     68                                     audio_channel_mask_t channelMask = 0,
     69                                     int audioSession = 0) = 0;
     70     virtual status_t startInput(audio_io_handle_t input) = 0;
     71     virtual status_t stopInput(audio_io_handle_t input) = 0;
     72     virtual void releaseInput(audio_io_handle_t input) = 0;
     73     virtual status_t initStreamVolume(audio_stream_type_t stream,
     74                                       int indexMin,
     75                                       int indexMax) = 0;
     76     virtual status_t setStreamVolumeIndex(audio_stream_type_t stream,
     77                                           int index,
     78                                           audio_devices_t device) = 0;
     79     virtual status_t getStreamVolumeIndex(audio_stream_type_t stream,
     80                                           int *index,
     81                                           audio_devices_t device) = 0;
     82     virtual uint32_t getStrategyForStream(audio_stream_type_t stream) = 0;
     83     virtual audio_devices_t getDevicesForStream(audio_stream_type_t stream) = 0;
     84     virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc) = 0;
     85     virtual status_t registerEffect(const effect_descriptor_t *desc,
     86                                     audio_io_handle_t io,
     87                                     uint32_t strategy,
     88                                     int session,
     89                                     int id) = 0;
     90     virtual status_t unregisterEffect(int id) = 0;
     91     virtual status_t setEffectEnabled(int id, bool enabled) = 0;
     92     virtual bool     isStreamActive(audio_stream_type_t stream, uint32_t inPastMs = 0) const = 0;
     93     virtual bool     isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs = 0)
     94                              const = 0;
     95     virtual bool     isSourceActive(audio_source_t source) const = 0;
     96     virtual status_t queryDefaultPreProcessing(int audioSession,
     97                                               effect_descriptor_t *descriptors,
     98                                               uint32_t *count) = 0;
     99    // Check if offload is possible for given format, stream type, sample rate,
    100     // bit rate, duration, video and streaming or offload property is enabled
    101     virtual bool isOffloadSupported(const audio_offload_info_t& info) = 0;
    102 };
    103 
    104 
    105 // ----------------------------------------------------------------------------
    106 
    107 class BnAudioPolicyService : public BnInterface<IAudioPolicyService>
    108 {
    109 public:
    110     virtual status_t    onTransact( uint32_t code,
    111                                     const Parcel& data,
    112                                     Parcel* reply,
    113                                     uint32_t flags = 0);
    114 };
    115 
    116 // ----------------------------------------------------------------------------
    117 
    118 }; // namespace android
    119 
    120 #endif // ANDROID_IAUDIOPOLICYSERVICE_H
    121