media/java/android/media/IAudioService.aidl

   1 /*
   2  * Copyright (C) 2007 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 package android.media;
  18
  19 import android.bluetooth.BluetoothDevice;
  20 import android.media.AudioAttributes;
  21 import android.media.AudioFocusInfo;
  22 import android.media.AudioPlaybackConfiguration;
  23 import android.media.AudioRecordingConfiguration;
  24 import android.media.AudioRoutesInfo;
  25 import android.media.IAudioFocusDispatcher;
  26 import android.media.IAudioRoutesObserver;
  27 import android.media.IAudioServerStateDispatcher;
  28 import android.media.IPlaybackConfigDispatcher;
  29 import android.media.IRecordingConfigDispatcher;
  30 import android.media.IRingtonePlayer;
  31 import android.media.IVolumeController;
  32 import android.media.IVolumeController;
  33 import android.media.PlayerBase;
  34 import android.media.VolumePolicy;
  35 import android.media.audiopolicy.AudioPolicyConfig;
  36 import android.media.audiopolicy.IAudioPolicyCallback;
  37
  38 /**
  39  * {@hide}
  40  */
  41 interface IAudioService {
  42     // C++ and Java methods below.
  43
  44     // WARNING: When methods are inserted or deleted in this section, the transaction IDs in
  45     // frameworks/native/include/audiomanager/IAudioManager.h must be updated to match the order
  46     // in this file.
  47     //
  48     // When a method's argument list is changed, BpAudioManager's corresponding serialization code
  49     // (if any) in frameworks/native/services/audiomanager/IAudioManager.cpp must be updated.
  50
  51     int trackPlayer(in PlayerBase.PlayerIdCard pic);
  52
  53     oneway void playerAttributes(in int piid, in AudioAttributes attr);
  54
  55     oneway void playerEvent(in int piid, in int event);
  56
  57     oneway void releasePlayer(in int piid);
  58
  59     // Java-only methods below.
  60
  61     oneway void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags,
  62             String callingPackage, String caller);
  63
  64     void adjustStreamVolume(int streamType, int direction, int flags, String callingPackage);
  65
  66     void setStreamVolume(int streamType, int index, int flags, String callingPackage);
  67
  68     boolean isStreamMute(int streamType);
  69
  70     void forceRemoteSubmixFullVolume(boolean startForcing, IBinder cb);
  71
  72     boolean isMasterMute();
  73
  74     void setMasterMute(boolean mute, int flags, String callingPackage, int userId);
  75
  76     int getStreamVolume(int streamType);
  77
  78     int getStreamMinVolume(int streamType);
  79
  80     int getStreamMaxVolume(int streamType);
  81
  82     int getLastAudibleStreamVolume(int streamType);
  83
  84     void setMicrophoneMute(boolean on, String callingPackage, int userId);
  85
  86     void setRingerModeExternal(int ringerMode, String caller);
  87
  88     void setRingerModeInternal(int ringerMode, String caller);
  89
  90     int getRingerModeExternal();
  91
  92     int getRingerModeInternal();
  93
  94     boolean isValidRingerMode(int ringerMode);
  95
  96     void setVibrateSetting(int vibrateType, int vibrateSetting);
  97
  98     int getVibrateSetting(int vibrateType);
  99
 100     boolean shouldVibrate(int vibrateType);
 101
 102     void setMode(int mode, IBinder cb, String callingPackage);
 103
 104     int getMode();
 105
 106     oneway void playSoundEffect(int effectType);
 107
 108     oneway void playSoundEffectVolume(int effectType, float volume);
 109
 110     boolean loadSoundEffects();
 111
 112     oneway void unloadSoundEffects();
 113
 114     oneway void reloadAudioSettings();
 115
 116     oneway void avrcpSupportsAbsoluteVolume(String address, boolean support);
 117
 118     void setSpeakerphoneOn(boolean on);
 119
 120     boolean isSpeakerphoneOn();
 121
 122     void setBluetoothScoOn(boolean on);
 123
 124     boolean isBluetoothScoOn();
 125
 126     void setBluetoothA2dpOn(boolean on);
 127
 128     boolean isBluetoothA2dpOn();
 129
 130     int requestAudioFocus(in AudioAttributes aa, int durationHint, IBinder cb,
 131             IAudioFocusDispatcher fd, String clientId, String callingPackageName, int flags,
 132             IAudioPolicyCallback pcb, int sdk);
 133
 134     int abandonAudioFocus(IAudioFocusDispatcher fd, String clientId, in AudioAttributes aa,
 135             in String callingPackageName);
 136
 137     void unregisterAudioFocusClient(String clientId);
 138
 139     int getCurrentAudioFocus();
 140
 141     void startBluetoothSco(IBinder cb, int targetSdkVersion);
 142     void startBluetoothScoVirtualCall(IBinder cb);
 143     void stopBluetoothSco(IBinder cb);
 144
 145     void forceVolumeControlStream(int streamType, IBinder cb);
 146
 147     void setRingtonePlayer(IRingtonePlayer player);
 148     IRingtonePlayer getRingtonePlayer();
 149     int getUiSoundsStreamType();
 150
 151     void setWiredDeviceConnectionState(int type, int state, String address, String name,
 152             String caller);
 153
 154     void setHearingAidDeviceConnectionState(in BluetoothDevice device, int state);
 155
 156     int setBluetoothA2dpDeviceConnectionState(in BluetoothDevice device, int state, int profile);
 157
 158     void handleBluetoothA2dpDeviceConfigChange(in BluetoothDevice device);
 159
 160     AudioRoutesInfo startWatchingRoutes(in IAudioRoutesObserver observer);
 161
 162     boolean isCameraSoundForced();
 163
 164     void setVolumeController(in IVolumeController controller);
 165
 166     void notifyVolumeControllerVisible(in IVolumeController controller, boolean visible);
 167
 168     boolean isStreamAffectedByRingerMode(int streamType);
 169
 170     boolean isStreamAffectedByMute(int streamType);
 171
 172     void disableSafeMediaVolume(String callingPackage);
 173
 174     int setHdmiSystemAudioSupported(boolean on);
 175
 176     boolean isHdmiSystemAudioSupported();
 177
 178     String registerAudioPolicy(in AudioPolicyConfig policyConfig,
 179             in IAudioPolicyCallback pcb, boolean hasFocusListener, boolean isFocusPolicy,
 180             boolean isVolumeController);
 181
 182     oneway void unregisterAudioPolicyAsync(in IAudioPolicyCallback pcb);
 183
 184     int addMixForPolicy(in AudioPolicyConfig policyConfig, in IAudioPolicyCallback pcb);
 185
 186     int removeMixForPolicy(in AudioPolicyConfig policyConfig, in IAudioPolicyCallback pcb);
 187
 188     int setFocusPropertiesForPolicy(int duckingBehavior, in IAudioPolicyCallback pcb);
 189
 190     void setVolumePolicy(in VolumePolicy policy);
 191
 192     void registerRecordingCallback(in IRecordingConfigDispatcher rcdb);
 193
 194     oneway void unregisterRecordingCallback(in IRecordingConfigDispatcher rcdb);
 195
 196     List<AudioRecordingConfiguration> getActiveRecordingConfigurations();
 197
 198     void registerPlaybackCallback(in IPlaybackConfigDispatcher pcdb);
 199
 200     oneway void unregisterPlaybackCallback(in IPlaybackConfigDispatcher pcdb);
 201
 202     List<AudioPlaybackConfiguration> getActivePlaybackConfigurations();
 203
 204     void disableRingtoneSync(in int userId);
 205
 206     int getFocusRampTimeMs(in int focusGain, in AudioAttributes attr);
 207
 208     int dispatchFocusChange(in AudioFocusInfo afi, in int focusChange,
 209             in IAudioPolicyCallback pcb);
 210
 211     oneway void playerHasOpPlayAudio(in int piid, in boolean hasOpPlayAudio);
 212
 213     int setBluetoothA2dpDeviceConnectionStateSuppressNoisyIntent(in BluetoothDevice device,
 214             int state, int profile, boolean suppressNoisyIntent);
 215
 216     oneway void setFocusRequestResultFromExtPolicy(in AudioFocusInfo afi, int requestResult,
 217             in IAudioPolicyCallback pcb);
 218
 219     void registerAudioServerStateDispatcher(IAudioServerStateDispatcher asd);
 220
 221     oneway void unregisterAudioServerStateDispatcher(IAudioServerStateDispatcher asd);
 222
 223     boolean isAudioServerRunning();
 224
 225     // WARNING: read warning at top of file, new methods that need to be used by native
 226     // code via IAudioManager.h need to be added to the top section.
 227 }