wilhelm/src/android/android_AudioSfDecoder.h

   1 /*
   2  * Copyright (C) 2011 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 <media/stagefright/DataSource.h>
  18 #include <media/stagefright/MediaSource.h>
  19 #include <media/stagefright/FileSource.h>
  20 #include <media/stagefright/MediaDefs.h>
  21 #include <media/stagefright/MediaExtractor.h>
  22 #include <media/stagefright/MetaData.h>
  23 #include <media/stagefright/OMXClient.h>
  24 #include <media/stagefright/OMXCodec.h>
  25 #include "NuCachedSource2.h"
  26 #include "NuHTTPDataSource.h"
  27 #include "ThrottledSource.h"
  28
  29 #include "android_GenericPlayer.h"
  30 #include "OpenSLES_AndroidMetadata.h"
  31
  32 //--------------------------------------------------------------------------------------------------
  33 namespace android {
  34
  35 // to keep in sync with the ANDROID_KEY_INDEX_PCMFORMAT_* constants in android_AudioSfDecoder.cpp
  36 static const char* const kPcmDecodeMetadataKeys[] = {
  37         ANDROID_KEY_PCMFORMAT_NUMCHANNELS, ANDROID_KEY_PCMFORMAT_SAMPLESPERSEC,
  38         ANDROID_KEY_PCMFORMAT_BITSPERSAMPLE, ANDROID_KEY_PCMFORMAT_CONTAINERSIZE,
  39         ANDROID_KEY_PCMFORMAT_CHANNELMASK, ANDROID_KEY_PCMFORMAT_ENDIANNESS };
  40 #define NB_PCMMETADATA_KEYS (sizeof(kPcmDecodeMetadataKeys)/sizeof(kPcmDecodeMetadataKeys[0]))
  41
  42 class AudioSfDecoder : public GenericPlayer
  43 {
  44 public:
  45
  46     AudioSfDecoder(const AudioPlayback_Parameters* params);
  47     virtual ~AudioSfDecoder();
  48
  49     virtual void preDestroy();
  50
  51     // overridden from GenericPlayer
  52     virtual void play();
  53
  54     void startPrefetch_async();
  55
  56     uint32_t getPcmFormatKeyCount();
  57     bool     getPcmFormatKeySize(uint32_t index, uint32_t* pKeySize);
  58     bool     getPcmFormatKeyName(uint32_t index, uint32_t keySize, char* keyName);
  59     bool     getPcmFormatValueSize(uint32_t index, uint32_t* pValueSize);
  60     bool     getPcmFormatKeyValue(uint32_t index, uint32_t size, uint32_t* pValue);
  61
  62 protected:
  63
  64     enum {
  65         kWhatDecode       = 'deco',
  66         kWhatRender       = 'rend',
  67         kWhatCheckCache   = 'cach',
  68         kWhatGetPcmFormat = 'gpcm'
  69     };
  70
  71     // Async event handlers (called from the AudioSfDecoder's event loop)
  72     void onDecode();
  73     void onCheckCache(const sp<AMessage> &msg);
  74     virtual void onRender();
  75
  76     // Async event handlers (called from GenericPlayer's event loop)
  77     virtual void onPrepare();
  78     virtual void onPlay();
  79     virtual void onPause();
  80     virtual void onSeek(const sp<AMessage> &msg);
  81     virtual void onLoop(const sp<AMessage> &msg);
  82     virtual void onGetPcmFormatKeyCount();
  83
  84     // overridden from GenericPlayer
  85     virtual void onNotify(const sp<AMessage> &msg);
  86     virtual void onMessageReceived(const sp<AMessage> &msg);
  87
  88     // to be implemented by subclasses of AudioSfDecoder to do something with the audio samples
  89     virtual void createAudioSink() = 0;
  90     virtual void updateAudioSink() = 0;
  91     virtual void startAudioSink() = 0;
  92     virtual void pauseAudioSink() = 0;
  93
  94     sp<DataSource>  mDataSource; // where the raw data comes from
  95     sp<MediaSource> mAudioSource;// the decoder reading from the data source
  96     // used to indicate mAudioSource was successfully started, but wasn't stopped
  97     bool            mAudioSourceStarted;
  98
  99     // negative values indicate invalid value
 100     int64_t mBitrate;  // in bits/sec
 101     uint32_t mChannelMask;
 102     int64_t mDurationUsec;
 103
 104     // buffer passed from decoder to renderer
 105     MediaBuffer *mDecodeBuffer;
 106
 107     // mutex used to protect the decode buffer, the audio source and its running state
 108     Mutex       mBufferSourceLock;
 109
 110 private:
 111
 112     void notifyPrepared(status_t prepareRes);
 113
 114     int64_t mTimeDelta;
 115     int64_t mSeekTimeMsec;
 116     int64_t mLastDecodedPositionUs;
 117
 118     // mutex used for seek flag and seek time read/write
 119     Mutex mSeekLock;
 120
 121     // informations that can be retrieved in the PCM format queries
 122     //  these values are only written in the event loop
 123     uint32_t mPcmFormatKeyCount;
 124     uint32_t mPcmFormatValues[NB_PCMMETADATA_KEYS];
 125     // for synchronous "get" calls on the PCM decode format:
 126     //    prevents concurrent "getPcmFormat" calls
 127     Mutex       mGetPcmFormatLockSingleton;
 128     //    lock order 1/ mGetPcmFormatLockSingleton  2/ mGetPcmFormatLock
 129     Mutex       mGetPcmFormatLock;
 130     Condition   mGetPcmFormatCondition;
 131     bool        mGetPcmFormatKeyCount;
 132
 133     bool wantPrefetch();
 134     CacheStatus_t getCacheRemaining(bool *eos);
 135     int64_t getPositionUsec();
 136
 137 private:
 138     DISALLOW_EVIL_CONSTRUCTORS(AudioSfDecoder);
 139
 140 };
 141
 142 } // namespace android