Index: webkit/media/webmediaplayer_ms.h |
=================================================================== |
--- webkit/media/webmediaplayer_ms.h (revision 0) |
+++ webkit/media/webmediaplayer_ms.h (revision 0) |
@@ -0,0 +1,279 @@ |
+// Copyright (c) 2012 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 Pipeline which is the actual media player pipeline, it glues |
+// the media player pipeline, data source, audio renderer and renderer. |
+// Pipeline 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. |
+// |
+// WebMediaPlayerMS works with multiple objects, the most important ones are: |
+// |
+// media::Pipeline |
+// The media playback pipeline. |
+// |
+// VideoRendererBase |
+// Video renderer object. |
+// |
+// WebKit::WebMediaPlayerClient |
+// WebKit client of this media player object. |
+// |
+// The following diagram shows the relationship of these objects: |
+// (note: ref-counted reference is marked by a "r".) |
+// |
+// WebMediaPlayerClient (WebKit object) |
+// ^ |
+// | |
+// WebMediaPlayerMS ---> Pipeline |
+// | ^ | |
+// | | v r |
+// | | VideoRendererBase |
+// | | | ^ r |
+// | r | v r | |
+// '---> WebMediaPlayerProxy --' |
+// |
+// Notice that WebMediaPlayerProxy and VideoRendererBase are referencing each |
+// other. This interdependency has to be treated carefully. |
+// |
+// 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 WEBKIT_MEDIA_WEBMEDIAPLAYER_MS_H_ |
+#define WEBKIT_MEDIA_WEBMEDIAPLAYER_MS_H_ |
+ |
+#include "base/memory/ref_counted.h" |
+#include "base/memory/scoped_ptr.h" |
+#include "base/memory/weak_ptr.h" |
+#include "base/message_loop.h" |
+#include "googleurl/src/gurl.h" |
+#include "media/base/audio_renderer_sink.h" |
+#include "media/base/filters.h" |
+#include "media/base/message_loop_factory.h" |
+#include "media/base/pipeline.h" |
+#include "skia/ext/platform_canvas.h" |
+#include "third_party/WebKit/Source/WebKit/chromium/public/WebAudioSourceProvider.h" |
+#include "third_party/WebKit/Source/WebKit/chromium/public/WebMediaPlayer.h" |
+#include "third_party/WebKit/Source/WebKit/chromium/public/WebMediaPlayerClient.h" |
+ |
+class RenderAudioSourceProvider; |
+class SkCanvas; |
+ |
+namespace WebKit { |
+class WebAudioSourceProvider; |
+class WebFrame; |
+} |
+ |
+namespace gfx { |
+class Rect; |
+} |
+ |
+namespace media { |
+class MediaLog; |
+} |
+ |
+namespace webkit_media { |
+ |
+class MediaStreamClient; |
+class VideoFrameProvider; |
+class WebMediaPlayerDelegate; |
+class WebMediaPlayerMS; |
+ |
+class WebMediaPlayerMSProxy |
+ : public base::RefCountedThreadSafe<WebMediaPlayerMSProxy> { |
+ public: |
+ WebMediaPlayerMSProxy(); |
+ |
+ void SetListener(WebMediaPlayerMS* listener) { |
+ listener_ = listener; |
+ } |
+ |
+ void Repaint(); |
+ void Paint(SkCanvas* canvas, const gfx::Rect& dest_rect, uint8_t alpha); |
+ |
+ private: |
+ friend class base::RefCountedThreadSafe<WebMediaPlayerMSProxy>; |
+ virtual ~WebMediaPlayerMSProxy(); |
+ |
+ WebMediaPlayerMS* listener_; |
+ scoped_refptr<base::MessageLoopProxy> render_message_loop_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(WebMediaPlayerMSProxy); |
+}; |
+ |
+class WebMediaPlayerMS |
+ : public WebKit::WebMediaPlayer, |
+ public MessageLoop::DestructionObserver, |
+ public base::SupportsWeakPtr<WebMediaPlayerMS> { |
+ public: |
+ // Construct a WebMediaPlayerMS with reference to the client, and media |
+ // filter collection. By providing the filter collection the implementor can |
+ // provide more specific media filters that does resource loading and |
+ // rendering. |
+ // |
+ // WebMediaPlayerMS comes packaged with the following media filters: |
+ // - URL fetching |
+ // - Demuxing |
+ // - Software audio/video decoding |
+ // - Video rendering |
+ // |
+ // Clients are expected to add their platform-specific audio rendering media |
+ // filter if they wish to hear any sound coming out the speakers, otherwise |
+ // audio data is discarded and media plays back based on wall clock time. |
+ // |
+ WebMediaPlayerMS(WebKit::WebFrame* frame, |
+ WebKit::WebMediaPlayerClient* client, |
+ base::WeakPtr<WebMediaPlayerDelegate> delegate, |
+ media::MessageLoopFactory* message_loop_factory, |
+ MediaStreamClient* media_stream_client, |
+ media::MediaLog* media_log); |
+ virtual ~WebMediaPlayerMS(); |
+ |
+ virtual void load(const WebKit::WebURL& url); |
+ virtual void cancelLoad(); |
+ |
+ // Playback controls. |
+ virtual void play(); |
+ virtual void pause(); |
+ virtual bool supportsFullscreen() const; |
+ virtual bool supportsSave() const; |
+ 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 void setPreload(WebKit::WebMediaPlayer::Preload preload); |
+ virtual bool totalBytesKnown(); |
+ virtual const WebKit::WebTimeRanges& buffered(); |
+ virtual float maxTimeSeekable() const; |
+ |
+ // Methods for painting. |
+ virtual void setSize(const WebKit::WebSize& size); |
+ |
+#if WEBKIT_USING_SKIA |
+ // This variant (without alpha) is just present during staging of this API |
+ // change. Later we will again only have one virtual paint(). |
+ virtual void paint(WebKit::WebCanvas* canvas, const WebKit::WebRect& rect); |
+ virtual void paint(WebKit::WebCanvas* canvas, |
+ const WebKit::WebRect& rect, |
+ uint8_t alpha); |
+#else |
+ virtual void paint(WebKit::WebCanvas* canvas, const WebKit::WebRect& rect); |
+#endif |
+ |
+ // True if the loaded media has a playable video/audio track. |
+ virtual bool hasVideo() const; |
+ virtual bool hasAudio() 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; |
+ virtual WebKit::WebMediaPlayer::ReadyState readyState() const; |
+ |
+ virtual unsigned long long bytesLoaded() const; |
+ virtual unsigned long long totalBytes() const; |
+ |
+ virtual bool hasSingleSecurityOrigin() const; |
+ virtual WebKit::WebMediaPlayer::MovieLoadType movieLoadType() const; |
+ |
+ virtual float mediaTimeForTimeValue(float timeValue) const; |
+ |
+ virtual unsigned decodedFrameCount() const; |
+ virtual unsigned droppedFrameCount() const; |
+ virtual unsigned audioDecodedByteCount() const; |
+ virtual unsigned videoDecodedByteCount() const; |
+ |
+ virtual WebKit::WebVideoFrame* getCurrentFrame(); |
+ virtual void putCurrentFrame(WebKit::WebVideoFrame* web_video_frame); |
+ |
+ // 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() OVERRIDE; |
+ |
+ void Repaint(); |
+ |
+ private: |
+ // Helpers that set the network/ready state and notifies the client if |
+ // they've changed. |
+ void SetNetworkState(WebKit::WebMediaPlayer::NetworkState state); |
+ void SetReadyState(WebKit::WebMediaPlayer::ReadyState state); |
+ |
+ // Destroy resources held. |
+ void Destroy(); |
+ |
+ // Getter method to |client_|. |
+ WebKit::WebMediaPlayerClient* GetClient(); |
+ |
+ // Lets V8 know that player uses extra resources not managed by V8. |
+ void IncrementExternallyAllocatedMemory(); |
+ |
+ WebKit::WebFrame* frame_; |
+ |
+ // TODO(hclam): get rid of these members and read from the pipeline directly. |
+ WebKit::WebMediaPlayer::NetworkState network_state_; |
+ WebKit::WebMediaPlayer::ReadyState ready_state_; |
+ |
+ // Keep a list of buffered time ranges. |
+ WebKit::WebTimeRanges buffered_; |
+ |
+ // 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_; |
+ |
+ // The media pipeline and a bool tracking whether we have started it yet. |
+ // |
+ // TODO(scherkus): replace |started_| with a pointer check for |pipeline_| and |
+ // have WebMediaPlayerMS return the default values to WebKit instead of |
+ // relying on Pipeline to take care of default values. |
+ |
+ scoped_ptr<media::MessageLoopFactory> message_loop_factory_; |
+ |
+ WebKit::WebMediaPlayerClient* client_; |
+ |
+ scoped_refptr<WebMediaPlayerMSProxy> proxy_; |
+ |
+ base::WeakPtr<WebMediaPlayerDelegate> delegate_; |
+ |
+ MediaStreamClient* media_stream_client_; |
+ scoped_refptr<VideoFrameProvider> frame_provider_; |
+ bool frame_provider_paused_; |
+ |
+#if WEBKIT_USING_CG |
+ scoped_ptr<skia::PlatformCanvas> skia_canvas_; |
+#endif |
+ |
+ scoped_refptr<media::MediaLog> media_log_; |
+ |
+ // Since accelerated compositing status is only known after the first layout, |
+ // we delay reporting it to UMA until that time. |
+ bool accelerated_compositing_reported_; |
+ |
+ bool incremented_externally_allocated_memory_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(WebMediaPlayerMS); |
+}; |
+ |
+} // namespace webkit_media |
+ |
+#endif // WEBKIT_MEDIA_WEBMEDIAPLAYER_MS_H_ |
Property changes on: webkit/media/webmediaplayer_ms.h |
___________________________________________________________________ |
Added: svn:eol-style |
+ LF |