summaryrefslogtreecommitdiffstats
path: root/media/base/audio_renderer_mixer_input.h
blob: 34f37c5ee00a3c0d0803ef4f807992942bbf8401 (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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
// Copyright (c) 2012 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_AUDIO_RENDERER_MIXER_INPUT_H_
#define MEDIA_BASE_AUDIO_RENDERER_MIXER_INPUT_H_

#include <string>

#include "base/callback.h"
#include "base/macros.h"
#include "media/base/audio_converter.h"
#include "media/base/audio_renderer_sink.h"
#include "media/base/output_device.h"
#include "url/origin.h"

namespace media {

class AudioRendererMixer;

class MEDIA_EXPORT AudioRendererMixerInput
    : NON_EXPORTED_BASE(public RestartableAudioRendererSink),
      NON_EXPORTED_BASE(public OutputDevice),
      public AudioConverter::InputCallback {
 public:
  typedef base::Callback<AudioRendererMixer*(const AudioParameters& params,
                                             const std::string& device_id,
                                             const url::Origin& security_origin,
                                             OutputDeviceStatus* device_status)>
      GetMixerCB;
  typedef base::Callback<void(const AudioParameters& params,
                              const std::string& device_id,
                              const url::Origin& security_origin)>
      RemoveMixerCB;

  typedef base::Callback<AudioParameters(const std::string& device_id,
                                         const url::Origin& security_origin)>
      GetHardwareParamsCB;

  AudioRendererMixerInput(const GetMixerCB& get_mixer_cb,
                          const RemoveMixerCB& remove_mixer_cb,
                          const GetHardwareParamsCB& get_hardware_params_cb,
                          const std::string& device_id,
                          const url::Origin& security_origin);

  // RestartableAudioRendererSink implementation.
  void Start() override;
  void Stop() override;
  void Play() override;
  void Pause() override;
  bool SetVolume(double volume) override;
  OutputDevice* GetOutputDevice() override;
  void Initialize(const AudioParameters& params,
                  AudioRendererSink::RenderCallback* renderer) override;

  // OutputDevice implementation.
  void SwitchOutputDevice(const std::string& device_id,
                          const url::Origin& security_origin,
                          const SwitchOutputDeviceCB& callback) override;
  AudioParameters GetOutputParameters() override;
  OutputDeviceStatus GetDeviceStatus() override;

  // Called by AudioRendererMixer when an error occurs.
  void OnRenderError();

 protected:
  ~AudioRendererMixerInput() override;

 private:
  friend class AudioRendererMixerInputTest;

  bool started_;
  bool playing_;
  double volume_;

  // AudioConverter::InputCallback implementation.
  double ProvideInput(AudioBus* audio_bus,
                      base::TimeDelta buffer_delay) override;

  // Callbacks provided during construction which allow AudioRendererMixerInput
  // to retrieve a mixer during Initialize() and notify when it's done with it.
  const GetMixerCB get_mixer_cb_;
  const RemoveMixerCB remove_mixer_cb_;

  // Callbacks provided during construction which allows AudioRendererMixerInput
  // to access hardware output parameters when it is detached from the mixer.
  const GetHardwareParamsCB get_hardware_params_cb_;

  // AudioParameters received during Initialize().
  AudioParameters params_;

  // ID of hardware device to use
  std::string device_id_;
  url::Origin security_origin_;

  // AudioRendererMixer provided through |get_mixer_cb_| during Initialize(),
  // guaranteed to live (at least) until |remove_mixer_cb_| is called.
  AudioRendererMixer* mixer_;

  // Source of audio data which is provided to the mixer.
  AudioRendererSink::RenderCallback* callback_;

  // Error callback for handing to AudioRendererMixer.
  const base::Closure error_cb_;

  // Pending switch-device callback, in case SwitchOutputDevice() is invoked
  // before Start()
  SwitchOutputDeviceCB pending_switch_callback_;
  std::string pending_switch_device_id_;
  url::Origin pending_switch_security_origin_;

  DISALLOW_COPY_AND_ASSIGN(AudioRendererMixerInput);
};

}  // namespace media

#endif  // MEDIA_BASE_AUDIO_RENDERER_MIXER_INPUT_H_