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 /** \file CAudioPlayer.c AudioPlayer class */
18 
19 #include "sles_allinclusive.h"
20 
21 
22 /** \brief Hook called by Object::Realize when an audio player is realized */
23 
CAudioPlayer_Realize(void * self,SLboolean async)24 SLresult CAudioPlayer_Realize(void *self, SLboolean async)
25 {
26     CAudioPlayer *thiz = (CAudioPlayer *) self;
27     SLresult result = SL_RESULT_SUCCESS;
28 
29 #ifdef ANDROID
30     result = android_audioPlayer_realize(thiz, async);
31 #endif
32 
33 #ifdef USE_SNDFILE
34     result = SndFile_Realize(thiz);
35 #endif
36 
37     // At this point the channel count and sample rate might still be unknown,
38     // depending on the data source and the platform implementation.
39     // If they are unknown here, then they will be determined during prefetch.
40 
41     return result;
42 }
43 
44 
45 /** \brief Hook called by Object::Resume when an audio player is resumed */
46 
CAudioPlayer_Resume(void * self,SLboolean async)47 SLresult CAudioPlayer_Resume(void *self, SLboolean async)
48 {
49     return SL_RESULT_SUCCESS;
50 }
51 
52 
53 /** \brief Hook called by Object::Destroy when an audio player is destroyed */
54 
CAudioPlayer_Destroy(void * self)55 void CAudioPlayer_Destroy(void *self)
56 {
57     CAudioPlayer *thiz = (CAudioPlayer *) self;
58 #ifdef ANDROID
59     android_audioPlayer_destroy(thiz);
60 #endif
61     freeDataLocatorFormat(&thiz->mDataSource);
62     freeDataLocatorFormat(&thiz->mDataSink);
63 #ifdef USE_SNDFILE
64     SndFile_Destroy(thiz);
65 #endif
66 }
67 
68 
69 /** \brief Hook called by Object::Destroy before an audio player is about to be destroyed */
70 
CAudioPlayer_PreDestroy(void * self)71 predestroy_t CAudioPlayer_PreDestroy(void *self)
72 {
73     CAudioPlayer *thiz = (CAudioPlayer *) self;
74 #ifdef ANDROID
75     android_audioPlayer_preDestroy(thiz);
76 #endif
77 
78 #ifdef USE_OUTPUTMIXEXT
79     // Safe to proceed immediately if a track has not yet been assigned
80     Track *track = thiz->mTrack;
81     if (NULL == track) {
82         return predestroy_ok;
83     }
84     CAudioPlayer *audioPlayer = track->mAudioPlayer;
85     if (NULL == audioPlayer) {
86         return predestroy_ok;
87     }
88     assert(audioPlayer == thiz);
89     // Request the mixer thread to unlink this audio player's track
90     thiz->mDestroyRequested = true;
91     while (thiz->mDestroyRequested) {
92         object_cond_wait(self);
93     }
94     // Mixer thread has acknowledged the request
95 #endif
96     return predestroy_ok;
97 }
98 
99 
100 /** \brief Given an audio player, return its data sink, which is guaranteed to be a non-NULL output
101  *  mix.  This function is used by effect send.
102  */
103 
CAudioPlayer_GetOutputMix(CAudioPlayer * audioPlayer)104 COutputMix *CAudioPlayer_GetOutputMix(CAudioPlayer *audioPlayer)
105 {
106     assert(NULL != audioPlayer);
107     assert(SL_DATALOCATOR_OUTPUTMIX == audioPlayer->mDataSink.mLocator.mLocatorType);
108     SLObjectItf outputMix = audioPlayer->mDataSink.mLocator.mOutputMix.outputMix;
109     assert(NULL != outputMix);
110     return (COutputMix *) outputMix;
111 }
112