Index: media/base/android/media_codec_decoder.h |
diff --git a/media/base/android/media_codec_decoder.h b/media/base/android/media_codec_decoder.h |
deleted file mode 100644 |
index 5e64932e2061f9f1ce01f7cf5f63057f78c81dc7..0000000000000000000000000000000000000000 |
--- a/media/base/android/media_codec_decoder.h |
+++ /dev/null |
@@ -1,283 +0,0 @@ |
-// 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; |
- |
-// The decoder for MediaCodecPlayer. |
-// This class accepts the incoming data into AccessUnitQueue and works with |
-// MediaCodecBridge for decoding and rendering the frames. The MediaCodecPlayer |
-// has two decoder objects: audio and video. |
-// |
-// The decoder works on two threads. The data from demuxer comes on Media |
-// thread. The commands from MediaCodecPlayer, such as Prefetch, Start, |
-// RequestToStop also come on the Media thread. The operations with MediaCodec |
-// buffers and rendering happen on a separate thread called Decoder thread. |
-// This class creates, starts and stops it as necessary. |
-// |
-// Decoder's internal state machine goes through the following states: |
-// |
-// [ Stopped ] <------------------- (any state except Error) |
-// | | | |
-// | Prefetch |--- internal ------| |
-// v | transition v |
-// [ Prefetching ] | [ Error ] |
-// | | |
-// | internal transition | |
-// v | Error recovery: |
-// [ Prefetched ] | |
-// | | (any state including Error) |
-// | Start | | |
-// v | | ReleaseDecoderResources |
-// [ Running ] | v |
-// | | [ Stopped ] |
-// | RequestToStop | |
-// v | |
-// [ Stopping ] ------------------- |
-// |
-// |
-// [ Stopped ] -------------------- |
-// ^ | |
-// | Flush | |
-// --------------------------- |
- |
-class MediaCodecDecoder { |
- public: |
- // The result of MediaCodec configuration, used by MediaCodecPlayer. |
- enum ConfigStatus { |
- CONFIG_FAILURE = 0, |
- CONFIG_OK, |
- CONFIG_KEY_FRAME_REQUIRED, |
- }; |
- |
- // The decoder reports current playback time to the MediaCodecPlayer. |
- // For audio, the parameters designate the beginning and end of a time |
- // interval. The beginning is the estimated time that is playing right now. |
- // The end is the playback time of the last buffered data. During normal |
- // playback the subsequent intervals overlap. |
- // For video both values are PTS of the corresponding frame, i.e. the interval |
- // has zero width. |
- typedef base::Callback<void(base::TimeDelta, base::TimeDelta)> |
- SetTimeCallback; |
- |
- // MediaCodecDecoder constructor. |
- // Parameters: |
- // media_task_runner: |
- // A task runner for the controlling thread. All public methods should be |
- // called on this thread, and callbacks are delivered on this thread. |
- // The MediaCodecPlayer uses a dedicated (Media) thread for this. |
- // request_data_cb: |
- // Called periodically as the amount of internally stored data decreased. |
- // The receiver should call OnDemuxerDataAvailable() with more data. |
- // starvation_cb: |
- // Called when starvation is detected. The decoder state does not change. |
- // The player is supposed to stop and then prefetch the decoder. |
- // stop_done_cb: |
- // Called when async stop request is completed. |
- // error_cb: |
- // Called when a MediaCodec error occurred. If this happens, a player has |
- // to either call ReleaseDecoderResources() or destroy the decoder object. |
- // decoder_thread_name: |
- // The thread name to be passed to decoder thread constructor. |
- MediaCodecDecoder( |
- const scoped_refptr<base::SingleThreadTaskRunner>& media_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; |
- |
- // MediaCodecDecoder exists through the whole lifetime of the player |
- // to support dynamic addition and removal of the streams. |
- // This method returns true if the current stream (audio or video) |
- // is currently active. |
- virtual bool HasStream() const = 0; |
- |
- // Stores configuration for the use of upcoming Configure() |
- virtual void SetDemuxerConfigs(const DemuxerConfigs& configs) = 0; |
- |
- // Stops decoder thread, releases the MediaCodecBridge and other resources. |
- virtual void ReleaseDecoderResources(); |
- |
- // Flushes the MediaCodec and resets the AccessUnitQueue. |
- // Decoder thread should not be running. |
- virtual void Flush(); |
- |
- // Releases MediaCodecBridge. |
- void ReleaseMediaCodec(); |
- |
- // Returns corresponding conditions. |
- bool IsPrefetchingOrPlaying() const; |
- bool IsStopped() const; |
- bool IsCompleted() const; |
- |
- base::android::ScopedJavaLocalRef<jobject> GetMediaCrypto(); |
- |
- // Starts prefetching: accumulates enough data in AccessUnitQueue. |
- // Decoder thread is not running. |
- void Prefetch(const base::Closure& prefetch_done_cb); |
- |
- // Configures MediaCodec. |
- ConfigStatus Configure(); |
- |
- // Starts the decoder thread and resumes the playback. |
- bool Start(base::TimeDelta current_time); |
- |
- // Stops the playback process synchronously. This method stops the decoder |
- // thread synchronously, and then releases all MediaCodec buffers. |
- void SyncStop(); |
- |
- // Requests to stop the playback and returns. |
- // Decoder will stop asynchronously after all the dequeued output buffers |
- // are rendered. |
- void RequestToStop(); |
- |
- // Notification posted when asynchronous stop is done or playback completed. |
- void OnLastFrameRendered(bool completed); |
- |
- // Puts the incoming data into AccessUnitQueue. |
- void OnDemuxerDataAvailable(const DemuxerData& data); |
- |
- protected: |
- // Returns true if the new DemuxerConfigs requires MediaCodec |
- // reconfiguration. |
- virtual bool IsCodecReconfigureNeeded(const DemuxerConfigs& curr, |
- const DemuxerConfigs& next) const = 0; |
- |
- // Does the part of MediaCodecBridge configuration that is specific |
- // to audio or video. |
- virtual ConfigStatus ConfigureInternal() = 0; |
- |
- // Associates PTS with device time so we can calculate delays. |
- // We use delays for video decoder only. |
- virtual void SynchronizePTSWithTime(base::TimeDelta current_time) {} |
- |
- // Processes the change of the output format, varies by stream. |
- virtual void OnOutputFormatChanged() = 0; |
- |
- // Renders the decoded frame and releases output buffer, or posts |
- // a delayed task to do it at a later time, |
- virtual void Render(int buffer_index, |
- size_t size, |
- bool render_output, |
- base::TimeDelta pts, |
- bool eos_encountered) = 0; |
- |
- // Returns the number of delayed task (we might have them for video). |
- virtual int NumDelayedRenderTasks() const; |
- |
- // Releases output buffers that are dequeued and not released yet |
- // because their rendering is delayed (video). |
- virtual void ReleaseDelayedBuffers() {} |
- |
- // Helper methods. |
- |
- // Notifies the decoder if the frame is the last one. |
- void CheckLastFrame(bool eos_encountered, bool has_delayed_tasks); |
- |
- // Protected data. |
- |
- // Object for posting tasks on Media thread. |
- scoped_refptr<base::SingleThreadTaskRunner> media_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_; |
- |
- // The queue of access units. |
- AccessUnitQueue au_queue_; |
- |
- private: |
- enum DecoderState { |
- kStopped = 0, |
- kPrefetching, |
- kPrefetched, |
- kRunning, |
- kStopping, |
- kError, |
- }; |
- |
- // Helper method that processes an error from MediaCodec. |
- void OnCodecError(); |
- |
- // Prefetching callback that is posted to Media thread |
- // in the kPrefetching state. |
- void PrefetchNextChunk(); |
- |
- // The callback to do actual playback. Posted to Decoder thread |
- // in the kRunning state. |
- void ProcessNextFrame(); |
- |
- // Helper method for ProcessNextFrame. |
- // Pushes one input buffer to the MediaCodec if the codec can accept it. |
- // Returns false if there was MediaCodec error. |
- bool EnqueueInputBuffer(); |
- |
- // Helper method for ProcessNextFrame. |
- // Pulls all currently available output frames and renders them. |
- // Returns false if there was MediaCodec error. |
- bool DepleteOutputBufferQueue(bool* eos_encountered); |
- |
- DecoderState GetState() const; |
- void SetState(DecoderState state); |
- const char* AsString(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_; |
- |
- // Callback used to post OnCodecError method. |
- base::Closure internal_error_cb_; |
- |
- // Internal state. |
- DecoderState state_; |
- mutable base::Lock state_lock_; |
- |
- // Flag is set when the EOS is enqueued into MediaCodec. Reset by Flush. |
- bool eos_enqueued_; |
- |
- // Flag is set when the EOS is received in MediaCodec output. Reset by Flush. |
- bool completed_; |
- |
- // Flag to ensure we post last frame notification once. |
- bool last_frame_posted_; |
- |
- // 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_ |