xref: /aosp_15_r20/cts/apps/CtsVerifier/jni/megaaudio/player/AudioSource.h (revision b7c941bb3fa97aba169d73cee0bed2de8ac964bf)
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