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. 4 5import "media/mojo/interfaces/demuxer_stream.mojom" 6import "media/mojo/interfaces/media_types.mojom" 7 8module mojo { 9 10[Client=MediaRendererClient] 11interface 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) => (); 16 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. 20 Flush() => (); 21 22 // Starts rendering from |time_usec|. 23 StartPlayingFrom(int64 time_usec); 24 25 // Updates the current playback rate. The default playback rate should be 1. 26 SetPlaybackRate(float playback_rate); 27 28 // Sets the output volume. The default volume should be 1. 29 SetVolume(float volume); 30}; 31 32interface 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); 40 41 // Called to report buffering state changes, see media_types.mojom. 42 OnBufferingStateChange(BufferingState state); 43 44 // Executed when rendering has reached the end of stream. 45 OnEnded(); 46 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. 50 OnError(); 51}; 52 53} // module mojo 54