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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
// Copyright (c) 2008-2009 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.
//
// Delegate calls from WebCore::MediaPlayerPrivate to Chrome's video player.
// It contains PipelineImpl which is the actual media player pipeline, it glues
// the media player pipeline, data source, audio renderer and renderer.
// PipelineImpl would creates multiple threads and access some public methods
// of this class, so we need to be extra careful about concurrent access of
// methods and members.
//
// Properties that are shared by main thread and media threads:
// CancelableTaskList tasks_;
// ^--- This property is shared for keeping records of the tasks posted to
// make sure there will be only one task for each task type that can
// exist in the main thread.
//
// Methods that are accessed in media threads:
// SetAudioRenderer()
// ^--- Called during the initialization of the pipeline, essentially from the
// the pipeline thread.
// SetVideoRenderer()
// ^--- Called during the initialization of the pipeline, essentially from the
// the pipeline thread.
// PostRepaintTask()
// ^--- Called from the video renderer thread to notify a video frame has
// been prepared.
// PostTask()
// ^--- A method that helps posting tasks to the main thread, it is
// accessed from main thread and media threads, it access the |tasks_|
// internally. Needs locking inside to avoid concurrent access to
// |tasks_|.
//
//
// Other issues:
// During tear down of the whole browser or a tab, the DOM tree may not be
// destructed nicely, and there will be some dangling media threads trying to
// the main thread, so we need this class to listen to destruction event of the
// main thread and cleanup the media threads when the even is received. Also
// at destruction of this class we will need to unhook it from destruction event
// list of the main thread.
#ifndef CHROME_RENDERER_WEBMEDIAPLAYER_IMPL_H_
#define CHROME_RENDERER_WEBMEDIAPLAYER_IMPL_H_
#include <vector>
#include "base/lock.h"
#include "base/message_loop.h"
#include "media/base/filters.h"
#include "media/base/pipeline_impl.h"
#include "skia/ext/platform_canvas.h"
#include "third_party/WebKit/WebKit/chromium/public/WebMediaPlayer.h"
#include "third_party/WebKit/WebKit/chromium/public/WebMediaPlayerClient.h"
class AudioRendererImpl;
class DataSourceImpl;
class GURL;
class RenderView;
class VideoRendererImpl;
namespace media {
class FilterFactoryCollection;
}
// This typedef is used for WebMediaPlayerImpl::PostTask() and
// NotifyWebMediaPlayerTask in the source file.
typedef void (WebKit::WebMediaPlayerClient::*WebMediaPlayerClientMethod)();
class WebMediaPlayerImpl : public WebKit::WebMediaPlayer,
public MessageLoop::DestructionObserver {
public:
WebMediaPlayerImpl(RenderView* view, WebKit::WebMediaPlayerClient* client);
virtual ~WebMediaPlayerImpl();
virtual void load(const WebKit::WebURL& url);
virtual void cancelLoad();
// Playback controls.
virtual void play();
virtual void pause();
virtual void stop();
virtual void seek(float seconds);
virtual void setEndTime(float seconds);
virtual void setRate(float rate);
virtual void setVolume(float volume);
virtual void setVisible(bool visible);
virtual bool setAutoBuffer(bool autoBuffer);
virtual bool totalBytesKnown();
virtual float maxTimeBuffered() const;
virtual float maxTimeSeekable() const;
// Methods for painting.
virtual void setSize(const WebKit::WebSize& size);
virtual void paint(WebKit::WebCanvas* canvas, const WebKit::WebRect& rect);
// True if a video is loaded.
virtual bool hasVideo() const;
// Dimensions of the video.
virtual WebKit::WebSize naturalSize() const;
// Getters of playback state.
virtual bool paused() const;
virtual bool seeking() const;
virtual float duration() const;
virtual float currentTime() const;
// Get rate of loading the resource.
virtual int32 dataRate() const;
// Internal states of loading and network.
// TODO(hclam): Ask the pipeline about the state rather than having reading
// them from members which would cause race conditions.
virtual WebKit::WebMediaPlayer::NetworkState networkState() const {
return network_state_;
}
virtual WebKit::WebMediaPlayer::ReadyState readyState() const {
return ready_state_;
}
virtual unsigned long long bytesLoaded() const;
virtual unsigned long long totalBytes() const;
// As we are closing the tab or even the browser, |main_loop_| is destroyed
// even before this object gets destructed, so we need to know when
// |main_loop_| is being destroyed and we can stop posting repaint task
// to it.
virtual void WillDestroyCurrentMessageLoop();
// Notification from |pipeline_| when initialization has finished.
void OnPipelineInitialize(bool successful);
// Notification from |pipeline_| when a seek has finished.
void OnPipelineSeek(bool successful);
// Called from tasks posted to |main_loop_| from this object to remove
// reference of them.
void DidTask(CancelableTask* task);
// Public methods to be called from renderers and data source so that
// WebMediaPlayerImpl has references to them.
void SetVideoRenderer(VideoRendererImpl* video_renderer);
// Called from VideoRenderer to fire a repaint task to |main_loop_|.
void PostRepaintTask();
// Inline getters.
WebKit::WebMediaPlayerClient* client() { return client_; }
RenderView* view() { return view_; }
private:
// Methods for posting tasks and cancelling tasks. This method may lives in
// the main thread or the media threads.
void PostTask(int index, WebMediaPlayerClientMethod method);
// Cancel all tasks currently live in |main_loop_|.
void CancelAllTasks();
// Indexes for tasks.
enum {
kRepaintTaskIndex = 0,
kReadyStateTaskIndex,
kNetworkStateTaskIndex,
kTimeChangedTaskIndex,
kLastTaskIndex
};
// TODO(hclam): get rid of these members and read from the pipeline directly.
WebKit::WebMediaPlayer::NetworkState network_state_;
WebKit::WebMediaPlayer::ReadyState ready_state_;
// Message loops for posting tasks between Chrome's main thread. Also used
// for DCHECKs so methods calls won't execute in the wrong thread.
MessageLoop* main_loop_;
// A collection of factories for creating filters.
scoped_refptr<media::FilterFactoryCollection> filter_factory_;
// The actual pipeline. We do it a composition here because we expect to have
// the same lifetime as the pipeline.
media::PipelineImpl pipeline_;
// We have the interface to VideoRenderer to delegate paint messages to it
// from WebKit.
scoped_refptr<VideoRendererImpl> video_renderer_;
WebKit::WebMediaPlayerClient* client_;
RenderView* view_;
// List of tasks for holding pointers to all tasks currently in the
// |main_loop_|. |tasks_| can be access from main thread or the media threads
// we need a lock for protecting it.
Lock task_lock_;
typedef std::vector<CancelableTask*> CancelableTaskList;
CancelableTaskList tasks_;
DISALLOW_COPY_AND_ASSIGN(WebMediaPlayerImpl);
};
#endif // CHROME_RENDERER_WEBMEDIAPLAYER_IMPL_H_
|
