OLD | NEW |
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_ | 5 #ifndef MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_ |
6 #define MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_ | 6 #define MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_ |
7 | 7 |
8 #include "base/android/scoped_java_ref.h" | 8 #include "base/android/scoped_java_ref.h" |
9 #include "base/callback.h" | 9 #include "base/callback.h" |
10 #include "base/macros.h" | 10 #include "base/macros.h" |
11 #include "base/memory/ref_counted.h" | 11 #include "base/memory/ref_counted.h" |
12 #include "base/memory/scoped_ptr.h" | 12 #include "base/memory/scoped_ptr.h" |
13 #include "base/single_thread_task_runner.h" | 13 #include "base/single_thread_task_runner.h" |
14 #include "base/synchronization/lock.h" | 14 #include "base/synchronization/lock.h" |
15 #include "base/threading/thread.h" | 15 #include "base/threading/thread.h" |
16 #include "base/time/time.h" | 16 #include "base/time/time.h" |
17 #include "media/base/android/access_unit_queue.h" | 17 #include "media/base/android/access_unit_queue.h" |
18 #include "media/base/android/demuxer_stream_player_params.h" | 18 #include "media/base/android/demuxer_stream_player_params.h" |
19 | 19 |
20 namespace media { | 20 namespace media { |
21 | 21 |
| 22 struct FrameStatistics; |
22 class MediaCodecBridge; | 23 class MediaCodecBridge; |
23 | 24 |
24 // The decoder for MediaCodecPlayer. | 25 // The decoder for MediaCodecPlayer. |
25 // This class accepts the incoming data into AccessUnitQueue and works with | 26 // This class accepts the incoming data into AccessUnitQueue and works with |
26 // MediaCodecBridge for decoding and rendering the frames. The MediaCodecPlayer | 27 // MediaCodecBridge for decoding and rendering the frames. The MediaCodecPlayer |
27 // has two decoder objects: audio and video. | 28 // has two decoder objects: audio and video. |
28 // | 29 // |
29 // The decoder works on two threads. The data from demuxer comes on Media | 30 // The decoder works on two threads. The data from demuxer comes on Media |
30 // thread. The commands from MediaCodecPlayer, such as Prefetch, Start, | 31 // thread. The commands from MediaCodecPlayer, such as Prefetch, Start, |
31 // RequestToStop also come on the Media thread. The operations with MediaCodec | 32 // RequestToStop also come on the Media thread. The operations with MediaCodec |
(...skipping 98 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
130 // has zero width. | 131 // has zero width. |
131 // The third parameter means "postpone", it is set to true if the actual | 132 // The third parameter means "postpone", it is set to true if the actual |
132 // rendering will start in a later point in time. This only happens with | 133 // rendering will start in a later point in time. This only happens with |
133 // audio after preroll. The MediaCodecPlayer might decide to update the | 134 // audio after preroll. The MediaCodecPlayer might decide to update the |
134 // current time but not pass it to the upper layer. | 135 // current time but not pass it to the upper layer. |
135 typedef base::Callback<void(base::TimeDelta, base::TimeDelta, bool)> | 136 typedef base::Callback<void(base::TimeDelta, base::TimeDelta, bool)> |
136 SetTimeCallback; | 137 SetTimeCallback; |
137 | 138 |
138 // MediaCodecDecoder constructor. | 139 // MediaCodecDecoder constructor. |
139 // Parameters: | 140 // Parameters: |
| 141 // decoder_thread_name: |
| 142 // The thread name to be passed to decoder thread constructor. |
140 // media_task_runner: | 143 // media_task_runner: |
141 // A task runner for the controlling thread. All public methods should be | 144 // A task runner for the controlling thread. All public methods should be |
142 // called on this thread, and callbacks are delivered on this thread. | 145 // called on this thread, and callbacks are delivered on this thread. |
143 // The MediaCodecPlayer uses a dedicated (Media) thread for this. | 146 // The MediaCodecPlayer uses a dedicated (Media) thread for this. |
| 147 // frame_statistics: |
| 148 // A pointer to FrameStatistics object which gathers playback quality |
| 149 // related data. |
144 // external_request_data_cb: | 150 // external_request_data_cb: |
145 // Called periodically as the amount of internally stored data decreases. | 151 // Called periodically as the amount of internally stored data decreases. |
146 // The receiver should call OnDemuxerDataAvailable() with more data. | 152 // The receiver should call OnDemuxerDataAvailable() with more data. |
147 // starvation_cb: | 153 // starvation_cb: |
148 // Called when starvation is detected. The decoder state does not change. | 154 // Called when starvation is detected. The decoder state does not change. |
149 // The player is supposed to stop and then prefetch the decoder. | 155 // The player is supposed to stop and then prefetch the decoder. |
150 // decoder_drained_cb: | 156 // decoder_drained_cb: |
151 // Called when decoder is drained for reconfiguration. | 157 // Called when decoder is drained for reconfiguration. |
152 // stop_done_cb: | 158 // stop_done_cb: |
153 // Called when async stop request is completed. | 159 // Called when async stop request is completed. |
154 // waiting_for_decryption_key_cb: | 160 // waiting_for_decryption_key_cb: |
155 // Will be executed whenever the key needed to decrypt the stream is not | 161 // Will be executed whenever the key needed to decrypt the stream is not |
156 // available. | 162 // available. |
157 // error_cb: | 163 // error_cb: |
158 // Called when a MediaCodec error occurred. If this happens, a player has | 164 // Called when a MediaCodec error occurred. If this happens, a player has |
159 // to either call ReleaseDecoderResources() or destroy the decoder object. | 165 // to either call ReleaseDecoderResources() or destroy the decoder object. |
160 // decoder_thread_name: | |
161 // The thread name to be passed to decoder thread constructor. | |
162 MediaCodecDecoder( | 166 MediaCodecDecoder( |
| 167 const char* decoder_thread_name, |
163 const scoped_refptr<base::SingleThreadTaskRunner>& media_task_runner, | 168 const scoped_refptr<base::SingleThreadTaskRunner>& media_task_runner, |
| 169 FrameStatistics* frame_statistics, |
164 const base::Closure& external_request_data_cb, | 170 const base::Closure& external_request_data_cb, |
165 const base::Closure& starvation_cb, | 171 const base::Closure& starvation_cb, |
166 const base::Closure& decoder_drained_cb, | 172 const base::Closure& decoder_drained_cb, |
167 const base::Closure& stop_done_cb, | 173 const base::Closure& stop_done_cb, |
168 const base::Closure& waiting_for_decryption_key_cb, | 174 const base::Closure& waiting_for_decryption_key_cb, |
169 const base::Closure& error_cb, | 175 const base::Closure& error_cb); |
170 const char* decoder_thread_name); | 176 |
171 virtual ~MediaCodecDecoder(); | 177 virtual ~MediaCodecDecoder(); |
172 | 178 |
173 virtual const char* class_name() const; | 179 virtual const char* class_name() const; |
174 | 180 |
175 // MediaCodecDecoder exists through the whole lifetime of the player | 181 // MediaCodecDecoder exists through the whole lifetime of the player |
176 // to support dynamic addition and removal of the streams. | 182 // to support dynamic addition and removal of the streams. |
177 // This method returns true if the current stream (audio or video) | 183 // This method returns true if the current stream (audio or video) |
178 // is currently active. | 184 // is currently active. |
179 virtual bool HasStream() const = 0; | 185 virtual bool HasStream() const = 0; |
180 | 186 |
(...skipping 122 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
303 // Returns true if we are in the process of sync stop. | 309 // Returns true if we are in the process of sync stop. |
304 bool InEmergencyStop() const { return GetState() == kInEmergencyStop; } | 310 bool InEmergencyStop() const { return GetState() == kInEmergencyStop; } |
305 | 311 |
306 // Notifies the decoder if the frame is the last one. | 312 // Notifies the decoder if the frame is the last one. |
307 void CheckLastFrame(bool eos_encountered, bool has_delayed_tasks); | 313 void CheckLastFrame(bool eos_encountered, bool has_delayed_tasks); |
308 | 314 |
309 const char* AsString(RenderMode render_mode); | 315 const char* AsString(RenderMode render_mode); |
310 | 316 |
311 // Protected data. | 317 // Protected data. |
312 | 318 |
| 319 // We call MediaCodecBridge on this thread for both input and output buffers. |
| 320 base::Thread decoder_thread_; |
| 321 |
313 // Object for posting tasks on Media thread. | 322 // Object for posting tasks on Media thread. |
314 scoped_refptr<base::SingleThreadTaskRunner> media_task_runner_; | 323 scoped_refptr<base::SingleThreadTaskRunner> media_task_runner_; |
315 | 324 |
| 325 // Statistics for UMA. |
| 326 FrameStatistics* frame_statistics_; |
| 327 |
316 // Controls Android MediaCodec | 328 // Controls Android MediaCodec |
317 scoped_ptr<MediaCodecBridge> media_codec_bridge_; | 329 scoped_ptr<MediaCodecBridge> media_codec_bridge_; |
318 | 330 |
319 // We call MediaCodecBridge on this thread for both | |
320 // input and output buffers. | |
321 base::Thread decoder_thread_; | |
322 | |
323 // The queue of access units. | 331 // The queue of access units. |
324 AccessUnitQueue au_queue_; | 332 AccessUnitQueue au_queue_; |
325 | 333 |
326 // Flag forces reconfiguration even if |media_codec_bridge_| exists. Currently | 334 // Flag forces reconfiguration even if |media_codec_bridge_| exists. Currently |
327 // is set by video decoder when the video surface changes. | 335 // is set by video decoder when the video surface changes. |
328 bool needs_reconfigure_; | 336 bool needs_reconfigure_; |
329 | 337 |
330 // Flag forces to drain decoder in the process of dynamic reconfiguration. | 338 // Flag forces to drain decoder in the process of dynamic reconfiguration. |
331 bool drain_decoder_; | 339 bool drain_decoder_; |
332 | 340 |
(...skipping 112 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
445 | 453 |
446 // NOTE: Weak pointers must be invalidated before all other member variables. | 454 // NOTE: Weak pointers must be invalidated before all other member variables. |
447 base::WeakPtrFactory<MediaCodecDecoder> weak_factory_; | 455 base::WeakPtrFactory<MediaCodecDecoder> weak_factory_; |
448 | 456 |
449 DISALLOW_COPY_AND_ASSIGN(MediaCodecDecoder); | 457 DISALLOW_COPY_AND_ASSIGN(MediaCodecDecoder); |
450 }; | 458 }; |
451 | 459 |
452 } // namespace media | 460 } // namespace media |
453 | 461 |
454 #endif // MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_ | 462 #endif // MEDIA_BASE_ANDROID_MEDIA_CODEC_DECODER_H_ |
OLD | NEW |