Implement out-of-band video compositing on Android: Step 1

webkit/media/android/webmediaplayer_android.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef WEBKIT_MEDIA_ANDROID_WEBMEDIAPLAYER_ANDROID_H_
 #define WEBKIT_MEDIA_ANDROID_WEBMEDIAPLAYER_ANDROID_H_
 
 #include <jni.h>
 
 #include "base/basictypes.h"
@@ skipping 156 matching lines @@
 
   // Cleaning up all remaining resources as this object is about to get deleted.
   virtual void Destroy() = 0;
 
   WebKit::WebMediaPlayerClient* client() { return client_; }
 
   int player_id() const { return player_id_; }
 
   WebMediaPlayerManagerAndroid* manager() const { return manager_; }
 
+  // Request whether the player needs external surface for rendering.
+  void SetNeedsExternalSurface(bool needs_external_surface);
+
+  // Request external surface for out-of-band composition.
+  virtual void RequestExternalSurface() = 0;
+
  private:
   void ReallocateVideoFrame();
 
   WebKit::WebMediaPlayerClient* const client_;
 
   // Save the list of buffered time ranges.
   WebKit::WebTimeRanges buffered_;
 
   // Size of the video.
   WebKit::WebSize natural_size_;
@@ skipping 44 matching lines @@
   // Whether the video size info is available.
   bool has_size_info_;
 
   // Object for allocating stream textures.
   scoped_ptr<StreamTextureFactory> stream_texture_factory_;
 
   // Object for calling back the compositor thread to repaint the video when a
   // frame available. It should be initialized on the compositor thread.
   scoped_ptr<StreamTextureProxy> stream_texture_proxy_;
 
+  // Whether media player needs external surface.
+  bool needs_external_surface_;
+
   DISALLOW_COPY_AND_ASSIGN(WebMediaPlayerAndroid);
 };
 
 }  // namespace webkit_media
 
 #endif  // WEBKIT_MEDIA_ANDROID_WEBMEDIAPLAYER_ANDROID_H_