media/base/android/media_player_manager.h

   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
  17 namespace media {
  18
  19 class MediaDrmBridge;
  20 class MediaPlayerAndroid;
  21 class MediaResourceGetter;
  22
  23 // This class is responsible for managing active MediaPlayerAndroid objects.
  24 class MEDIA_EXPORT MediaPlayerManager {
  25  public:
  26   virtual ~MediaPlayerManager() {}
  27
  28   // Called by a MediaPlayerAndroid object when it is going to decode
  29   // media streams. This helps the manager object maintain an array
  30   // of active MediaPlayerAndroid objects and release the resources
  31   // when needed.
  32   virtual void RequestMediaResources(int player_id) = 0;
  33
  34   // Called when a MediaPlayerAndroid object releases all its decoding
  35   // resources.
  36   virtual void ReleaseMediaResources(int player_id) = 0;
  37
  38   // Return a pointer to the MediaResourceGetter object.
  39   virtual MediaResourceGetter* GetMediaResourceGetter() = 0;
  40
  41   // Called when time update messages need to be sent. Args: player ID,
  42   // current time.
  43   virtual void OnTimeUpdate(int player_id, base::TimeDelta current_time) = 0;
  44
  45   // Called when media metadata changed. Args: player ID, duration of the
  46   // media, width, height, whether the metadata is successfully extracted.
  47   virtual void OnMediaMetadataChanged(
  48       int player_id,
  49       base::TimeDelta duration,
  50       int width,
  51       int height,
  52       bool success) = 0;
  53
  54   // Called when playback completed. Args: player ID.
  55   virtual void OnPlaybackComplete(int player_id) = 0;
  56
  57   // Called when media download was interrupted. Args: player ID.
  58   virtual void OnMediaInterrupted(int player_id) = 0;
  59
  60   // Called when buffering has changed. Args: player ID, percentage
  61   // of the media.
  62   virtual void OnBufferingUpdate(int player_id, int percentage) = 0;
  63
  64   // Called when seek completed. Args: player ID, current time.
  65   virtual void OnSeekComplete(
  66       int player_id,
  67       const base::TimeDelta& current_time) = 0;
  68
  69   // Called when error happens. Args: player ID, error type.
  70   virtual void OnError(int player_id, int error) = 0;
  71
  72   // Called when video size has changed. Args: player ID, width, height.
  73   virtual void OnVideoSizeChanged(int player_id, int width, int height) = 0;
  74
  75   // Returns the player that's in the fullscreen mode currently.
  76   virtual MediaPlayerAndroid* GetFullscreenPlayer() = 0;
  77
  78   // Returns the player with the specified id.
  79   virtual MediaPlayerAndroid* GetPlayer(int player_id) = 0;
  80
  81   // Release all the players managed by this object.
  82   virtual void DestroyAllMediaPlayers() = 0;
  83
  84   // Get the MediaDrmBridge object for the given media key Id.
  85   virtual media::MediaDrmBridge* GetDrmBridge(int media_keys_id) = 0;
  86
  87   // Called by the player to get a hardware protected surface.
  88   virtual void OnProtectedSurfaceRequested(int player_id) = 0;
  89
  90   // TODO(xhwang): The following three methods needs to be decoupled from
  91   // MediaPlayerManager to support the W3C Working Draft version of the EME
  92   // spec.
  93
  94   // Called when MediaDrmBridge wants to send a KeyAdded.
  95   virtual void OnKeyAdded(int media_keys_id,
  96                           const std::string& session_id) = 0;
  97
  98   // Called when MediaDrmBridge wants to send a KeyError.
  99   virtual void OnKeyError(int media_keys_id,
 100                           const std::string& session_id,
 101                           media::MediaKeys::KeyError error_code,
 102                           int system_code) = 0;
 103
 104   // Called when MediaDrmBridge wants to send a KeyMessage.
 105   virtual void OnKeyMessage(int media_keys_id,
 106                             const std::string& session_id,
 107                             const std::vector<uint8>& message,
 108                             const std::string& destination_url) = 0;
 109 };
 110
 111 }  // namespace media
 112
 113 #endif  // MEDIA_BASE_ANDROID_MEDIA_PLAYER_MANAGER_H_