OLD | NEW |
---|---|
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 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_AUDIO_DECODER_H_ | 5 #ifndef MEDIA_BASE_AUDIO_DECODER_H_ |
6 #define MEDIA_BASE_AUDIO_DECODER_H_ | 6 #define MEDIA_BASE_AUDIO_DECODER_H_ |
7 | 7 |
8 #include "base/callback.h" | 8 #include "base/callback.h" |
9 #include "base/memory/ref_counted.h" | 9 #include "base/memory/ref_counted.h" |
10 #include "media/base/audio_decoder_config.h" | 10 #include "media/base/audio_decoder_config.h" |
11 #include "media/base/channel_layout.h" | 11 #include "media/base/channel_layout.h" |
12 #include "media/base/decoder_buffer.h" | 12 #include "media/base/decoder_buffer.h" |
13 #include "media/base/media_export.h" | 13 #include "media/base/media_export.h" |
14 #include "media/base/pipeline_status.h" | 14 #include "media/base/pipeline_status.h" |
15 | 15 |
16 namespace media { | 16 namespace media { |
17 | 17 |
18 class AudioBuffer; | 18 class AudioBuffer; |
19 class DemuxerStream; | 19 class DemuxerStream; |
20 | 20 |
21 class MEDIA_EXPORT AudioDecoder { | 21 class MEDIA_EXPORT AudioDecoder { |
22 public: | 22 public: |
23 // Status codes for decode operations. | 23 // Status codes for decode operations. |
24 // TODO(rileya): Now that both AudioDecoder and VideoDecoder Status enums | 24 // TODO(rileya): Now that both AudioDecoder and VideoDecoder Status enums |
25 // match, break them into a decoder_status.h. | 25 // match, break them into a decoder_status.h. |
26 enum Status { | 26 enum Status { |
27 kOk, // We're all good. | 27 kOk, // We're all good. |
28 kAborted, // We aborted as a result of Stop() or Reset(). | 28 kAborted, // We aborted as a result of Stop() or Reset(). |
29 kNotEnoughData, // Not enough data to produce a video frame. | |
30 kDecodeError, // A decoding error occurred. | 29 kDecodeError, // A decoding error occurred. |
31 kDecryptError // Decrypting error happened. | 30 kDecryptError // Decrypting error happened. |
32 }; | 31 }; |
33 | 32 |
33 // Callback to return decoded buffers. | |
34 typedef base::Callback<void(const scoped_refptr<AudioBuffer>&)> OutputCB; | |
35 | |
36 // Callback for Decode(). Called after the decoder has completed decoding | |
37 // corresponding DecoderBuffer, indicating that it's ready to accept another | |
38 // buffer to decode. | |
39 typedef base::Callback<void(Status)> DecodeCB; | |
40 | |
34 AudioDecoder(); | 41 AudioDecoder(); |
35 virtual ~AudioDecoder(); | 42 virtual ~AudioDecoder(); |
36 | 43 |
37 // Initializes an AudioDecoder with the given DemuxerStream, executing the | 44 // Initializes an AudioDecoder with the given DemuxerStream, executing the |
38 // callback upon completion. | 45 // callback upon completion. |
39 // statistics_cb is used to update global pipeline statistics. | 46 // |statistics_cb| is used to update global pipeline statistics. |
47 // |output_cb| is called for decoded audio buffers (see Decode()). | |
40 virtual void Initialize(const AudioDecoderConfig& config, | 48 virtual void Initialize(const AudioDecoderConfig& config, |
41 const PipelineStatusCB& status_cb) = 0; | 49 const PipelineStatusCB& status_cb, |
50 const OutputCB& output_cb) = 0; | |
42 | 51 |
43 // Requests samples to be decoded and returned via the provided callback. | 52 // Requests samples to be decoded. Only one decode may be in flight at any |
44 // Only one decode may be in flight at any given time. | 53 // given time. Once the buffer is decoded the decoder calls |decode_cb|. |
54 // |output_cb| specified in Initialize() is called for each decoded buffer, | |
55 // before or after |decode_cb|. | |
45 // | 56 // |
46 // Implementations guarantee that the callback will not be called from within | 57 // Implementations guarantee that the callbacks will not be called from within |
47 // this method. | 58 // this method. |
48 // | 59 // |
49 // Non-NULL sample buffer pointers will contain decoded audio data or may | 60 // Non-NULL sample buffer pointers will contain decoded audio data or may |
50 // indicate the end of the stream. A NULL buffer pointer indicates an aborted | 61 // indicate the end of the stream. A NULL buffer pointer indicates an aborted |
51 // Decode(). | 62 // Decode(). |
xhwang
2014/06/05 21:53:48
This should be consistent with the comment for Vid
Sergey Ulanov
2014/06/06 22:49:39
Done.
| |
52 typedef base::Callback<void(Status, const scoped_refptr<AudioBuffer>&)> | |
53 DecodeCB; | |
54 virtual void Decode(const scoped_refptr<DecoderBuffer>& buffer, | 63 virtual void Decode(const scoped_refptr<DecoderBuffer>& buffer, |
55 const DecodeCB& decode_cb) = 0; | 64 const DecodeCB& decode_cb) = 0; |
56 | 65 |
57 // Some AudioDecoders will queue up multiple AudioBuffers from a single | 66 // Resets decoder state, dropping any queued data. DecodeCB and OutputCB may |
58 // DecoderBuffer, if we have any such queued buffers this will return the next | 67 // still be called for older buffers if they were scheduler before this method |
xhwang
2014/06/05 21:53:48
s/scheduler/scheduled
Sergey Ulanov
2014/06/06 22:49:39
Done.
| |
59 // one. Otherwise we return a NULL AudioBuffer. | 68 // is called. |
60 virtual scoped_refptr<AudioBuffer> GetDecodeOutput(); | |
61 | |
62 // Resets decoder state, dropping any queued encoded data. | |
63 virtual void Reset(const base::Closure& closure) = 0; | 69 virtual void Reset(const base::Closure& closure) = 0; |
64 | 70 |
65 // Stops decoder, fires any pending callbacks and sets the decoder to an | 71 // Stops decoder, fires any pending callbacks and sets the decoder to an |
66 // uninitialized state. An AudioDecoder cannot be re-initialized after it has | 72 // uninitialized state. An AudioDecoder cannot be re-initialized after it has |
67 // been stopped. | 73 // been stopped. DecodeCB and OutputCB may still be called for older buffers |
74 // if they were scheduler before this method is called. | |
xhwang
2014/06/05 21:53:48
s/scheduler/scheduled
Sergey Ulanov
2014/06/06 22:49:39
Done.
| |
68 // Note that if Initialize() is pending or has finished successfully, Stop() | 75 // Note that if Initialize() is pending or has finished successfully, Stop() |
69 // must be called before destructing the decoder. | 76 // must be called before destructing the decoder. |
70 virtual void Stop() = 0; | 77 virtual void Stop() = 0; |
71 | 78 |
72 private: | 79 private: |
73 DISALLOW_COPY_AND_ASSIGN(AudioDecoder); | 80 DISALLOW_COPY_AND_ASSIGN(AudioDecoder); |
74 }; | 81 }; |
75 | 82 |
76 } // namespace media | 83 } // namespace media |
77 | 84 |
78 #endif // MEDIA_BASE_AUDIO_DECODER_H_ | 85 #endif // MEDIA_BASE_AUDIO_DECODER_H_ |
OLD | NEW |