Integrate Surface requests with MediaPlayerRenderer

media/mojo/interfaces/renderer.mojom

 // Copyright 2014 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.
 
 module media.mojom;
 
 import "media/mojo/interfaces/demuxer_stream.mojom";
 import "media/mojo/interfaces/media_types.mojom";
 import "mojo/common/common_custom_types.mojom";
 import "ui/gfx/geometry/mojo/geometry.mojom";
@@ skipping 17 matching lines @@
 
   // Updates the current playback rate. The default playback rate should be 1.
   SetPlaybackRate(double playback_rate);
 
   // Sets the output volume. The default volume should be 1.
   SetVolume(float volume);
 
   // Attaches the CDM associated with |cdm_id| to the renderer service,
   // executing the callback with whether the CDM was successfully attached.
   SetCdm(int32 cdm_id) => (bool success);
+
+  // Registers a new request in the ScopedSurfaceRequestManager, and returns
+  // its token.
+  //
+  // NOTE: Should only be called on Android. Only used for WMPI's fallback path
+  // (i.e. HLS playback), when the MojoRendererService wraps a
+  // content::MediaPlayerRenderer.
+  // Unexpected calls to this method will close the connection.
+  InitiateScopedSurfaceRequest()
+      => (mojo.common.mojom.UnguessableToken request_token);
 };
 
 interface RendererClient {
   // Called to report media time advancement by |time|.
   // |time| and |max_time| can be used to interpolate time between
   // calls to OnTimeUpdate().
   // |max_time| is typically the media timestamp of the last audio frame
   //     buffered by the audio hardware.
   // |capture_time| is monotonic clock time at which the times were captured.
   // |max_time| must be greater or equal to |time|.
@@ skipping 23 matching lines @@
   OnStatisticsUpdate(PipelineStatistics stats);
 
   // Called when the remote renderering service is waiting on the decryption
   // key.
   OnWaitingForDecryptionKey();
 
   // Executed the first time the metadata is updated, and whenever the duration
   // changes.
   OnDurationChange(mojo.common.mojom.TimeDelta duration);
 };