blob: f909350a7d4e0c9f62168680f46152546e21b173 [file] [log] [blame]
// 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.
#ifndef MEDIA_BASE_RENDERER_H_
#define MEDIA_BASE_RENDERER_H_
#include "base/callback.h"
#include "base/memory/ref_counted.h"
#include "base/time/time.h"
#include "media/base/buffering_state.h"
#include "media/base/cdm_context.h"
#include "media/base/media_export.h"
#include "media/base/pipeline_status.h"
namespace media {
class DemuxerStreamProvider;
class VideoFrame;
class MEDIA_EXPORT Renderer {
public:
typedef base::Callback<void(const scoped_refptr<VideoFrame>&)> PaintCB;
typedef base::Callback<base::TimeDelta()> TimeDeltaCB;
Renderer();
// Stops rendering and fires any pending callbacks.
virtual ~Renderer();
// Initializes the Renderer with |demuxer_stream_provider|, executing
// |init_cb| upon completion. If initialization failed, fires |error_cb|
// before |init_cb|. |demuxer_stream_provider| must be valid throughout the
// lifetime of the Renderer object.
//
// Permanent callbacks:
// - |statistics_cb|: Executed periodically with rendering statistics.
// - |buffering_state_cb|: Executed when buffering state is changed.
// - |paint_cb|: Executed when there is a VideoFrame ready to paint. Can be
// ignored if the Renderer handles the painting by itself. Can
// be called from any thread.
// - |ended_cb|: Executed when rendering has reached the end of stream.
// - |error_cb|: Executed if any error was encountered during rendering.
virtual void Initialize(DemuxerStreamProvider* demuxer_stream_provider,
const base::Closure& init_cb,
const StatisticsCB& statistics_cb,
const BufferingStateCB& buffering_state_cb,
const PaintCB& paint_cb,
const base::Closure& ended_cb,
const PipelineStatusCB& error_cb) = 0;
// Associates the |cdm_context| with this Renderer for decryption (and
// decoding) of media data, then fires |cdm_attached_cb| with the result.
virtual void SetCdm(CdmContext* cdm_context,
const CdmAttachedCB& cdm_attached_cb) = 0;
// The following functions must be called after Initialize().
// Discards any buffered data, executing |flush_cb| when completed.
virtual void Flush(const base::Closure& flush_cb) = 0;
// Starts rendering from |time|.
virtual void StartPlayingFrom(base::TimeDelta time) = 0;
// Updates the current playback rate. The default playback rate should be 1.
virtual void SetPlaybackRate(float playback_rate) = 0;
// Sets the output volume. The default volume should be 1.
virtual void SetVolume(float volume) = 0;
// Returns the current media time.
virtual base::TimeDelta GetMediaTime() = 0;
// Returns whether |this| renders audio.
virtual bool HasAudio() = 0;
// Returns whether |this| renders video.
virtual bool HasVideo() = 0;
private:
DISALLOW_COPY_AND_ASSIGN(Renderer);
};
} // namespace media
#endif // MEDIA_BASE_RENDERER_H_