Implementation of MediaCodecPlayer stage 1

media/base/android/media_codec_decoder.h

+// Copyright 2015 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_
+#define MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_
+
+#include "base/android/scoped_java_ref.h"
+#include "base/callback.h"
+#include "base/macros.h"
+#include "base/memory/ref_counted.h"
+#include "base/memory/scoped_ptr.h"
+#include "base/single_thread_task_runner.h"
+#include "base/synchronization/lock.h"
+#include "base/threading/thread.h"
+#include "base/time/time.h"
+#include "media/base/android/access_unit_queue.h"
+#include "media/base/android/demuxer_stream_player_params.h"
+
+namespace media {
+
+class MediaCodecBridge;
+
+enum DecoderState {
+  STOPPED = 0,
+  PREFETCHING,
+  RUNNING,
+  STOPPING
+};
+
+class MediaCodecDecoder {

[qinmin, 2015/05/14 17:54:07]

Class descriptions, and for all the member function/variables below

[Tima Vaisburd, 2015/05/15 00:12:39]

I need to thank you, while doing this I did some cleanup.
I added a bunch of text.

+ public:
+

[qinmin, 2015/05/14 17:54:07]

nit: remove empty line 

[Tima Vaisburd, 2015/05/15 00:12:39]

Done.

+  enum ConfigStatus {
+    CONFIG_FAILURE = 0,
+    CONFIG_OK,
+    CONFIG_KEY_FRAME_REQUIRED,
+  };
+
+  typedef base::Callback<void(base::TimeDelta, base::TimeDelta)>

[qinmin, 2015/05/14 17:54:07]

Descriptions

[Tima Vaisburd, 2015/05/15 00:12:39]

Done.

+      SetTimeCallback;
+
+  MediaCodecDecoder(
+      const scoped_refptr<base::SingleThreadTaskRunner>& media_task_runner,
+      const scoped_refptr<base::SingleThreadTaskRunner>& ui_task_runner,
+      const base::Closure& request_data_cb,
+      const base::Closure& starvation_cb,
+      const base::Closure& stop_done_cb,
+      const base::Closure& error_cb,
+      const char* decoder_thread_name);
+  virtual ~MediaCodecDecoder();
+
+  virtual const char* class_name() const { return "Decoder"; }
+
+  virtual bool HasStream() const = 0;
+  virtual void ReleaseDecoderResources();
+  virtual void Flush();
+
+  void ReleaseMediaCodec();
+
+  bool IsPrefetchingOrPlaying() const;
+  bool IsStopped() const;
+  bool IsCompleted() const;
+
+  void SetDemuxerConfigs(const DemuxerConfigs& configs);
+
+  base::android::ScopedJavaLocalRef<jobject> GetMediaCrypto();
+
+  void Prefetch(const base::Closure& prefetch_done_cb);
+  ConfigStatus Configure();
+  bool Start(base::TimeDelta current_time);
+  void SyncStop();
+  void RequestToStop();
+
+  void OnDemuxerDataAvailable(const DemuxerData& data);
+
+  void OnLastFrameRendered(bool completed);
+
+ protected:
+  virtual bool IsCodecReconfigureNeeded(const DemuxerConfigs& curr,
+                                        const DemuxerConfigs& next) const = 0;
+  virtual ConfigStatus ConfigureInternal() = 0;
+  virtual void SynchronizePTSWithTime(base::TimeDelta current_time) {}
+
+  virtual void Render(int buffer_index, size_t size, bool render_output,
+                      base::TimeDelta pts, bool eos_encountered) = 0;
+  virtual int NumDelayedRenderTasks() const { return 0; }
+  virtual void ReleaseDelayedBuffers() {}
+
+  void ProcessLastFrame(bool eos_encountered, bool has_delayed_tasks);
+
+  // Protected data.
+
+  // Object for posting tasks on Media thread.
+  scoped_refptr<base::SingleThreadTaskRunner> media_task_runner_;
+
+  // Object for posting tasks on UI thread.
+  scoped_refptr<base::SingleThreadTaskRunner> ui_task_runner_;
+
+  // Controls Android MediaCodec
+  scoped_ptr<MediaCodecBridge> media_codec_bridge_;
+
+  // We call MediaCodecBridge on this thread for both
+  // input and output buffers.
+  base::Thread decoder_thread_;
+
+  // Configuration received from demuxer
+  DemuxerConfigs configs_;
+  mutable base::Lock configs_lock_;
+
+  // The queue of access units.
+  AccessUnitQueue au_queue_;
+
+ private:
+  void PrefetchNextChunk();
+  void ProcessNextFrame();
+
+  // Returns false if there was MediaCodec error.
+  bool EnqueueInputBuffer(DecoderState state);
+
+  // Returns false if there was MediaCodec error.
+  bool DepleteOutputBufferQueue(DecoderState state, bool* eos_encountered);
+
+  DecoderState GetState() const;
+  void SetState(DecoderState state);
+
+  // Private Data.
+
+  // Callback used to request more data.
+  base::Closure request_data_cb_;
+
+  // These notifications are called on corresponding conditions  .
+  base::Closure prefetch_done_cb_;
+  base::Closure starvation_cb_;
+  base::Closure stop_done_cb_;
+  base::Closure error_cb_;
+
+  DecoderState state_;
+  mutable base::Lock state_lock_;
+
+  // Flag is set when the EOS is enqueued into MediaCodec.
+  bool eos_enqueued_;
+
+  // Flag is set when the EOS is received in MediaCodec output.
+  bool completed_;
+
+  // Flag to ensure we post last frame notification once.
+  bool last_frame_posted_;
+
+  base::WeakPtr<MediaCodecDecoder> weak_this_;
+  // NOTE: Weak pointers must be invalidated before all other member variables.
+  base::WeakPtrFactory<MediaCodecDecoder> weak_factory_;
+
+  DISALLOW_COPY_AND_ASSIGN(MediaCodecDecoder);
+};
+
+}  // namespace media
+
+#endif  // MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_