Home | History | Annotate | Download | only in SLES
      1 /*
      2  * Copyright (C) 2010 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 OPENSL_ES_ANDROIDCONFIGURATION_H_
     18 #define OPENSL_ES_ANDROIDCONFIGURATION_H_
     19 
     20 #ifdef __cplusplus
     21 extern "C" {
     22 #endif
     23 
     24 /*---------------------------------------------------------------------------*/
     25 /* Android AudioRecorder configuration                                       */
     26 /*---------------------------------------------------------------------------*/
     27 
     28 /** Audio recording preset */
     29 /** Audio recording preset key */
     30 #define SL_ANDROID_KEY_RECORDING_PRESET ((const SLchar*) "androidRecordingPreset")
     31 /** Audio recording preset values */
     32 /**   preset "none" cannot be set, it is used to indicate the current settings
     33  *     do not match any of the presets. */
     34 #define SL_ANDROID_RECORDING_PRESET_NONE                ((SLuint32) 0x00000000)
     35 /**   generic recording configuration on the platform */
     36 #define SL_ANDROID_RECORDING_PRESET_GENERIC             ((SLuint32) 0x00000001)
     37 /**   uses the microphone audio source with the same orientation as the camera
     38  *     if available, the main device microphone otherwise */
     39 #define SL_ANDROID_RECORDING_PRESET_CAMCORDER           ((SLuint32) 0x00000002)
     40 /**   uses the main microphone tuned for voice recognition */
     41 #define SL_ANDROID_RECORDING_PRESET_VOICE_RECOGNITION   ((SLuint32) 0x00000003)
     42 /**   uses the main microphone tuned for audio communications */
     43 #define SL_ANDROID_RECORDING_PRESET_VOICE_COMMUNICATION ((SLuint32) 0x00000004)
     44 /**   uses the main microphone unprocessed */
     45 #define SL_ANDROID_RECORDING_PRESET_UNPROCESSED         ((SLuint32) 0x00000005)
     46 
     47 
     48 /*---------------------------------------------------------------------------*/
     49 /* Android AudioPlayer configuration                                         */
     50 /*---------------------------------------------------------------------------*/
     51 
     52 /** Audio playback stream type */
     53 /** Audio playback stream type key */
     54 #define SL_ANDROID_KEY_STREAM_TYPE ((const SLchar*) "androidPlaybackStreamType")
     55 
     56 /** Audio playback stream type  values */
     57 /*      same as android.media.AudioManager.STREAM_VOICE_CALL */
     58 #define SL_ANDROID_STREAM_VOICE        ((SLint32) 0x00000000)
     59 /*      same as android.media.AudioManager.STREAM_SYSTEM */
     60 #define SL_ANDROID_STREAM_SYSTEM       ((SLint32) 0x00000001)
     61 /*      same as android.media.AudioManager.STREAM_RING */
     62 #define SL_ANDROID_STREAM_RING         ((SLint32) 0x00000002)
     63 /*      same as android.media.AudioManager.STREAM_MUSIC */
     64 #define SL_ANDROID_STREAM_MEDIA        ((SLint32) 0x00000003)
     65 /*      same as android.media.AudioManager.STREAM_ALARM */
     66 #define SL_ANDROID_STREAM_ALARM        ((SLint32) 0x00000004)
     67 /*      same as android.media.AudioManager.STREAM_NOTIFICATION */
     68 #define SL_ANDROID_STREAM_NOTIFICATION ((SLint32) 0x00000005)
     69 
     70 
     71 /*---------------------------------------------------------------------------*/
     72 /* Android AudioPlayer and AudioRecorder configuration                       */
     73 /*---------------------------------------------------------------------------*/
     74 
     75 /** Audio Performance mode.
     76  * Performance mode tells the framework how to configure the audio path
     77  * for a player or recorder according to application performance and
     78  * functional requirements.
     79  * It affects the output or input latency based on acceptable tradeoffs on
     80  * battery drain and use of pre or post processing effects.
     81  * Performance mode should be set before realizing the object and should be
     82  * read after realizing the object to check if the requested mode could be
     83  * granted or not.
     84  */
     85 /** Audio Performance mode key */
     86 #define SL_ANDROID_KEY_PERFORMANCE_MODE ((const SLchar*) "androidPerformanceMode")
     87 
     88 /** Audio performance values */
     89 /*      No specific performance requirement. Allows HW and SW pre/post processing. */
     90 #define SL_ANDROID_PERFORMANCE_NONE ((SLuint32) 0x00000000)
     91 /*      Priority given to latency. No HW or software pre/post processing.
     92  *      This is the default if no performance mode is specified. */
     93 #define SL_ANDROID_PERFORMANCE_LATENCY ((SLuint32) 0x00000001)
     94 /*      Priority given to latency while still allowing HW pre and post processing. */
     95 #define SL_ANDROID_PERFORMANCE_LATENCY_EFFECTS ((SLuint32) 0x00000002)
     96 /*      Priority given to power saving if latency is not a concern.
     97  *      Allows HW and SW pre/post processing. */
     98 #define SL_ANDROID_PERFORMANCE_POWER_SAVING ((SLuint32) 0x00000003)
     99 
    100 
    101 #ifdef __cplusplus
    102 }
    103 #endif /* __cplusplus */
    104 
    105 #endif /* OPENSL_ES_ANDROIDCONFIGURATION_H_ */
    106