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 #include <stdlib.h>
18 #include <stdio.h>
19 #include <string.h>
20 #include <unistd.h>
21 #include <sys/time.h>
22 #include <fcntl.h>
23
24 #include <SLES/OpenSLES.h>
25 #ifdef ANDROID
26 #include <SLES/OpenSLES_Android.h>
27 #endif
28
29
30 #define MAX_NUMBER_INTERFACES 3
31
32 #define TIME_S_BETWEEN_BB_ON_OFF 3
33
34 //-----------------------------------------------------------------
35 /* Exits the application if an error is encountered */
36 #define ExitOnError(x) ExitOnErrorFunc(x,__LINE__)
37
ExitOnErrorFunc(SLresult result,int line)38 void ExitOnErrorFunc( SLresult result , int line)
39 {
40 if (SL_RESULT_SUCCESS != result) {
41 fprintf(stderr, "%u error code encountered at line %d, exiting\n", result, line);
42 exit(EXIT_FAILURE);
43 }
44 }
45
46
47 //-----------------------------------------------------------------
48
49 /* Play an audio path by opening a file descriptor on that path */
TestBassBoostPathFromFD(SLObjectItf sl,const char * path,int16_t boostStrength,bool alwaysOn)50 void TestBassBoostPathFromFD(SLObjectItf sl, const char* path, int16_t boostStrength, bool alwaysOn)
51 {
52 SLresult result;
53 SLEngineItf EngineItf;
54
55 /* Objects this application uses: one player and an ouput mix */
56 SLObjectItf player, outputMix;
57
58 /* Source of audio data to play */
59 SLDataSource audioSource;
60 #ifdef ANDROID
61 SLDataLocator_AndroidFD locatorFd;
62 #else
63 SLDataLocator_URI locatorUri;
64 #endif
65 SLDataFormat_MIME mime;
66
67 /* Data sinks for the audio player */
68 SLDataSink audioSink;
69 SLDataLocator_OutputMix locator_outputmix;
70
71 /* Interfaces for the audio player */
72 SLPlayItf playItf;
73 SLPrefetchStatusItf prefetchItf;
74 SLBassBoostItf bbItf;
75
76 SLboolean required[MAX_NUMBER_INTERFACES];
77 SLInterfaceID iidArray[MAX_NUMBER_INTERFACES];
78
79 /* Get the SL Engine Interface which is implicit */
80 result = (*sl)->GetInterface(sl, SL_IID_ENGINE, (void*)&EngineItf);
81 ExitOnError(result);
82
83 /* Initialize arrays required[] and iidArray[] */
84 for (int i=0 ; i < MAX_NUMBER_INTERFACES ; i++) {
85 required[i] = SL_BOOLEAN_FALSE;
86 iidArray[i] = SL_IID_NULL;
87 }
88
89 /* ------------------------------------------------------ */
90 /* Configuration of the output mix */
91
92 /* Create Output Mix object to be used by the player */
93 result = (*EngineItf)->CreateOutputMix(EngineItf, &outputMix, 1, iidArray, required);
94 ExitOnError(result);
95
96 /* Realize the Output Mix object in synchronous mode */
97 result = (*outputMix)->Realize(outputMix, SL_BOOLEAN_FALSE);
98 ExitOnError(result);
99
100 /* Setup the data sink structure */
101 locator_outputmix.locatorType = SL_DATALOCATOR_OUTPUTMIX;
102 locator_outputmix.outputMix = outputMix;
103 audioSink.pLocator = (void*)&locator_outputmix;
104 audioSink.pFormat = NULL;
105
106 /* ------------------------------------------------------ */
107 /* Configuration of the player */
108
109 /* Set arrays required[] and iidArray[] for required interfaces */
110 /* (SLPlayItf is implicit) */
111 required[0] = SL_BOOLEAN_TRUE;
112 iidArray[0] = SL_IID_PREFETCHSTATUS;
113 required[1] = SL_BOOLEAN_TRUE;
114 iidArray[1] = SL_IID_BASSBOOST;
115
116 #ifdef ANDROID
117 /* Setup the data source structure for the URI */
118 locatorFd.locatorType = SL_DATALOCATOR_ANDROIDFD;
119 int fd = open(path, O_RDONLY);
120 if (fd == -1) {
121 ExitOnError(SL_RESULT_RESOURCE_ERROR);
122 }
123 locatorFd.fd = (SLint32) fd;
124 locatorFd.length = SL_DATALOCATOR_ANDROIDFD_USE_FILE_SIZE;
125 locatorFd.offset = 0;
126 #else
127 locatorUri.locatorType = SL_DATALOCATOR_URI;
128 locatorUri.URI = (SLchar *) path;
129 #endif
130
131 mime.formatType = SL_DATAFORMAT_MIME;
132 /* this is how ignored mime information is specified, according to OpenSL ES spec
133 * in 9.1.6 SLDataFormat_MIME and 8.23 SLMetadataTraversalItf GetChildInfo */
134 mime.mimeType = (SLchar*)NULL;
135 mime.containerType = SL_CONTAINERTYPE_UNSPECIFIED;
136
137 audioSource.pFormat = (void*)&mime;
138 #ifdef ANDROID
139 audioSource.pLocator = (void*)&locatorFd;
140 #else
141 audioSource.pLocator = (void*)&locatorUri;
142 #endif
143
144 /* Create the audio player */
145 result = (*EngineItf)->CreateAudioPlayer(EngineItf, &player, &audioSource, &audioSink, 2,
146 iidArray, required);
147 ExitOnError(result);
148
149 /* Realize the player in synchronous mode. */
150 result = (*player)->Realize(player, SL_BOOLEAN_FALSE); ExitOnError(result);
151 fprintf(stdout, "URI example: after Realize\n");
152
153 /* Get the SLPlayItf, SLPrefetchStatusItf and SLBassBoostItf interfaces for the player */
154 result = (*player)->GetInterface(player, SL_IID_PLAY, (void*)&playItf);
155 ExitOnError(result);
156
157 result = (*player)->GetInterface(player, SL_IID_PREFETCHSTATUS, (void*)&prefetchItf);
158 ExitOnError(result);
159
160 result = (*player)->GetInterface(player, SL_IID_BASSBOOST, (void*)&bbItf);
161 ExitOnError(result);
162
163 fprintf(stdout, "Player configured\n");
164
165 /* ------------------------------------------------------ */
166 /* Playback and test */
167
168 /* Start the data prefetching by setting the player to the paused state */
169 result = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PAUSED );
170 ExitOnError(result);
171
172 /* Wait until there's data to play */
173 SLuint32 prefetchStatus = SL_PREFETCHSTATUS_UNDERFLOW;
174 while (prefetchStatus != SL_PREFETCHSTATUS_SUFFICIENTDATA) {
175 usleep(100 * 1000);
176 (*prefetchItf)->GetPrefetchStatus(prefetchItf, &prefetchStatus);
177 ExitOnError(result);
178 }
179
180 /* Get duration */
181 SLmillisecond durationInMsec = SL_TIME_UNKNOWN;
182 result = (*playItf)->GetDuration(playItf, &durationInMsec);
183 ExitOnError(result);
184 if (durationInMsec == SL_TIME_UNKNOWN) {
185 durationInMsec = 5000;
186 }
187
188 /* Start playback */
189 fprintf(stdout, "Starting to play\n");
190 result = (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_PLAYING );
191 ExitOnError(result);
192
193 /* Configure BassBoost */
194 SLboolean strengthSupported = SL_BOOLEAN_FALSE;
195 result = (*bbItf)->IsStrengthSupported(bbItf, &strengthSupported);
196 ExitOnError(result);
197 if (SL_BOOLEAN_FALSE == strengthSupported) {
198 fprintf(stdout, "BassBoost strength is not supported on this platform. Too bad!\n");
199 } else {
200 fprintf(stdout, "BassBoost strength is supported, setting strength to %d\n", boostStrength);
201 result = (*bbItf)->SetStrength(bbItf, boostStrength);
202 ExitOnError(result);
203 }
204
205 SLpermille strength = 0;
206 result = (*bbItf)->GetRoundedStrength(bbItf, &strength);
207 ExitOnError(result);
208 fprintf(stdout, "Rounded strength of boost = %d\n", strength);
209
210
211 /* Switch BassBoost on/off every TIME_S_BETWEEN_BB_ON_OFF seconds unless always on */
212 SLboolean previousEnabled = SL_BOOLEAN_FALSE;
213 for(unsigned int j=0 ; j<(durationInMsec/(1000*TIME_S_BETWEEN_BB_ON_OFF)) ; j++) {
214 SLboolean enabled;
215 result = (*bbItf)->IsEnabled(bbItf, &enabled);
216 ExitOnError(result);
217 enabled = alwaysOn || !enabled;
218 if (enabled != previousEnabled) {
219 result = (*bbItf)->SetEnabled(bbItf, enabled);
220 ExitOnError(result);
221 previousEnabled = enabled;
222 if (SL_BOOLEAN_TRUE == enabled) {
223 fprintf(stdout, "BassBoost on\n");
224 } else {
225 fprintf(stdout, "BassBoost off\n");
226 }
227 }
228 usleep(TIME_S_BETWEEN_BB_ON_OFF * 1000 * 1000);
229 }
230
231 /* Make sure player is stopped */
232 fprintf(stdout, "Stopping playback\n");
233 result = (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_STOPPED);
234 ExitOnError(result);
235
236 /* Destroy the player */
237 (*player)->Destroy(player);
238
239 /* Destroy Output Mix object */
240 (*outputMix)->Destroy(outputMix);
241
242 #ifdef ANDROID
243 close(fd);
244 #endif
245 }
246
247 //-----------------------------------------------------------------
main(int argc,char * const argv[])248 int main(int argc, char* const argv[])
249 {
250 const char *programName = argv[0];
251 SLresult result;
252 SLObjectItf sl;
253
254 fprintf(stdout, "OpenSL ES test %s: exercises SLBassBoostItf ", programName);
255 fprintf(stdout, "and AudioPlayer with SLDataLocator_AndroidFD source / OutputMix sink\n");
256 fprintf(stdout, "Plays the sound file designated by the given path, ");
257 fprintf(stdout, "and applies a bass boost effect of the specified strength,\n");
258 fprintf(stdout, "where strength is a integer value between 0 and 1000.\n");
259 fprintf(stdout, "Every %d seconds, the BassBoost will be turned on and off,\n",
260 TIME_S_BETWEEN_BB_ON_OFF);
261 fprintf(stdout, "unless the --always-on option is specified before the path.\n");
262
263 bool alwaysOn = false;
264 if (argc >= 2 && !strcmp(argv[1], "--always-on")) {
265 alwaysOn = true;
266 --argc;
267 ++argv;
268 }
269
270 if (argc < 3) {
271 fprintf(stdout, "Usage: \t%s [--always-on] path bass_boost_strength\n", programName);
272 fprintf(stdout, "Example: \"%s /sdcard/my.mp3 1000\" \n", programName);
273 exit(EXIT_FAILURE);
274 }
275
276 SLEngineOption EngineOption[] = {
277 {(SLuint32) SL_ENGINEOPTION_THREADSAFE, (SLuint32) SL_BOOLEAN_TRUE}
278 };
279
280 result = slCreateEngine( &sl, 1, EngineOption, 0, NULL, NULL);
281 ExitOnError(result);
282
283 /* Realizing the SL Engine in synchronous mode. */
284 result = (*sl)->Realize(sl, SL_BOOLEAN_FALSE);
285 ExitOnError(result);
286
287 // intentionally not checking that argv[2], the bassboost strength, is between 0 and 1000
288 TestBassBoostPathFromFD(sl, argv[1], (int16_t)atoi(argv[2]), alwaysOn);
289
290 /* Shutdown OpenSL ES */
291 (*sl)->Destroy(sl);
292
293 return EXIT_SUCCESS;
294 }
295