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