/* * Copyright (C) 2010 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /* * Copyright (c) 2009 The Khronos Group Inc. * * Permission is hereby granted, free of charge, to any person obtaining a copy of this * software and /or associated documentation files (the "Materials "), to deal in the * Materials without restriction, including without limitation the rights to use, copy, * modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, * and to permit persons to whom the Materials are furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Materials. * * THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE MATERIALS OR THE USE OR OTHER DEALINGS IN THE * MATERIALS. */ #include #include //#include #include //#include #include //#define TEST_VOLUME_ITF //#define TEST_COLD_START #define MAX_NUMBER_INTERFACES 2 #define PREFETCHEVENT_ERROR_CANDIDATE \ (SL_PREFETCHEVENT_STATUSCHANGE | SL_PREFETCHEVENT_FILLLEVELCHANGE) //----------------------------------------------------------------- //* Exits the application if an error is encountered */ #define CheckErr(x) ExitOnErrorFunc(x,__LINE__) void ExitOnErrorFunc( SLresult result , int line) { if (SL_RESULT_SUCCESS != result) { fprintf(stderr, "%u error code encountered at line %d, exiting\n", result, line); exit(EXIT_FAILURE); } } bool prefetchError = false; //----------------------------------------------------------------- /* PrefetchStatusItf callback for an audio player */ void PrefetchEventCallback( SLPrefetchStatusItf caller, void *pContext __unused, SLuint32 event) { SLpermille level = 0; SLresult result; result = (*caller)->GetFillLevel(caller, &level); CheckErr(result); SLuint32 status; //fprintf(stdout, "PrefetchEventCallback: received event %u\n", event); result = (*caller)->GetPrefetchStatus(caller, &status); CheckErr(result); if ((PREFETCHEVENT_ERROR_CANDIDATE == (event & PREFETCHEVENT_ERROR_CANDIDATE)) && (level == 0) && (status == SL_PREFETCHSTATUS_UNDERFLOW)) { fprintf(stdout, "PrefetchEventCallback: Error while prefetching data, exiting\n"); prefetchError = true; } if (event & SL_PREFETCHEVENT_FILLLEVELCHANGE) { fprintf(stdout, "PrefetchEventCallback: Buffer fill level is = %d\n", level); } if (event & SL_PREFETCHEVENT_STATUSCHANGE) { fprintf(stdout, "PrefetchEventCallback: Prefetch Status is = %u\n", status); } } //----------------------------------------------------------------- /* PlayItf callback for playback events */ void PlayEventCallback( SLPlayItf caller, void *pContext __unused, SLuint32 event) { if (SL_PLAYEVENT_HEADATEND & event) { fprintf(stdout, "SL_PLAYEVENT_HEADATEND reached\n"); //SignalEos(); } if (SL_PLAYEVENT_HEADATNEWPOS & event) { SLmillisecond pMsec = 0; (*caller)->GetPosition(caller, &pMsec); fprintf(stdout, "SL_PLAYEVENT_HEADATNEWPOS current position=%ums\n", pMsec); } if (SL_PLAYEVENT_HEADATMARKER & event) { SLmillisecond pMsec = 0; (*caller)->GetPosition(caller, &pMsec); fprintf(stdout, "SL_PLAYEVENT_HEADATMARKER current position=%ums\n", pMsec); } } //----------------------------------------------------------------- /* Play some music from a URI */ void TestPlayUri( SLObjectItf sl, const char* path) { SLEngineItf EngineItf; SLresult res; SLDataSource audioSource; SLDataLocator_URI uri; SLDataFormat_MIME mime; SLDataSink audioSink; SLDataLocator_OutputMix locator_outputmix; SLObjectItf player; SLPlayItf playItf; SLVolumeItf volItf; SLPrefetchStatusItf prefetchItf; SLObjectItf OutputMix; SLboolean required[MAX_NUMBER_INTERFACES]; SLInterfaceID iidArray[MAX_NUMBER_INTERFACES]; /* Get the SL Engine Interface which is implicit */ res = (*sl)->GetInterface(sl, SL_IID_ENGINE, (void*)&EngineItf); CheckErr(res); /* Initialize arrays required[] and iidArray[] */ for (int i=0 ; i < MAX_NUMBER_INTERFACES ; i++) { required[i] = SL_BOOLEAN_FALSE; iidArray[i] = SL_IID_NULL; } // Set arrays required[] and iidArray[] for VOLUME and PREFETCHSTATUS interface required[0] = SL_BOOLEAN_TRUE; iidArray[0] = SL_IID_VOLUME; required[1] = SL_BOOLEAN_TRUE; iidArray[1] = SL_IID_PREFETCHSTATUS; // Create Output Mix object to be used by player res = (*EngineItf)->CreateOutputMix(EngineItf, &OutputMix, 0, iidArray, required); CheckErr(res); // Realizing the Output Mix object in synchronous mode. res = (*OutputMix)->Realize(OutputMix, SL_BOOLEAN_FALSE); CheckErr(res); /* Setup the data source structure for the URI */ uri.locatorType = SL_DATALOCATOR_URI; uri.URI = (SLchar*) path; mime.formatType = SL_DATAFORMAT_MIME; mime.mimeType = (SLchar*)NULL; mime.containerType = SL_CONTAINERTYPE_UNSPECIFIED; audioSource.pFormat = (void *)&mime; audioSource.pLocator = (void *)&uri; /* Setup the data sink structure */ locator_outputmix.locatorType = SL_DATALOCATOR_OUTPUTMIX; locator_outputmix.outputMix = OutputMix; audioSink.pLocator = (void *)&locator_outputmix; audioSink.pFormat = NULL; /* Create the audio player */ res = (*EngineItf)->CreateAudioPlayer(EngineItf, &player, &audioSource, &audioSink, MAX_NUMBER_INTERFACES, iidArray, required); CheckErr(res); /* Realizing the player in synchronous mode. */ res = (*player)->Realize(player, SL_BOOLEAN_FALSE); CheckErr(res); fprintf(stdout, "URI example: after Realize\n"); /* Get interfaces */ res = (*player)->GetInterface(player, SL_IID_PLAY, (void*)&playItf); CheckErr(res); res = (*player)->GetInterface(player, SL_IID_VOLUME, (void*)&volItf); CheckErr(res); res = (*player)->GetInterface(player, SL_IID_PREFETCHSTATUS, (void*)&prefetchItf); CheckErr(res); res = (*prefetchItf)->RegisterCallback(prefetchItf, PrefetchEventCallback, &prefetchItf); CheckErr(res); res = (*prefetchItf)->SetCallbackEventsMask(prefetchItf, SL_PREFETCHEVENT_FILLLEVELCHANGE | SL_PREFETCHEVENT_STATUSCHANGE); CheckErr(res); /* Configure fill level updates every 5 percent */ (*prefetchItf)->SetFillUpdatePeriod(prefetchItf, 50); /* Set up the player callback to get events during the decoding */ res = (*playItf)->SetMarkerPosition(playItf, 2000); CheckErr(res); res = (*playItf)->SetPositionUpdatePeriod(playItf, 500); CheckErr(res); res = (*playItf)->SetCallbackEventsMask(playItf, SL_PLAYEVENT_HEADATMARKER | SL_PLAYEVENT_HEADATNEWPOS | SL_PLAYEVENT_HEADATEND); CheckErr(res); res = (*playItf)->RegisterCallback(playItf, PlayEventCallback, NULL); CheckErr(res); /* Display duration */ SLmillisecond durationInMsec = SL_TIME_UNKNOWN; res = (*playItf)->GetDuration(playItf, &durationInMsec); CheckErr(res); if (durationInMsec == SL_TIME_UNKNOWN) { fprintf(stdout, "Content duration is unknown (before starting to prefetch)\n"); } else { fprintf(stdout, "Content duration is %u ms (before starting to prefetch)\n", durationInMsec); } /* Set the player volume */ res = (*volItf)->SetVolumeLevel( volItf, -300); CheckErr(res); /* Play the URI */ /* first cause the player to prefetch the data */ fprintf(stdout, "Before set to PAUSED\n"); res = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PAUSED ); fprintf(stdout, "After set to PAUSED\n"); CheckErr(res); usleep(100 * 1000); /* wait until there's data to play */ //SLpermille fillLevel = 0; SLuint32 prefetchStatus = SL_PREFETCHSTATUS_UNDERFLOW; SLuint32 timeOutIndex = 100; // 10s while ((prefetchStatus != SL_PREFETCHSTATUS_SUFFICIENTDATA) && (timeOutIndex > 0) && !prefetchError) { usleep(100 * 1000); (*prefetchItf)->GetPrefetchStatus(prefetchItf, &prefetchStatus); timeOutIndex--; } if (timeOutIndex == 0 || prefetchError) { fprintf(stderr, "We\'re done waiting, failed to prefetch data in time, exiting\n"); goto destroyRes; } /* Display duration again, */ res = (*playItf)->GetDuration(playItf, &durationInMsec); CheckErr(res); if (durationInMsec == SL_TIME_UNKNOWN) { fprintf(stdout, "Content duration is unknown (after prefetch completed)\n"); } else { fprintf(stdout, "Content duration is %u ms (after prefetch completed)\n", durationInMsec); } fprintf(stdout, "URI example: starting to play\n"); res = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PLAYING ); CheckErr(res); #ifdef TEST_VOLUME_ITF usleep(5*1000 * 1000); fprintf(stdout, "setting vol to 0\n"); (*volItf)->SetVolumeLevel( volItf, 0); usleep(3*1000 * 1000); fprintf(stdout, "setting vol to -20dB\n"); (*volItf)->SetVolumeLevel( volItf, -2000); usleep(3*1000 * 1000); fprintf(stdout, "mute\n"); (*volItf)->SetMute( volItf, SL_BOOLEAN_TRUE); usleep(3*1000 * 1000); fprintf(stdout, "setting vol to 0dB while muted\n"); (*volItf)->SetVolumeLevel( volItf, 0); usleep(3*1000 * 1000); fprintf(stdout, "unmuting\n"); (*volItf)->SetMute( volItf, SL_BOOLEAN_FALSE); usleep(3*1000 * 1000); #endif #ifndef TEST_COLD_START usleep(durationInMsec * 1000); #else /* Wait as long as the duration of the content before stopping */ /* Experiment: wait for the duration + 200ms: with a cold start of the audio hardware, we */ /* won't see the SL_PLAYEVENT_HEADATEND event, due to hw wake up induced latency, but */ /* with a warm start it will be received. */ usleep((durationInMsec + 200) * 1000); #endif /* Make sure player is stopped */ fprintf(stdout, "URI example: stopping playback\n"); res = (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_STOPPED); CheckErr(res); destroyRes: /* Destroy the player */ (*player)->Destroy(player); /* Destroy Output Mix object */ (*OutputMix)->Destroy(OutputMix); } //----------------------------------------------------------------- int main(int argc, char* const argv[]) { SLresult res; SLObjectItf sl; fprintf(stdout, "OpenSL ES test %s: exercises SLPlayItf, SLVolumeItf ", argv[0]); fprintf(stdout, "and AudioPlayer with SLDataLocator_URI source / OutputMix sink\n"); fprintf(stdout, "Plays a sound and stops after its reported duration\n\n"); if (argc == 1) { fprintf(stdout, "Usage: %s path \n\t%s url\n", argv[0], argv[0]); fprintf(stdout, "Example: \"%s /sdcard/my.mp3\" or \"%s file:///sdcard/my.mp3\"\n", argv[0], argv[0]); exit(EXIT_FAILURE); } SLEngineOption EngineOption[] = { {(SLuint32) SL_ENGINEOPTION_THREADSAFE, (SLuint32) SL_BOOLEAN_TRUE}}; res = slCreateEngine( &sl, 1, EngineOption, 0, NULL, NULL); CheckErr(res); /* Realizing the SL Engine in synchronous mode. */ res = (*sl)->Realize(sl, SL_BOOLEAN_FALSE); CheckErr(res); TestPlayUri(sl, argv[1]); /* Shutdown OpenSL ES */ (*sl)->Destroy(sl); return EXIT_SUCCESS; }