/*
* 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 <stdlib.h>
#include <stdio.h>
//#include <string.h>
#include <unistd.h>
//#include <sys/time.h>
#include <SLES/OpenSLES.h>
//#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;
}