Mojo framework for AndroidOverlay.

media/base/android/android_overlay.h

+// Copyright 2017 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 MEDIA_BASE_ANDROID_ANDROID_OVERLAY_H_
+#define MEDIA_BASE_ANDROID_ANDROID_OVERLAY_H_
+
+#include "base/callback.h"
+#include "base/macros.h"
+#include "media/base/media_export.h"
+#include "ui/gfx/geometry/rect.h"
+#include "ui/gl/android/scoped_java_surface.h"
+
+namespace media {
+
+// Client interface to an AndroidOverlay.  To construct one, you'll probably
+// want to use an AndroidOverlayFactory.  Once constructed, you can expect to
+// receive zero or one SurfaceCreatedCallbacks, and one SurfaceDestroyed.
+// Upon receiving SurfaceCreated, you will have Android Surface that you may
+// use until SurfaceDestroyed.  You may also move the surface (ScheduleLayout).
+// When SurfaceDestroyed arrives, you should stop using the Android Surface and
+// delete the AndroidOverlay instance.  Note that these calls are synchronous
+// in Android, so you should delete the AndroidOverlay surface as soon as
+// possible.  Other overlays might be blocked waiting.
+class MEDIA_EXPORT AndroidOverlay {
+ public:
+  // Called when the overlay is ready for use.  You should take ownership of
+  // the surface.
+  using ReadyCallback = base::Callback<void(gl::ScopedJavaSurface)>;
+
+  // Called when the overlay has been destroyed.  This may be called before
+  // ReadyCallback.  It will be the last callback for the overlay.
+  using DestroyedCallback = base::Callback<void()>;
+
+  // Configuration used to create an overlay.
+  struct Config {
+   public:
+    Config();
+    Config(const Config&);
+    ~Config();
+
+    gfx::Rect rect;
+    // TODO(liberato): add format, etc. here.
+
+    ReadyCallback ready_cb;
+    DestroyedCallback destroyed_cb;
+  };
+
+  virtual ~AndroidOverlay() {}
+
+  // Schedule a relayout of this overlay.  If called before the client is
+  // notified that the surface is created, then the call will be ignored.
+  virtual void ScheduleLayout(const gfx::Rect& rect) = 0;
+
+ protected:
+  AndroidOverlay() {}
+  DISALLOW_COPY_AND_ASSIGN(AndroidOverlay);
+};
+
+}  // namespace media
+
+#endif  // MEDIA_BASE_ANDROID_ANDROID_OVERLAY_H_