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_helper.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/timer/timer.h"
  16
  17 namespace content {
  18
  19 class BrowserMediaPlayerManager;
  20
  21 // Native mirror of ContentVideoView.java. This class is responsible for
  22 // creating the Java video view and pass all the player status change to
  23 // it. It accepts media control from Java class, and forwards it to
  24 // MediaPlayerManagerImpl.
  25 class ContentVideoView {
  26  public:
  27   // Construct a ContentVideoView object. The |manager| will handle all the
  28   // playback controls from the Java class.
  29   ContentVideoView(
  30       const base::android::ScopedJavaLocalRef<jobject>& context,
  31       const base::android::ScopedJavaLocalRef<jobject>& client,
  32       BrowserMediaPlayerManager* manager);
  33
  34   explicit ContentVideoView(BrowserMediaPlayerManager* manager);
  35
  36   ~ContentVideoView();
  37
  38   // To open another video on existing ContentVideoView.
  39   void OpenVideo();
  40
  41   static bool RegisterContentVideoView(JNIEnv* env);
  42   static void KeepScreenOn(bool screen_on);
  43
  44   // Return the singleton object or NULL.
  45   static ContentVideoView* GetInstance();
  46
  47   // Getter method called by the Java class to get the media information.
  48   int GetVideoWidth(JNIEnv*, jobject obj) const;
  49   int GetVideoHeight(JNIEnv*, jobject obj) const;
  50   int GetDurationInMilliSeconds(JNIEnv*, jobject obj) const;
  51   int GetCurrentPosition(JNIEnv*, jobject obj) const;
  52   bool IsPlaying(JNIEnv*, jobject obj);
  53   void UpdateMediaMetadata(JNIEnv*, jobject obj);
  54
  55   // Called when the Java fullscreen view is destroyed. If
  56   // |release_media_player| is true, |manager_| needs to release the player
  57   // as we are quitting the app.
  58   void ExitFullscreen(JNIEnv*, jobject, jboolean release_media_player);
  59
  60   // Supposed to be called when the application paused or stopped.
  61   // Destroys the fullscreen view in a way that it can be recreated
  62   // via ResumeFullscreenIfSuspended.
  63   void SuspendFullscreen();
  64
  65   // Supposed to be called when the application switches back to foreground.
  66   // Recreates the fullscreen view if it was suspended via SuspendFullscreen.
  67   void ResumeFullscreenIfSuspended();
  68
  69   // Media control method called by the Java class.
  70   void SeekTo(JNIEnv*, jobject obj, jint msec);
  71   void Play(JNIEnv*, jobject obj);
  72   void Pause(JNIEnv*, jobject obj);
  73
  74   // Called by the Java class to pass the surface object to the player.
  75   void SetSurface(JNIEnv*, jobject obj, jobject surface);
  76
  77   // Method called by |manager_| to inform the Java class about player status
  78   // change.
  79   void UpdateMediaMetadata();
  80   void OnMediaPlayerError(int errorType);
  81   void OnVideoSizeChanged(int width, int height);
  82   void OnBufferingUpdate(int percent);
  83   void OnPlaybackComplete();
  84   void OnExitFullscreen();
  85
  86   // Return the corresponing ContentVideoView Java object if any.
  87   base::android::ScopedJavaLocalRef<jobject> GetJavaObject(JNIEnv* env);
  88
  89  private:
  90   // Destroy the |j_content_video_view_|. If |native_view_destroyed| is true,
  91   // no further calls to the native object is allowed.
  92   void DestroyContentVideoView(bool native_view_destroyed);
  93
  94   // Creates the corresponding ContentVideoView Java object.
  95   JavaObjectWeakGlobalRef CreateJavaObject();
  96
  97   // Object that manages the fullscreen media player. It is responsible for
  98   // handling all the playback controls.
  99   BrowserMediaPlayerManager* manager_;
 100
 101   // Weak reference of corresponding Java object.
 102   JavaObjectWeakGlobalRef j_content_video_view_;
 103
 104   enum FullscreenState {
 105     ENTERED,
 106     SUSPENDED,
 107     RESUME
 108   } fullscreen_state_;
 109
 110   DISALLOW_COPY_AND_ASSIGN(ContentVideoView);
 111 };
 112
 113 } // namespace content
 114
 115 #endif  // CONTENT_BROWSER_ANDROID_CONTENT_VIDEO_VIEW_H_