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
21extern "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