content/browser/android/content_video_view.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 CONTENT_BROWSER_ANDROID_CONTENT_VIDEO_VIEW_H_
   6 #define CONTENT_BROWSER_ANDROID_CONTENT_VIDEO_VIEW_H_
   7
   8 #include <jni.h>
   9
  10 #include "base/android/jni_weak_ref.h"
  11 #include "base/android/scoped_java_ref.h"
  12 #include "base/basictypes.h"
  13 #include "base/memory/ref_counted.h"
  14 #include "base/memory/scoped_ptr.h"
  15 #include "base/memory/weak_ptr.h"
  16 #include "base/timer/timer.h"
  17 #include "ui/gfx/native_widget_types.h"
  18
  19 namespace content {
  20
  21 class BrowserMediaPlayerManager;
  22 class PowerSaveBlocker;
  23
  24 // Native mirror of ContentVideoView.java. This class is responsible for
  25 // creating the Java video view and pass all the player status change to
  26 // it. It accepts media control from Java class, and forwards it to
  27 // MediaPlayerManagerImpl.
  28 class ContentVideoView {
  29  public:
  30   // Construct a ContentVideoView object. The |manager| will handle all the
  31   // playback controls from the Java class.
  32   explicit ContentVideoView(BrowserMediaPlayerManager* manager);
  33
  34   ~ContentVideoView();
  35
  36   // To open another video on existing ContentVideoView.
  37   void OpenVideo();
  38
  39   static bool RegisterContentVideoView(JNIEnv* env);
  40   static void KeepScreenOn(bool screen_on);
  41
  42   // Return the singleton object or NULL.
  43   static ContentVideoView* GetInstance();
  44
  45   // Getter method called by the Java class to get the media information.
  46   int GetVideoWidth(JNIEnv*, jobject obj) const;
  47   int GetVideoHeight(JNIEnv*, jobject obj) const;
  48   int GetDurationInMilliSeconds(JNIEnv*, jobject obj) const;
  49   int GetCurrentPosition(JNIEnv*, jobject obj) const;
  50   bool IsPlaying(JNIEnv*, jobject obj);
  51   void RequestMediaMetadata(JNIEnv*, jobject obj);
  52
  53   // Called when the Java fullscreen view is destroyed. If
  54   // |release_media_player| is true, |manager_| needs to release the player
  55   // as we are quitting the app.
  56   void ExitFullscreen(JNIEnv*, jobject, jboolean release_media_player);
  57
  58   // Media control method called by the Java class.
  59   void SeekTo(JNIEnv*, jobject obj, jint msec);
  60   void Play(JNIEnv*, jobject obj);
  61   void Pause(JNIEnv*, jobject obj);
  62
  63   // Called by the Java class to pass the surface object to the player.
  64   void SetSurface(JNIEnv*, jobject obj, jobject surface);
  65
  66   // Method called by |manager_| to inform the Java class about player status
  67   // change.
  68   void UpdateMediaMetadata();
  69   void OnMediaPlayerError(int errorType);
  70   void OnVideoSizeChanged(int width, int height);
  71   void OnBufferingUpdate(int percent);
  72   void OnPlaybackComplete();
  73   void OnExitFullscreen();
  74
  75   // Return the corresponing ContentVideoView Java object if any.
  76   base::android::ScopedJavaLocalRef<jobject> GetJavaObject(JNIEnv* env);
  77
  78  private:
  79   // Creates the corresponding ContentVideoView Java object.
  80   JavaObjectWeakGlobalRef CreateJavaObject();
  81
  82   // Returns the associated NativeView
  83   gfx::NativeView GetNativeView();
  84
  85   void CreatePowerSaveBlocker();
  86
  87   // Object that manages the fullscreen media player. It is responsible for
  88   // handling all the playback controls.
  89   BrowserMediaPlayerManager* manager_;
  90
  91   // PowerSaveBlock to keep screen on for fullscreen video.
  92   // There is already blocker when inline video started, and it requires the
  93   // ContentView's container displayed to take effect; but in WebView, apps
  94   // could use another container to hold ContentVideoView, and the blocker in
  95   // ContentView's container can not keep screen on; so we need another blocker
  96   // here, it is no harm, just an additonal blocker.
  97   scoped_ptr<PowerSaveBlocker> power_save_blocker_;
  98
  99   // Weak reference of corresponding Java object.
 100   JavaObjectWeakGlobalRef j_content_video_view_;
 101
 102   // Weak pointer for posting tasks.
 103   base::WeakPtrFactory<ContentVideoView> weak_factory_;
 104
 105   DISALLOW_COPY_AND_ASSIGN(ContentVideoView);
 106 };
 107
 108 } // namespace content
 109
 110 #endif  // CONTENT_BROWSER_ANDROID_CONTENT_VIDEO_VIEW_H_