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     // overridden from GenericPlayer
  50     virtual void play();
  51
  52     void startPrefetch_async();
  53
  54     uint32_t getPcmFormatKeyCount();
  55     bool     getPcmFormatKeySize(uint32_t index, uint32_t* pKeySize);
  56     bool     getPcmFormatKeyName(uint32_t index, uint32_t keySize, char* keyName);
  57     bool     getPcmFormatValueSize(uint32_t index, uint32_t* pValueSize);
  58     bool     getPcmFormatKeyValue(uint32_t index, uint32_t size, uint32_t* pValue);
  59
  60 protected:
  61
  62     enum {
  63         kWhatDecode       = 'deco',
  64         kWhatRender       = 'rend',
  65         kWhatCheckCache   = 'cach',
  66         kWhatGetPcmFormat = 'gpcm'
  67     };
  68
  69     // Async event handlers (called from the AudioSfDecoder's event loop)
  70     void onDecode();
  71     void onCheckCache(const sp<AMessage> &msg);
  72     virtual void onRender();
  73
  74     // Async event handlers (called from GenericPlayer's event loop)
  75     virtual void onPrepare();
  76     virtual void onPlay();
  77     virtual void onPause();
  78     virtual void onSeek(const sp<AMessage> &msg);
  79     virtual void onLoop(const sp<AMessage> &msg);
  80     virtual void onGetPcmFormatKeyCount();
  81
  82     // overridden from GenericPlayer
  83     virtual void onNotify(const sp<AMessage> &msg);
  84     virtual void onMessageReceived(const sp<AMessage> &msg);
  85
  86     // to be implemented by subclasses of AudioSfDecoder to do something with the audio samples
  87     virtual void createAudioSink() = 0;
  88     virtual void updateAudioSink() = 0;
  89     virtual void startAudioSink() = 0;
  90     virtual void pauseAudioSink() = 0;
  91
  92     sp<DataSource> mDataSource;
  93     sp<MediaSource> mAudioSource;
  94
  95     // negative values indicate invalid value
  96     int64_t mBitrate;  // in bits/sec
  97     uint32_t mChannelMask;
  98     int64_t mDurationUsec;
  99
 100     // buffer passed from decoder to renderer
 101     MediaBuffer *mDecodeBuffer;
 102     // mutex used to protect the decode buffer
 103     Mutex       mDecodeBufferLock;
 104
 105 private:
 106
 107     void notifyPrepared(status_t prepareRes);
 108
 109     int64_t mTimeDelta;
 110     int64_t mSeekTimeMsec;
 111     int64_t mLastDecodedPositionUs;
 112
 113     // mutex used for seek flag and seek time read/write
 114     Mutex mSeekLock;
 115
 116     // informations that can be retrieved in the PCM format queries
 117     //  these values are only written in the event loop
 118     uint32_t mPcmFormatKeyCount;
 119     uint32_t mPcmFormatValues[NB_PCMMETADATA_KEYS];
 120     // for synchronous "get" calls on the PCM decode format:
 121     //    prevents concurrent "getPcmFormat" calls
 122     Mutex       mGetPcmFormatLockSingleton;
 123     //    lock order 1/ mGetPcmFormatLockSingleton  2/ mGetPcmFormatLock
 124     Mutex       mGetPcmFormatLock;
 125     Condition   mGetPcmFormatCondition;
 126     bool        mGetPcmFormatKeyCount;
 127
 128     bool wantPrefetch();
 129     CacheStatus_t getCacheRemaining(bool *eos);
 130     int64_t getPositionUsec();
 131
 132 private:
 133     DISALLOW_EVIL_CONSTRUCTORS(AudioSfDecoder);
 134
 135 };
 136
 137 } // namespace android