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/* 18 * Copyright (c) 2009 The Khronos Group Inc. 19 * 20 * Permission is hereby granted, free of charge, to any person obtaining a copy of this 21 * software and /or associated documentation files (the "Materials "), to deal in the 22 * Materials without restriction, including without limitation the rights to use, copy, 23 * modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, 24 * and to permit persons to whom the Materials are furnished to do so, subject to 25 * the following conditions: 26 * 27 * The above copyright notice and this permission notice shall be included 28 * in all copies or substantial portions of the Materials. 29 * 30 * THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 31 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 32 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 33 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS 34 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 35 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 36 * CONNECTION WITH THE MATERIALS OR THE USE OR OTHER DEALINGS IN THE 37 * MATERIALS. 38 */ 39 40#include <stdlib.h> 41#include <stdio.h> 42//#include <string.h> 43#include <unistd.h> 44//#include <sys/time.h> 45 46#include <SLES/OpenSLES.h> 47 48//#define TEST_VOLUME_ITF 49//#define TEST_COLD_START 50 51#define MAX_NUMBER_INTERFACES 2 52 53#define PREFETCHEVENT_ERROR_CANDIDATE \ 54 (SL_PREFETCHEVENT_STATUSCHANGE | SL_PREFETCHEVENT_FILLLEVELCHANGE) 55 56//----------------------------------------------------------------- 57//* Exits the application if an error is encountered */ 58#define CheckErr(x) ExitOnErrorFunc(x,__LINE__) 59 60void ExitOnErrorFunc( SLresult result , int line) 61{ 62 if (SL_RESULT_SUCCESS != result) { 63 fprintf(stderr, "%u error code encountered at line %d, exiting\n", result, line); 64 exit(EXIT_FAILURE); 65 } 66} 67 68bool prefetchError = false; 69 70//----------------------------------------------------------------- 71/* PrefetchStatusItf callback for an audio player */ 72void PrefetchEventCallback( SLPrefetchStatusItf caller, void *pContext __unused, SLuint32 event) 73{ 74 SLpermille level = 0; 75 SLresult result; 76 result = (*caller)->GetFillLevel(caller, &level); 77 CheckErr(result); 78 SLuint32 status; 79 //fprintf(stdout, "PrefetchEventCallback: received event %u\n", event); 80 result = (*caller)->GetPrefetchStatus(caller, &status); 81 CheckErr(result); 82 if ((PREFETCHEVENT_ERROR_CANDIDATE == (event & PREFETCHEVENT_ERROR_CANDIDATE)) 83 && (level == 0) && (status == SL_PREFETCHSTATUS_UNDERFLOW)) { 84 fprintf(stdout, "PrefetchEventCallback: Error while prefetching data, exiting\n"); 85 prefetchError = true; 86 } 87 if (event & SL_PREFETCHEVENT_FILLLEVELCHANGE) { 88 fprintf(stdout, "PrefetchEventCallback: Buffer fill level is = %d\n", level); 89 } 90 if (event & SL_PREFETCHEVENT_STATUSCHANGE) { 91 fprintf(stdout, "PrefetchEventCallback: Prefetch Status is = %u\n", status); 92 } 93} 94 95 96//----------------------------------------------------------------- 97/* PlayItf callback for playback events */ 98void PlayEventCallback( 99 SLPlayItf caller, 100 void *pContext __unused, 101 SLuint32 event) 102{ 103 if (SL_PLAYEVENT_HEADATEND & event) { 104 fprintf(stdout, "SL_PLAYEVENT_HEADATEND reached\n"); 105 //SignalEos(); 106 } 107 108 if (SL_PLAYEVENT_HEADATNEWPOS & event) { 109 SLmillisecond pMsec = 0; 110 (*caller)->GetPosition(caller, &pMsec); 111 fprintf(stdout, "SL_PLAYEVENT_HEADATNEWPOS current position=%ums\n", pMsec); 112 } 113 114 if (SL_PLAYEVENT_HEADATMARKER & event) { 115 SLmillisecond pMsec = 0; 116 (*caller)->GetPosition(caller, &pMsec); 117 fprintf(stdout, "SL_PLAYEVENT_HEADATMARKER current position=%ums\n", pMsec); 118 } 119} 120 121 122//----------------------------------------------------------------- 123 124/* Play some music from a URI */ 125void TestPlayUri( SLObjectItf sl, const char* path) 126{ 127 SLEngineItf EngineItf; 128 129 SLresult res; 130 131 SLDataSource audioSource; 132 SLDataLocator_URI uri; 133 SLDataFormat_MIME mime; 134 135 SLDataSink audioSink; 136 SLDataLocator_OutputMix locator_outputmix; 137 138 SLObjectItf player; 139 SLPlayItf playItf; 140 SLVolumeItf volItf; 141 SLPrefetchStatusItf prefetchItf; 142 143 SLObjectItf OutputMix; 144 145 SLboolean required[MAX_NUMBER_INTERFACES]; 146 SLInterfaceID iidArray[MAX_NUMBER_INTERFACES]; 147 148 /* Get the SL Engine Interface which is implicit */ 149 res = (*sl)->GetInterface(sl, SL_IID_ENGINE, (void*)&EngineItf); 150 CheckErr(res); 151 152 /* Initialize arrays required[] and iidArray[] */ 153 for (int i=0 ; i < MAX_NUMBER_INTERFACES ; i++) { 154 required[i] = SL_BOOLEAN_FALSE; 155 iidArray[i] = SL_IID_NULL; 156 } 157 158 // Set arrays required[] and iidArray[] for VOLUME and PREFETCHSTATUS interface 159 required[0] = SL_BOOLEAN_TRUE; 160 iidArray[0] = SL_IID_VOLUME; 161 required[1] = SL_BOOLEAN_TRUE; 162 iidArray[1] = SL_IID_PREFETCHSTATUS; 163 // Create Output Mix object to be used by player 164 res = (*EngineItf)->CreateOutputMix(EngineItf, &OutputMix, 0, 165 iidArray, required); CheckErr(res); 166 167 // Realizing the Output Mix object in synchronous mode. 168 res = (*OutputMix)->Realize(OutputMix, SL_BOOLEAN_FALSE); 169 CheckErr(res); 170 171 /* Setup the data source structure for the URI */ 172 uri.locatorType = SL_DATALOCATOR_URI; 173 uri.URI = (SLchar*) path; 174 mime.formatType = SL_DATAFORMAT_MIME; 175 mime.mimeType = (SLchar*)NULL; 176 mime.containerType = SL_CONTAINERTYPE_UNSPECIFIED; 177 178 audioSource.pFormat = (void *)&mime; 179 audioSource.pLocator = (void *)&uri; 180 181 /* Setup the data sink structure */ 182 locator_outputmix.locatorType = SL_DATALOCATOR_OUTPUTMIX; 183 locator_outputmix.outputMix = OutputMix; 184 audioSink.pLocator = (void *)&locator_outputmix; 185 audioSink.pFormat = NULL; 186 187 /* Create the audio player */ 188 res = (*EngineItf)->CreateAudioPlayer(EngineItf, &player, &audioSource, &audioSink, 189 MAX_NUMBER_INTERFACES, iidArray, required); CheckErr(res); 190 191 /* Realizing the player in synchronous mode. */ 192 res = (*player)->Realize(player, SL_BOOLEAN_FALSE); CheckErr(res); 193 fprintf(stdout, "URI example: after Realize\n"); 194 195 /* Get interfaces */ 196 res = (*player)->GetInterface(player, SL_IID_PLAY, (void*)&playItf); 197 CheckErr(res); 198 199 res = (*player)->GetInterface(player, SL_IID_VOLUME, (void*)&volItf); 200 CheckErr(res); 201 202 res = (*player)->GetInterface(player, SL_IID_PREFETCHSTATUS, (void*)&prefetchItf); 203 CheckErr(res); 204 res = (*prefetchItf)->RegisterCallback(prefetchItf, PrefetchEventCallback, &prefetchItf); 205 CheckErr(res); 206 res = (*prefetchItf)->SetCallbackEventsMask(prefetchItf, 207 SL_PREFETCHEVENT_FILLLEVELCHANGE | SL_PREFETCHEVENT_STATUSCHANGE); 208 CheckErr(res); 209 210 /* Configure fill level updates every 5 percent */ 211 (*prefetchItf)->SetFillUpdatePeriod(prefetchItf, 50); 212 213 /* Set up the player callback to get events during the decoding */ 214 res = (*playItf)->SetMarkerPosition(playItf, 2000); 215 CheckErr(res); 216 res = (*playItf)->SetPositionUpdatePeriod(playItf, 500); 217 CheckErr(res); 218 res = (*playItf)->SetCallbackEventsMask(playItf, 219 SL_PLAYEVENT_HEADATMARKER | SL_PLAYEVENT_HEADATNEWPOS | SL_PLAYEVENT_HEADATEND); 220 CheckErr(res); 221 res = (*playItf)->RegisterCallback(playItf, PlayEventCallback, NULL); 222 CheckErr(res); 223 224 /* Display duration */ 225 SLmillisecond durationInMsec = SL_TIME_UNKNOWN; 226 res = (*playItf)->GetDuration(playItf, &durationInMsec); 227 CheckErr(res); 228 if (durationInMsec == SL_TIME_UNKNOWN) { 229 fprintf(stdout, "Content duration is unknown (before starting to prefetch)\n"); 230 } else { 231 fprintf(stdout, "Content duration is %u ms (before starting to prefetch)\n", 232 durationInMsec); 233 } 234 235 /* Set the player volume */ 236 res = (*volItf)->SetVolumeLevel( volItf, -300); 237 CheckErr(res); 238 239 /* Play the URI */ 240 /* first cause the player to prefetch the data */ 241 fprintf(stdout, "Before set to PAUSED\n"); 242 res = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PAUSED ); 243 fprintf(stdout, "After set to PAUSED\n"); 244 CheckErr(res); 245 246 usleep(100 * 1000); 247 /* wait until there's data to play */ 248 //SLpermille fillLevel = 0; 249 SLuint32 prefetchStatus = SL_PREFETCHSTATUS_UNDERFLOW; 250 SLuint32 timeOutIndex = 100; // 10s 251 while ((prefetchStatus != SL_PREFETCHSTATUS_SUFFICIENTDATA) && (timeOutIndex > 0) && 252 !prefetchError) { 253 usleep(100 * 1000); 254 (*prefetchItf)->GetPrefetchStatus(prefetchItf, &prefetchStatus); 255 timeOutIndex--; 256 } 257 258 if (timeOutIndex == 0 || prefetchError) { 259 fprintf(stderr, "We\'re done waiting, failed to prefetch data in time, exiting\n"); 260 goto destroyRes; 261 } 262 263 /* Display duration again, */ 264 res = (*playItf)->GetDuration(playItf, &durationInMsec); 265 CheckErr(res); 266 if (durationInMsec == SL_TIME_UNKNOWN) { 267 fprintf(stdout, "Content duration is unknown (after prefetch completed)\n"); 268 } else { 269 fprintf(stdout, "Content duration is %u ms (after prefetch completed)\n", durationInMsec); 270 } 271 272 fprintf(stdout, "URI example: starting to play\n"); 273 res = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PLAYING ); 274 CheckErr(res); 275 276#ifdef TEST_VOLUME_ITF 277 usleep(5*1000 * 1000); 278 fprintf(stdout, "setting vol to 0\n"); 279 (*volItf)->SetVolumeLevel( volItf, 0); 280 usleep(3*1000 * 1000); 281 fprintf(stdout, "setting vol to -20dB\n"); 282 (*volItf)->SetVolumeLevel( volItf, -2000); 283 usleep(3*1000 * 1000); 284 fprintf(stdout, "mute\n"); 285 (*volItf)->SetMute( volItf, SL_BOOLEAN_TRUE); 286 usleep(3*1000 * 1000); 287 fprintf(stdout, "setting vol to 0dB while muted\n"); 288 (*volItf)->SetVolumeLevel( volItf, 0); 289 usleep(3*1000 * 1000); 290 fprintf(stdout, "unmuting\n"); 291 (*volItf)->SetMute( volItf, SL_BOOLEAN_FALSE); 292 usleep(3*1000 * 1000); 293#endif 294 295#ifndef TEST_COLD_START 296 usleep(durationInMsec * 1000); 297#else 298 /* Wait as long as the duration of the content before stopping */ 299 /* Experiment: wait for the duration + 200ms: with a cold start of the audio hardware, we */ 300 /* won't see the SL_PLAYEVENT_HEADATEND event, due to hw wake up induced latency, but */ 301 /* with a warm start it will be received. */ 302 usleep((durationInMsec + 200) * 1000); 303#endif 304 305 /* Make sure player is stopped */ 306 fprintf(stdout, "URI example: stopping playback\n"); 307 res = (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_STOPPED); 308 CheckErr(res); 309 310destroyRes: 311 312 /* Destroy the player */ 313 (*player)->Destroy(player); 314 315 /* Destroy Output Mix object */ 316 (*OutputMix)->Destroy(OutputMix); 317} 318 319//----------------------------------------------------------------- 320int main(int argc, char* const argv[]) 321{ 322 SLresult res; 323 SLObjectItf sl; 324 325 fprintf(stdout, "OpenSL ES test %s: exercises SLPlayItf, SLVolumeItf ", argv[0]); 326 fprintf(stdout, "and AudioPlayer with SLDataLocator_URI source / OutputMix sink\n"); 327 fprintf(stdout, "Plays a sound and stops after its reported duration\n\n"); 328 329 if (argc == 1) { 330 fprintf(stdout, "Usage: %s path \n\t%s url\n", argv[0], argv[0]); 331 fprintf(stdout, "Example: \"%s /sdcard/my.mp3\" or \"%s file:///sdcard/my.mp3\"\n", 332 argv[0], argv[0]); 333 exit(EXIT_FAILURE); 334 } 335 336 SLEngineOption EngineOption[] = { 337 {(SLuint32) SL_ENGINEOPTION_THREADSAFE, 338 (SLuint32) SL_BOOLEAN_TRUE}}; 339 340 res = slCreateEngine( &sl, 1, EngineOption, 0, NULL, NULL); 341 CheckErr(res); 342 /* Realizing the SL Engine in synchronous mode. */ 343 res = (*sl)->Realize(sl, SL_BOOLEAN_FALSE); 344 CheckErr(res); 345 346 TestPlayUri(sl, argv[1]); 347 348 /* Shutdown OpenSL ES */ 349 (*sl)->Destroy(sl); 350 351 return EXIT_SUCCESS; 352} 353