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
19namespace content {
20
21class BrowserMediaPlayerManager;
22class 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.
28class 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  // Functions called to record fullscreen playback UMA metrics.
76  void RecordFullscreenPlayback(
77      JNIEnv*, jobject, bool is_portrait_video, bool is_orientation_portrait);
78  void RecordExitFullscreenPlayback(
79      JNIEnv*, jobject, bool is_portrait_video,
80      long playback_duration_in_milliseconds_before_orientation_change,
81      long playback_duration_in_milliseconds_after_orientation_change);
82
83  // Return the corresponing ContentVideoView Java object if any.
84  base::android::ScopedJavaLocalRef<jobject> GetJavaObject(JNIEnv* env);
85
86 private:
87  // Creates the corresponding ContentVideoView Java object.
88  JavaObjectWeakGlobalRef CreateJavaObject();
89
90  // Returns the associated NativeView
91  gfx::NativeView GetNativeView();
92
93  void CreatePowerSaveBlocker();
94
95  // Object that manages the fullscreen media player. It is responsible for
96  // handling all the playback controls.
97  BrowserMediaPlayerManager* manager_;
98
99  // PowerSaveBlock to keep screen on for fullscreen video.
100  // There is already blocker when inline video started, and it requires the
101  // ContentView's container displayed to take effect; but in WebView, apps
102  // could use another container to hold ContentVideoView, and the blocker in
103  // ContentView's container can not keep screen on; so we need another blocker
104  // here, it is no harm, just an additonal blocker.
105  scoped_ptr<PowerSaveBlocker> power_save_blocker_;
106
107  // Weak reference of corresponding Java object.
108  JavaObjectWeakGlobalRef j_content_video_view_;
109
110  // Weak pointer for posting tasks.
111  base::WeakPtrFactory<ContentVideoView> weak_factory_;
112
113  DISALLOW_COPY_AND_ASSIGN(ContentVideoView);
114};
115
116} // namespace content
117
118#endif  // CONTENT_BROWSER_ANDROID_CONTENT_VIDEO_VIEW_H_
119