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.
4
5#ifndef CONTENT_BROWSER_MEDIA_ANDROID_BROWSER_MEDIA_PLAYER_MANAGER_H_
6#define CONTENT_BROWSER_MEDIA_ANDROID_BROWSER_MEDIA_PLAYER_MANAGER_H_
7
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"
21#include "url/gurl.h"
22
23namespace media {
24class DemuxerAndroid;
25}
26
27struct MediaPlayerHostMsg_Initialize_Params;
28
29namespace content {
30class BrowserDemuxerAndroid;
31class ContentViewCoreImpl;
32class ExternalVideoSurfaceContainer;
33class RenderFrameHost;
34class WebContents;
35
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
40// process.
41class CONTENT_EXPORT BrowserMediaPlayerManager
42    : public media::MediaPlayerManager {
43 public:
44  // Permits embedders to provide an extended version of the class.
45  typedef BrowserMediaPlayerManager* (*Factory)(RenderFrameHost*);
46  static void RegisterFactory(Factory factory);
47
48  // Permits embedders to handle custom urls.
49  static void RegisterMediaUrlInterceptor(
50      media::MediaUrlInterceptor* media_url_interceptor);
51
52  // Returns a new instance using the registered factory if available.
53  static BrowserMediaPlayerManager* Create(RenderFrameHost* rfh);
54
55  ContentViewCoreImpl* GetContentViewCore() const;
56
57  virtual ~BrowserMediaPlayerManager();
58
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);
65
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);
69
70  // Stops and releases every media managed by this class.
71  void ReleaseAllMediaPlayers();
72
73  // media::MediaPlayerManager overrides.
74  virtual void OnTimeUpdate(
75      int player_id,
76      base::TimeDelta current_timestamp,
77      base::TimeTicks current_time_ticks) OVERRIDE;
78  virtual void OnMediaMetadataChanged(
79      int player_id,
80      base::TimeDelta duration,
81      int width,
82      int height,
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(
88      int player_id,
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;
100
101  void AttachExternalVideoSurface(int player_id, jobject surface);
102  void DetachExternalVideoSurface(int player_id);
103  void OnFrameInfoUpdated();
104#endif  // defined(VIDEO_HOLE)
105
106  // Message handlers.
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)
125
126 protected:
127  // Clients must use Create() or subclass constructor.
128  explicit BrowserMediaPlayerManager(RenderFrameHost* render_frame_host);
129
130  WebContents* web_contents() const { return web_contents_; }
131
132  // Adds a given player to the list.
133  void AddPlayer(media::MediaPlayerAndroid* player);
134
135  // Removes the player with the specified id.
136  void RemovePlayer(int player_id);
137
138  // Replaces a player with the specified id with a given MediaPlayerAndroid
139  // object. This will also return the original MediaPlayerAndroid object that
140  // was replaced.
141  scoped_ptr<media::MediaPlayerAndroid> SwapPlayer(
142      int player_id,
143      media::MediaPlayerAndroid* player);
144
145  int RoutingID();
146
147  // Helper function to send messages to RenderFrameObserver.
148  bool Send(IPC::Message* msg);
149
150 private:
151  // Constructs a MediaPlayerAndroid object.
152  media::MediaPlayerAndroid* CreateMediaPlayer(
153      const MediaPlayerHostMsg_Initialize_Params& media_player_params,
154      bool hide_url_log,
155      media::MediaPlayerManager* manager,
156      BrowserDemuxerAndroid* demuxer);
157
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);
164
165  // Called when a player releases all decoding resources.
166  void ReleaseMediaResources(int player_id);
167
168  // Releases the player. However, don't remove it from |players_|.
169  void ReleasePlayer(media::MediaPlayerAndroid* player);
170
171#if defined(VIDEO_HOLE)
172  void OnRequestExternalSurface(int player_id, const gfx::RectF& rect);
173#endif  // defined(VIDEO_HOLE)
174
175  RenderFrameHost* const render_frame_host_;
176
177  // An array of managed players.
178  ScopedVector<media::MediaPlayerAndroid> players_;
179
180  // The fullscreen video view object or NULL if video is not played in
181  // fullscreen.
182  scoped_ptr<ContentVideoView> video_view_;
183
184#if defined(VIDEO_HOLE)
185  scoped_ptr<ExternalVideoSurfaceContainer> external_video_surface_container_;
186#endif
187
188  // Player ID of the fullscreen media player.
189  int fullscreen_player_id_;
190
191  // Whether the fullscreen player has been Release()-d.
192  bool fullscreen_player_is_released_;
193
194  WebContents* const web_contents_;
195
196  // Object for retrieving resources media players.
197  scoped_ptr<media::MediaResourceGetter> media_resource_getter_;
198
199  // NOTE: Weak pointers must be invalidated before all other member variables.
200  base::WeakPtrFactory<BrowserMediaPlayerManager> weak_ptr_factory_;
201
202  DISALLOW_COPY_AND_ASSIGN(BrowserMediaPlayerManager);
203};
204
205}  // namespace content
206
207#endif  // CONTENT_BROWSER_MEDIA_ANDROID_BROWSER_MEDIA_PLAYER_MANAGER_H_
208