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 23 #include <SLES/OpenSLES.h> 24 25 26 #define MAX_NUMBER_INTERFACES 2 27 28 #define TEST_MUTE 0 29 #define TEST_SOLO 1 30 31 //----------------------------------------------------------------- 32 /* Exits the application if an error is encountered */ 33 #define ExitOnError(x) ExitOnErrorFunc(x,__LINE__) 34 35 void ExitOnErrorFunc( SLresult result , int line) 36 { 37 if (SL_RESULT_SUCCESS != result) { 38 fprintf(stdout, "%u error code encountered at line %d, exiting\n", result, line); 39 exit(EXIT_FAILURE); 40 } 41 } 42 43 44 //----------------------------------------------------------------- 45 46 /* Play an audio URIs, play, pause, stop */ 47 void TestPlayUri( SLObjectItf sl, const char* path) 48 { 49 SLresult result; 50 SLEngineItf EngineItf; 51 52 /* Objects this application uses: one player and an ouput mix */ 53 SLObjectItf player, outputMix; 54 55 /* Source of audio data to play */ 56 SLDataSource audioSource; 57 SLDataLocator_URI uri; 58 SLDataFormat_MIME mime; 59 60 /* Data sinks for the audio player */ 61 SLDataSink audioSink; 62 SLDataLocator_OutputMix locator_outputmix; 63 64 /* Play, Volume and PrefetchStatus interfaces for the audio player */ 65 SLPlayItf playItf; 66 SLMuteSoloItf muteSoloItf; 67 SLPrefetchStatusItf prefetchItf; 68 69 SLboolean required[MAX_NUMBER_INTERFACES]; 70 SLInterfaceID iidArray[MAX_NUMBER_INTERFACES]; 71 72 /* Get the SL Engine Interface which is implicit */ 73 result = (*sl)->GetInterface(sl, SL_IID_ENGINE, (void*)&EngineItf); 74 ExitOnError(result); 75 76 /* Initialize arrays required[] and iidArray[] */ 77 for (int i=0 ; i < MAX_NUMBER_INTERFACES ; i++) { 78 required[i] = SL_BOOLEAN_FALSE; 79 iidArray[i] = SL_IID_NULL; 80 } 81 82 /* ------------------------------------------------------ */ 83 /* Configuration of the output mix */ 84 85 /* Create Output Mix object to be used by the player */ 86 result = (*EngineItf)->CreateOutputMix(EngineItf, &outputMix, 0, iidArray, required); 87 ExitOnError(result); 88 89 /* Realize the Output Mix object in synchronous mode */ 90 result = (*outputMix)->Realize(outputMix, SL_BOOLEAN_FALSE); 91 ExitOnError(result); 92 93 /* Setup the data sink structure */ 94 locator_outputmix.locatorType = SL_DATALOCATOR_OUTPUTMIX; 95 locator_outputmix.outputMix = outputMix; 96 audioSink.pLocator = (void*)&locator_outputmix; 97 audioSink.pFormat = NULL; 98 99 /* ------------------------------------------------------ */ 100 /* Configuration of the player */ 101 102 /* Set arrays required[] and iidArray[] for SLMuteSoloItf and SLPrefetchStatusItf interfaces */ 103 /* (SLPlayItf is implicit) */ 104 required[0] = SL_BOOLEAN_TRUE; 105 iidArray[0] = SL_IID_MUTESOLO; 106 required[1] = SL_BOOLEAN_TRUE; 107 iidArray[1] = SL_IID_PREFETCHSTATUS; 108 109 /* Setup the data source structure for the URI */ 110 uri.locatorType = SL_DATALOCATOR_URI; 111 uri.URI = (SLchar*) path; 112 mime.formatType = SL_DATAFORMAT_MIME; 113 /* this is how ignored mime information is specified, according to OpenSL ES spec 114 * in 9.1.6 SLDataFormat_MIME and 8.23 SLMetadataTraversalItf GetChildInfo */ 115 mime.mimeType = (SLchar*)NULL; 116 mime.containerType = SL_CONTAINERTYPE_UNSPECIFIED; 117 118 audioSource.pFormat = (void*)&mime; 119 audioSource.pLocator = (void*)&uri; 120 121 /* Create the audio player */ 122 result = (*EngineItf)->CreateAudioPlayer(EngineItf, &player, &audioSource, &audioSink, 123 MAX_NUMBER_INTERFACES, iidArray, required); 124 ExitOnError(result); 125 126 /* Realize the player in synchronous mode. */ 127 result = (*player)->Realize(player, SL_BOOLEAN_FALSE); ExitOnError(result); 128 fprintf(stdout, "URI example: after Realize\n"); 129 130 /* Get the SLPlayItf, SLPrefetchStatusItf and SLMuteSoloItf interfaces for the player */ 131 result = (*player)->GetInterface(player, SL_IID_PLAY, (void*)&playItf); 132 ExitOnError(result); 133 134 result = (*player)->GetInterface(player, SL_IID_PREFETCHSTATUS, (void*)&prefetchItf); 135 ExitOnError(result); 136 137 result = (*player)->GetInterface(player, SL_IID_MUTESOLO, (void*)&muteSoloItf); 138 ExitOnError(result); 139 140 141 fprintf(stdout, "Player configured\n"); 142 143 /* ------------------------------------------------------ */ 144 /* Playback and test */ 145 146 /* Start the data prefetching by setting the player to the paused state */ 147 result = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PAUSED ); 148 ExitOnError(result); 149 150 /* Wait until there's data to play */ 151 SLuint32 prefetchStatus = SL_PREFETCHSTATUS_UNDERFLOW; 152 while (prefetchStatus != SL_PREFETCHSTATUS_SUFFICIENTDATA) { 153 usleep(100 * 1000); 154 (*prefetchItf)->GetPrefetchStatus(prefetchItf, &prefetchStatus); 155 } 156 157 158 /* Testing play states */ 159 /* let it play for 2s */ 160 fprintf(stdout, "----- Playing\n"); 161 result = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PLAYING ); 162 ExitOnError(result); 163 usleep(2 * 1000 * 1000); 164 165 /* pause for 1s*/ 166 fprintf(stdout, "----- Pausing (1s)\n"); 167 result = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PAUSED ); 168 ExitOnError(result); 169 usleep(2 * 1000 * 1000); 170 171 /* resume */ 172 fprintf(stdout, "----- Playing (2s, should have resumed where it paused)\n"); 173 result = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PLAYING ); 174 ExitOnError(result); 175 usleep(2 * 1000 * 1000); 176 177 /* stop */ 178 fprintf(stdout, "----- Stopping\n"); 179 result = (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_STOPPED); 180 ExitOnError(result); 181 182 /* play for 2s */ 183 fprintf(stdout, "----- Playing (2s, should have started from the beginning\n"); 184 result = (*playItf)->SetPlayState( playItf, SL_PLAYSTATE_PLAYING ); 185 ExitOnError(result); 186 usleep(2 * 1000 * 1000); 187 188 /* stop */ 189 fprintf(stdout, "----- Stopping\n"); 190 result = (*playItf)->SetPlayState(playItf, SL_PLAYSTATE_STOPPED); 191 ExitOnError(result); 192 193 /* Destroy the players */ 194 (*player)->Destroy(player); 195 196 /* Destroy Output Mix object */ 197 (*outputMix)->Destroy(outputMix); 198 } 199 200 //----------------------------------------------------------------- 201 int main(int argc, char* const argv[]) 202 { 203 SLresult result; 204 SLObjectItf sl; 205 206 fprintf(stdout, "OpenSL ES test %s: exercises SLPlayItf, SLVolumeItf, SLMuteSoloItf\n", 207 argv[0]); 208 fprintf(stdout, "and AudioPlayer with SLDataLocator_URI source / OutputMix sink\n"); 209 fprintf(stdout, "Plays a sound and alternates the muting of the channels (for 5s).\n"); 210 fprintf(stdout, " and then alternates the solo\'ing of the channels (for 5s).\n"); 211 fprintf(stdout, "Stops after 10s\n"); 212 213 if (argc == 1) { 214 fprintf(stdout, "Usage: \t%s url\n", argv[0]); 215 fprintf(stdout, "Example: \"%s /sdcard/my.mp3\"\n", argv[0]); 216 exit(EXIT_FAILURE); 217 } 218 219 SLEngineOption EngineOption[] = { 220 {(SLuint32) SL_ENGINEOPTION_THREADSAFE, (SLuint32) SL_BOOLEAN_TRUE} 221 }; 222 223 result = slCreateEngine( &sl, 1, EngineOption, 0, NULL, NULL); 224 ExitOnError(result); 225 226 /* Realizing the SL Engine in synchronous mode. */ 227 result = (*sl)->Realize(sl, SL_BOOLEAN_FALSE); 228 ExitOnError(result); 229 230 if (argc > 1) { 231 TestPlayUri(sl, argv[1]); 232 } 233 234 /* Shutdown OpenSL ES */ 235 (*sl)->Destroy(sl); 236 237 return EXIT_SUCCESS; 238 } 239