blob: b6e1a73373b6e77060b479bf88dad7ee21425372 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
// 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/macros.h"
#include "base/memory/ref_counted.h"
#include "base/optional.h"
#include "base/time/time.h"
#include "media/base/buffering_state.h"
#include "media/base/demuxer_stream.h"
#include "media/base/media_export.h"
#include "media/base/pipeline_status.h"
namespace media {
class CdmContext;
class MediaResource;
class RendererClient;
class MEDIA_EXPORT Renderer {
public:
Renderer();
// Stops rendering and fires any pending callbacks.
virtual ~Renderer();
// Initializes the Renderer with |media_resource|, executing |init_cb| upon
// completion. |media_resource| must be valid for the lifetime of the Renderer
// object. |init_cb| must only be run after this method has returned. Firing
// |init_cb| may result in the immediate destruction of the caller, so it must
// be run only prior to returning.
virtual void Initialize(MediaResource* media_resource,
RendererClient* client,
PipelineStatusCallback init_cb) = 0;
// Associates the |cdm_context| with this Renderer for decryption (and
// decoding) of media data, then fires |cdm_attached_cb| with whether the
// operation succeeded.
using CdmAttachedCB = base::OnceCallback<void(bool)>;
virtual void SetCdm(CdmContext* cdm_context, CdmAttachedCB cdm_attached_cb);
// Specifies a latency hint from the site. Renderers should clamp the hint
// value to reasonable min and max and use the resulting value as a target
// latency such that the buffering state reaches HAVE_ENOUGH when this amount
// of decoded data is buffered. A nullopt hint indicates the user is clearing
// their preference and the renderer should restore its default buffering
// thresholds.
virtual void SetLatencyHint(base::Optional<base::TimeDelta> latency_hint) = 0;
// Sets whether pitch adjustment should be applied when the playback rate is
// different than 1.0.
virtual void SetPreservesPitch(bool preserves_pitch);
// The following functions must be called after Initialize().
// Discards any buffered data, executing |flush_cb| when completed.
virtual void Flush(base::OnceClosure 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 0.
virtual void SetPlaybackRate(double playback_rate) = 0;
// Sets the output volume. The default volume should be 1.
virtual void SetVolume(float volume) = 0;
// Returns the current media time.
//
// This method must be safe to call from any thread.
virtual base::TimeDelta GetMediaTime() = 0;
// Provides a list of DemuxerStreams correlating to the tracks which should
// be played. An empty list would mean that any playing track of the same
// type should be flushed and disabled. Any provided Streams should be played
// by whatever mechanism the subclass of Renderer choses for managing it's AV
// playback.
virtual void OnSelectedVideoTracksChanged(
const std::vector<DemuxerStream*>& enabled_tracks,
base::OnceClosure change_completed_cb);
virtual void OnEnabledAudioTracksChanged(
const std::vector<DemuxerStream*>& enabled_tracks,
base::OnceClosure change_completed_cb);
private:
DISALLOW_COPY_AND_ASSIGN(Renderer);
};
} // namespace media
#endif // MEDIA_BASE_RENDERER_H_
|
