1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
// Copyright (c) 2013 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_FILTERS_VIDEO_FRAME_STREAM_H_
#define MEDIA_FILTERS_VIDEO_FRAME_STREAM_H_
#include "base/basictypes.h"
#include "base/callback.h"
#include "base/compiler_specific.h"
#include "base/memory/ref_counted.h"
#include "base/memory/scoped_vector.h"
#include "base/memory/weak_ptr.h"
#include "media/base/decryptor.h"
#include "media/base/demuxer_stream.h"
#include "media/base/media_export.h"
#include "media/base/pipeline_status.h"
#include "media/base/video_decoder.h"
namespace base {
class MessageLoopProxy;
}
namespace media {
class DecryptingDemuxerStream;
class VideoDecoderSelector;
// Wraps a DemuxerStream and a list of VideoDecoders and provides decoded
// VideoFrames to its client (e.g. VideoRendererBase).
class MEDIA_EXPORT VideoFrameStream {
public:
// Indicates completion of VideoFrameStream initialization.
typedef base::Callback<void(bool success, bool has_alpha)> InitCB;
enum Status {
OK, // Everything went as planned.
ABORTED, // Read aborted due to Reset() during pending read.
DEMUXER_READ_ABORTED, // Demuxer returned aborted read.
DECODE_ERROR, // Decoder returned decode error.
DECRYPT_ERROR // Decoder returned decrypt error.
};
// Indicates completion of a VideoFrameStream read.
typedef base::Callback<void(Status, const scoped_refptr<VideoFrame>&)> ReadCB;
VideoFrameStream(const scoped_refptr<base::MessageLoopProxy>& message_loop,
ScopedVector<VideoDecoder> decoders,
const SetDecryptorReadyCB& set_decryptor_ready_cb);
virtual ~VideoFrameStream();
// Initializes the VideoFrameStream and returns the initialization result
// through |init_cb|. Note that |init_cb| is always called asynchronously.
void Initialize(DemuxerStream* stream,
const StatisticsCB& statistics_cb,
const InitCB& init_cb);
// Reads a decoded VideoFrame and returns it via the |read_cb|. Note that
// |read_cb| is always called asynchronously. This method should only be
// called after initialization has succeeded and must not be called during
// any pending Reset() and/or Stop().
void Read(const ReadCB& read_cb);
// Resets the decoder, flushes all decoded frames and/or internal buffers,
// fires any existing pending read callback and calls |closure| on completion.
// Note that |closure| is always called asynchronously. This method should
// only be called after initialization has succeeded and must not be called
// during any pending Reset() and/or Stop().
void Reset(const base::Closure& closure);
// Stops the decoder, fires any existing pending read callback or reset
// callback and calls |closure| on completion. Note that |closure| is always
// called asynchronously. The VideoFrameStream cannot be used anymore after
// it is stopped. This method can be called at any time but not during another
// pending Stop().
void Stop(const base::Closure& closure);
// Returns true if the decoder currently has the ability to decode and return
// a VideoFrame.
bool CanReadWithoutStalling() const;
private:
enum State {
STATE_UNINITIALIZED,
STATE_INITIALIZING,
STATE_NORMAL, // Includes idle, pending decoder decode/reset/stop.
STATE_FLUSHING_DECODER,
STATE_PENDING_DEMUXER_READ,
STATE_REINITIALIZING_DECODER,
STATE_STOPPED,
STATE_ERROR
};
// Called when |decoder_selector| selected the |selected_decoder|.
// |decrypting_demuxer_stream| was also populated if a DecryptingDemuxerStream
// is created to help decrypt the encrypted stream.
void OnDecoderSelected(
scoped_ptr<VideoDecoder> selected_decoder,
scoped_ptr<DecryptingDemuxerStream> decrypting_demuxer_stream);
// Satisfy pending |read_cb_| with |status| and |frame|.
void SatisfyRead(Status status, const scoped_refptr<VideoFrame>& frame);
// Abort pending |read_cb_|.
void AbortRead();
// Decodes |buffer| and returns the result via OnFrameReady().
void Decode(const scoped_refptr<DecoderBuffer>& buffer);
// Flushes the decoder with an EOS buffer to retrieve internally buffered
// video frames.
void FlushDecoder();
// Callback for VideoDecoder::Decode().
void OnFrameReady(int buffer_size,
const VideoDecoder::Status status,
const scoped_refptr<VideoFrame>& frame);
// Reads a buffer from |stream_| and returns the result via OnBufferReady().
void ReadFromDemuxerStream();
// Callback for DemuxerStream::Read().
void OnBufferReady(DemuxerStream::Status status,
const scoped_refptr<DecoderBuffer>& buffer);
void ReinitializeDecoder();
// Callback for VideoDecoder reinitialization.
void OnDecoderReinitialized(PipelineStatus status);
void ResetDecoder();
void OnDecoderReset();
void StopDecoder();
void OnDecoderStopped();
scoped_refptr<base::MessageLoopProxy> message_loop_;
base::WeakPtrFactory<VideoFrameStream> weak_factory_;
base::WeakPtr<VideoFrameStream> weak_this_;
State state_;
StatisticsCB statistics_cb_;
InitCB init_cb_;
ReadCB read_cb_;
base::Closure reset_cb_;
base::Closure stop_cb_;
DemuxerStream* stream_;
scoped_ptr<VideoDecoderSelector> decoder_selector_;
// These two will be set by VideoDecoderSelector::SelectVideoDecoder().
scoped_ptr<VideoDecoder> decoder_;
scoped_ptr<DecryptingDemuxerStream> decrypting_demuxer_stream_;
DISALLOW_COPY_AND_ASSIGN(VideoFrameStream);
};
} // namespace media
#endif // MEDIA_FILTERS_VIDEO_FRAME_STREAM_H_
|
