1 // Copyright 2013 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef CONTENT_BROWSER_MEDIA_ANDROID_BROWSER_MEDIA_PLAYER_MANAGER_H_
6 #define CONTENT_BROWSER_MEDIA_ANDROID_BROWSER_MEDIA_PLAYER_MANAGER_H_
8 #include "base/basictypes.h"
9 #include "base/callback.h"
10 #include "base/memory/scoped_ptr.h"
11 #include "base/memory/scoped_vector.h"
12 #include "base/time/time.h"
13 #include "content/browser/android/content_video_view.h"
14 #include "content/common/content_export.h"
15 #include "content/common/media/media_player_messages_enums_android.h"
16 #include "ipc/ipc_message.h"
17 #include "media/base/android/media_player_android.h"
18 #include "media/base/android/media_player_manager.h"
19 #include "media/base/android/media_url_interceptor.h"
20 #include "ui/gfx/rect_f.h"
27 struct MediaPlayerHostMsg_Initialize_Params;
30 class BrowserDemuxerAndroid;
31 class ContentViewCoreImpl;
32 class ExternalVideoSurfaceContainer;
33 class RenderFrameHost;
36 // This class manages all the MediaPlayerAndroid objects.
37 // It receives control operations from the the render process, and forwards
38 // them to corresponding MediaPlayerAndroid object. Callbacks from
39 // MediaPlayerAndroid objects are converted to IPCs and then sent to the render
41 class CONTENT_EXPORT BrowserMediaPlayerManager
42 : public media::MediaPlayerManager {
44 // Permits embedders to provide an extended version of the class.
45 typedef BrowserMediaPlayerManager* (*Factory)(RenderFrameHost*);
46 static void RegisterFactory(Factory factory);
48 // Permits embedders to handle custom urls.
49 static void RegisterMediaUrlInterceptor(
50 media::MediaUrlInterceptor* media_url_interceptor);
52 // Returns a new instance using the registered factory if available.
53 static BrowserMediaPlayerManager* Create(RenderFrameHost* rfh);
55 ContentViewCoreImpl* GetContentViewCore() const;
57 virtual ~BrowserMediaPlayerManager();
59 // Fullscreen video playback controls.
60 virtual void FullscreenPlayerPlay();
61 virtual void FullscreenPlayerPause();
62 virtual void FullscreenPlayerSeek(int msec);
63 virtual void ExitFullscreen(bool release_media_player);
64 virtual void SetVideoSurface(gfx::ScopedJavaSurface surface);
66 // Called when browser player wants the renderer media element to seek.
67 // Any actual seek started by renderer will be handled by browser in OnSeek().
68 void OnSeekRequest(int player_id, const base::TimeDelta& time_to_seek);
70 // Stops and releases every media managed by this class.
71 void ReleaseAllMediaPlayers();
73 // media::MediaPlayerManager overrides.
74 virtual void OnTimeUpdate(
76 base::TimeDelta current_timestamp,
77 base::TimeTicks current_time_ticks) override;
78 virtual void OnMediaMetadataChanged(
80 base::TimeDelta duration,
83 bool success) override;
84 virtual void OnPlaybackComplete(int player_id) override;
85 virtual void OnMediaInterrupted(int player_id) override;
86 virtual void OnBufferingUpdate(int player_id, int percentage) override;
87 virtual void OnSeekComplete(
89 const base::TimeDelta& current_time) override;
90 virtual void OnError(int player_id, int error) override;
91 virtual void OnVideoSizeChanged(
92 int player_id, int width, int height) override;
93 virtual media::MediaResourceGetter* GetMediaResourceGetter() override;
94 virtual media::MediaUrlInterceptor* GetMediaUrlInterceptor() override;
95 virtual media::MediaPlayerAndroid* GetFullscreenPlayer() override;
96 virtual media::MediaPlayerAndroid* GetPlayer(int player_id) override;
97 virtual void RequestFullScreen(int player_id) override;
98 #if defined(VIDEO_HOLE)
99 virtual bool ShouldUseVideoOverlayForEmbeddedEncryptedVideo() override;
101 void AttachExternalVideoSurface(int player_id, jobject surface);
102 void DetachExternalVideoSurface(int player_id);
103 void OnFrameInfoUpdated();
104 #endif // defined(VIDEO_HOLE)
107 virtual void OnEnterFullscreen(int player_id);
108 virtual void OnExitFullscreen(int player_id);
109 virtual void OnInitialize(
110 const MediaPlayerHostMsg_Initialize_Params& media_player_params);
111 virtual void OnStart(int player_id);
112 virtual void OnSeek(int player_id, const base::TimeDelta& time);
113 virtual void OnPause(int player_id, bool is_media_related_action);
114 virtual void OnSetVolume(int player_id, double volume);
115 virtual void OnSetPoster(int player_id, const GURL& poster);
116 virtual void OnReleaseResources(int player_id);
117 virtual void OnDestroyPlayer(int player_id);
118 virtual void OnRequestRemotePlayback(int player_id);
119 virtual void OnRequestRemotePlaybackControl(int player_id);
120 virtual void ReleaseFullscreenPlayer(media::MediaPlayerAndroid* player);
121 #if defined(VIDEO_HOLE)
122 void OnNotifyExternalSurface(
123 int player_id, bool is_request, const gfx::RectF& rect);
124 #endif // defined(VIDEO_HOLE)
127 // Clients must use Create() or subclass constructor.
128 explicit BrowserMediaPlayerManager(RenderFrameHost* render_frame_host);
130 WebContents* web_contents() const { return web_contents_; }
132 // Adds a given player to the list.
133 void AddPlayer(media::MediaPlayerAndroid* player);
135 // Removes the player with the specified id.
136 void RemovePlayer(int player_id);
138 // Replaces a player with the specified id with a given MediaPlayerAndroid
139 // object. This will also return the original MediaPlayerAndroid object that
141 scoped_ptr<media::MediaPlayerAndroid> SwapPlayer(
143 media::MediaPlayerAndroid* player);
147 // Helper function to send messages to RenderFrameObserver.
148 bool Send(IPC::Message* msg);
151 // Constructs a MediaPlayerAndroid object.
152 media::MediaPlayerAndroid* CreateMediaPlayer(
153 const MediaPlayerHostMsg_Initialize_Params& media_player_params,
155 media::MediaPlayerManager* manager,
156 BrowserDemuxerAndroid* demuxer);
158 // MediaPlayerAndroid must call this before it is going to decode
159 // media streams. This helps the manager object maintain an array
160 // of active MediaPlayerAndroid objects and release the resources
161 // when needed. Currently we only count video resources as they are
162 // constrained by hardware and memory limits.
163 virtual void OnMediaResourcesRequested(int player_id);
165 // Called when a player releases all decoding resources.
166 void ReleaseMediaResources(int player_id);
168 // Releases the player. However, don't remove it from |players_|.
169 void ReleasePlayer(media::MediaPlayerAndroid* player);
171 #if defined(VIDEO_HOLE)
172 void OnRequestExternalSurface(int player_id, const gfx::RectF& rect);
173 #endif // defined(VIDEO_HOLE)
175 RenderFrameHost* const render_frame_host_;
177 // An array of managed players.
178 ScopedVector<media::MediaPlayerAndroid> players_;
180 // The fullscreen video view object or NULL if video is not played in
182 scoped_ptr<ContentVideoView> video_view_;
184 #if defined(VIDEO_HOLE)
185 scoped_ptr<ExternalVideoSurfaceContainer> external_video_surface_container_;
188 // Player ID of the fullscreen media player.
189 int fullscreen_player_id_;
191 // Whether the fullscreen player has been Release()-d.
192 bool fullscreen_player_is_released_;
194 WebContents* const web_contents_;
196 // Object for retrieving resources media players.
197 scoped_ptr<media::MediaResourceGetter> media_resource_getter_;
199 // NOTE: Weak pointers must be invalidated before all other member variables.
200 base::WeakPtrFactory<BrowserMediaPlayerManager> weak_ptr_factory_;
202 DISALLOW_COPY_AND_ASSIGN(BrowserMediaPlayerManager);
205 } // namespace content
207 #endif // CONTENT_BROWSER_MEDIA_ANDROID_BROWSER_MEDIA_PLAYER_MANAGER_H_