1 // Copyright 2014 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.
5 import "media/mojo/interfaces/demuxer_stream.mojom"
6 import "media/mojo/interfaces/media_types.mojom"
10 [Client=MediaRendererClient]
11 interface MediaRenderer {
12 // Initializes the Renderer with |stream|, calling back upon completion.
13 // NOTE: If an error occurs, MediaRendererClient::OnError() will be called
14 // before the callback is executed.
15 Initialize(DemuxerStream stream) => ();
17 // Discards any buffered data, executing callback when completed.
18 // NOTE: If an error occurs, MediaRendererClient::OnError() can be called
19 // before the callback is executed.
22 // Starts rendering from |time_usec|.
23 StartPlayingFrom(int64 time_usec);
25 // Updates the current playback rate. The default playback rate should be 1.
26 SetPlaybackRate(float playback_rate);
28 // Sets the output volume. The default volume should be 1.
29 SetVolume(float volume);
32 interface MediaRendererClient {
33 // Called to report media time advancement by |time_usec|.
34 // |time_usec| and |max_time_usec| can be used to interpolate time between
35 // calls to OnTimeUpdate().
36 // |max_time_usec| is typically the media timestamp of the last audio frame
37 // buffered by the audio hardware.
38 // |max_time_usec| must be greater or equal to |time_usec|.
39 OnTimeUpdate(int64 time_usec, int64 max_time_usec);
41 // Called to report buffering state changes, see media_types.mojom.
42 OnBufferingStateChange(BufferingState state);
44 // Executed when rendering has reached the end of stream.
47 // Executed if any error was encountered during decode or rendering. If
48 // this error happens during an operation that has a completion callback,
49 // OnError() will be called before firing the completion callback.