1*b7c941bbSAndroid Build Coastguard Worker /* 2*b7c941bbSAndroid Build Coastguard Worker * Copyright 2020 The Android Open Source Project 3*b7c941bbSAndroid Build Coastguard Worker * 4*b7c941bbSAndroid Build Coastguard Worker * Licensed under the Apache License, Version 2.0 (the "License"); 5*b7c941bbSAndroid Build Coastguard Worker * you may not use this file except in compliance with the License. 6*b7c941bbSAndroid Build Coastguard Worker * You may obtain a copy of the License at 7*b7c941bbSAndroid Build Coastguard Worker * 8*b7c941bbSAndroid Build Coastguard Worker * http://www.apache.org/licenses/LICENSE-2.0 9*b7c941bbSAndroid Build Coastguard Worker * 10*b7c941bbSAndroid Build Coastguard Worker * Unless required by applicable law or agreed to in writing, software 11*b7c941bbSAndroid Build Coastguard Worker * distributed under the License is distributed on an "AS IS" BASIS, 12*b7c941bbSAndroid Build Coastguard Worker * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13*b7c941bbSAndroid Build Coastguard Worker * See the License for the specific language governing permissions and 14*b7c941bbSAndroid Build Coastguard Worker * limitations under the License. 15*b7c941bbSAndroid Build Coastguard Worker */ 16*b7c941bbSAndroid Build Coastguard Worker 17*b7c941bbSAndroid Build Coastguard Worker #ifndef MEGA_PLAYER_AUDIOSOURCE_H 18*b7c941bbSAndroid Build Coastguard Worker #define MEGA_PLAYER_AUDIOSOURCE_H 19*b7c941bbSAndroid Build Coastguard Worker 20*b7c941bbSAndroid Build Coastguard Worker class AudioSource { 21*b7c941bbSAndroid Build Coastguard Worker public: AudioSource()22*b7c941bbSAndroid Build Coastguard Worker AudioSource() {} ~AudioSource()23*b7c941bbSAndroid Build Coastguard Worker virtual ~AudioSource() {} 24*b7c941bbSAndroid Build Coastguard Worker 25*b7c941bbSAndroid Build Coastguard Worker static const int NUMCHANNELS_UNSPECIFIED = -1; 26*b7c941bbSAndroid Build Coastguard Worker static const int NUMCHANNELS_ERROR = -2; getNumChannels()27*b7c941bbSAndroid Build Coastguard Worker virtual int getNumChannels() { return NUMCHANNELS_UNSPECIFIED; } 28*b7c941bbSAndroid Build Coastguard Worker 29*b7c941bbSAndroid Build Coastguard Worker // Encoding Constants (specific to MegaAudio) 30*b7c941bbSAndroid Build Coastguard Worker static const int ENCODING_UNSPECIFIED = -1; 31*b7c941bbSAndroid Build Coastguard Worker static const int ENCODING_ERROR = -2; 32*b7c941bbSAndroid Build Coastguard Worker static const int ENCODING_UNINITIALIZED = 0; 33*b7c941bbSAndroid Build Coastguard Worker static const int ENCODING_FLOAT = 1; 34*b7c941bbSAndroid Build Coastguard Worker static const int ENCODING_PCM16 = 2; 35*b7c941bbSAndroid Build Coastguard Worker static const int ENCODING_PCM24 = 3; 36*b7c941bbSAndroid Build Coastguard Worker static const int ENCODING_PCM32 = 4; getEncoding()37*b7c941bbSAndroid Build Coastguard Worker virtual int getEncoding() { return ENCODING_UNSPECIFIED; }; 38*b7c941bbSAndroid Build Coastguard Worker 39*b7c941bbSAndroid Build Coastguard Worker /** 40*b7c941bbSAndroid Build Coastguard Worker * Called before the stream starts to allow initialization of the source 41*b7c941bbSAndroid Build Coastguard Worker * @param numFrames The number of frames that will be requested in each pull() call. 42*b7c941bbSAndroid Build Coastguard Worker * @param numChans The number of channels in the stream. 43*b7c941bbSAndroid Build Coastguard Worker */ init(int numFrames,int numChans)44*b7c941bbSAndroid Build Coastguard Worker virtual void init(int numFrames, int numChans) {} 45*b7c941bbSAndroid Build Coastguard Worker setSampleRate(int sampleRate)46*b7c941bbSAndroid Build Coastguard Worker virtual void setSampleRate(int sampleRate) {} 47*b7c941bbSAndroid Build Coastguard Worker setFreq(float freq)48*b7c941bbSAndroid Build Coastguard Worker virtual void setFreq(float freq) {} 49*b7c941bbSAndroid Build Coastguard Worker 50*b7c941bbSAndroid Build Coastguard Worker /** 51*b7c941bbSAndroid Build Coastguard Worker * Reset the stream to its beginning 52*b7c941bbSAndroid Build Coastguard Worker */ reset()53*b7c941bbSAndroid Build Coastguard Worker virtual void reset() {} 54*b7c941bbSAndroid Build Coastguard Worker trigger()55*b7c941bbSAndroid Build Coastguard Worker virtual void trigger() {} 56*b7c941bbSAndroid Build Coastguard Worker 57*b7c941bbSAndroid Build Coastguard Worker /** 58*b7c941bbSAndroid Build Coastguard Worker * Process a request for audio data. 59*b7c941bbSAndroid Build Coastguard Worker * @param audioData The buffer to be filled. 60*b7c941bbSAndroid Build Coastguard Worker * @param numFrames The number of frames of audio to provide. 61*b7c941bbSAndroid Build Coastguard Worker * @param numChans The number of channels (in the buffer) required by the player. 62*b7c941bbSAndroid Build Coastguard Worker * @return The number of frames actually generated. If this value is less than that 63*b7c941bbSAndroid Build Coastguard Worker * requested, it may be interpreted by the player as the end of playback. 64*b7c941bbSAndroid Build Coastguard Worker * Note that the player will be blocked by this call. 65*b7c941bbSAndroid Build Coastguard Worker * Note that the data is assumed to be *interleaved*. 66*b7c941bbSAndroid Build Coastguard Worker */ 67*b7c941bbSAndroid Build Coastguard Worker virtual int pull(float* buffer, int numFrames, int numChans) = 0; 68*b7c941bbSAndroid Build Coastguard Worker }; 69*b7c941bbSAndroid Build Coastguard Worker 70*b7c941bbSAndroid Build Coastguard Worker #endif // MEGA_PLAYER_AUDIOSOURCE_H 71