media_player_manager.h revision a1401311d1ab56c4ed0a474bd38c108f75cb0cd9 
1// Copyright (c) 2012 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 MEDIA_BASE_ANDROID_MEDIA_PLAYER_MANAGER_H_
6#define MEDIA_BASE_ANDROID_MEDIA_PLAYER_MANAGER_H_
7
8#include <string>
9#include <vector>
10
11#include "base/basictypes.h"
12#include "base/time/time.h"
13#include "media/base/android/demuxer_stream_player_params.h"
14#include "media/base/media_export.h"
15#include "media/base/media_keys.h"
16
17namespace media {
18
19class MediaDrmBridge;
20class MediaPlayerAndroid;
21class MediaResourceGetter;
22
23// This class is responsible for managing active MediaPlayerAndroid objects.
24class MEDIA_EXPORT MediaPlayerManager {
25 public:
26  virtual ~MediaPlayerManager() {}
27
28  // Return a pointer to the MediaResourceGetter object.
29  virtual MediaResourceGetter* GetMediaResourceGetter() = 0;
30
31  // Called when time update messages need to be sent. Args: player ID,
32  // current time.
33  virtual void OnTimeUpdate(int player_id, base::TimeDelta current_time) = 0;
34
35  // Called when media metadata changed. Args: player ID, duration of the
36  // media, width, height, whether the metadata is successfully extracted.
37  virtual void OnMediaMetadataChanged(
38      int player_id,
39      base::TimeDelta duration,
40      int width,
41      int height,
42      bool success) = 0;
43
44  // Called when playback completed. Args: player ID.
45  virtual void OnPlaybackComplete(int player_id) = 0;
46
47  // Called when media download was interrupted. Args: player ID.
48  virtual void OnMediaInterrupted(int player_id) = 0;
49
50  // Called when buffering has changed. Args: player ID, percentage
51  // of the media.
52  virtual void OnBufferingUpdate(int player_id, int percentage) = 0;
53
54  // Called when seek completed. Args: player ID, current time.
55  virtual void OnSeekComplete(
56      int player_id,
57      const base::TimeDelta& current_time) = 0;
58
59  // Called when error happens. Args: player ID, error type.
60  virtual void OnError(int player_id, int error) = 0;
61
62  // Called when video size has changed. Args: player ID, width, height.
63  virtual void OnVideoSizeChanged(int player_id, int width, int height) = 0;
64
65  // Returns the player that's in the fullscreen mode currently.
66  virtual MediaPlayerAndroid* GetFullscreenPlayer() = 0;
67
68  // Returns the player with the specified id.
69  virtual MediaPlayerAndroid* GetPlayer(int player_id) = 0;
70
71  // Release all the players managed by this object.
72  virtual void DestroyAllMediaPlayers() = 0;
73
74  // Get the MediaDrmBridge object for the given media key Id.
75  virtual media::MediaDrmBridge* GetDrmBridge(int cdm_id) = 0;
76
77  // Called by the player to get a hardware protected surface.
78  virtual void OnProtectedSurfaceRequested(int player_id) = 0;
79
80  // The following five methods are related to EME.
81  // TODO(xhwang): These methods needs to be decoupled from MediaPlayerManager
82  // to support the W3C Working Draft version of the EME spec.
83  // http://crbug.com/315312
84
85  // Called when MediaDrmBridge determines a SessionId.
86  virtual void OnSessionCreated(int cdm_id,
87                                uint32 session_id,
88                                const std::string& web_session_id) = 0;
89
90  // Called when MediaDrmBridge wants to send a Message event.
91  virtual void OnSessionMessage(int cdm_id,
92                                uint32 session_id,
93                                const std::vector<uint8>& message,
94                                const GURL& destination_url) = 0;
95
96  // Called when MediaDrmBridge wants to send a Ready event.
97  virtual void OnSessionReady(int cdm_id, uint32 session_id) = 0;
98
99  // Called when MediaDrmBridge wants to send a Closed event.
100  virtual void OnSessionClosed(int cdm_id, uint32 session_id) = 0;
101
102  // Called when MediaDrmBridge wants to send an Error event.
103  virtual void OnSessionError(int cdm_id,
104                              uint32 session_id,
105                              media::MediaKeys::KeyError error_code,
106                              uint32 system_code) = 0;
107};
108
109}  // namespace media
110
111#endif  // MEDIA_BASE_ANDROID_MEDIA_PLAYER_MANAGER_H_
112