1 | /* |
2 | * Copyright (C) 2010, Google Inc. All rights reserved. |
3 | * |
4 | * Redistribution and use in source and binary forms, with or without |
5 | * modification, are permitted provided that the following conditions |
6 | * are met: |
7 | * 1. Redistributions of source code must retain the above copyright |
8 | * notice, this list of conditions and the following disclaimer. |
9 | * 2. Redistributions in binary form must reproduce the above copyright |
10 | * notice, this list of conditions and the following disclaimer in the |
11 | * documentation and/or other materials provided with the distribution. |
12 | * |
13 | * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY |
14 | * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED |
15 | * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
16 | * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY |
17 | * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES |
18 | * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
19 | * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON |
20 | * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
21 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
22 | * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
23 | */ |
24 | |
25 | #pragma once |
26 | |
27 | #include "AudioBus.h" |
28 | #include "AudioIOCallback.h" |
29 | #include "AudioNode.h" |
30 | #include <wtf/Function.h> |
31 | |
32 | namespace WebCore { |
33 | |
34 | class AudioContext; |
35 | |
36 | class AudioDestinationNode : public AudioNode, public AudioIOCallback { |
37 | WTF_MAKE_ISO_ALLOCATED(AudioDestinationNode); |
38 | public: |
39 | AudioDestinationNode(AudioContext&, float sampleRate); |
40 | virtual ~AudioDestinationNode(); |
41 | |
42 | // AudioNode |
43 | void process(size_t) override { }; // we're pulled by hardware so this is never called |
44 | void reset() override { m_currentSampleFrame = 0; } |
45 | |
46 | // The audio hardware calls render() to get the next render quantum of audio into destinationBus. |
47 | // It will optionally give us local/live audio input in sourceBus (if it's not 0). |
48 | void render(AudioBus* sourceBus, AudioBus* destinationBus, size_t numberOfFrames) override; |
49 | |
50 | size_t currentSampleFrame() const { return m_currentSampleFrame; } |
51 | double currentTime() const { return currentSampleFrame() / static_cast<double>(sampleRate()); } |
52 | |
53 | virtual unsigned maxChannelCount() const { return 0; } |
54 | |
55 | // Enable local/live input for the specified device. |
56 | virtual void enableInput(const String& inputDeviceId) = 0; |
57 | |
58 | virtual void startRendering() = 0; |
59 | virtual void resume(WTF::Function<void ()>&&) { } |
60 | virtual void suspend(WTF::Function<void ()>&&) { } |
61 | virtual void close(WTF::Function<void ()>&&) { } |
62 | |
63 | virtual bool isPlaying() { return false; } |
64 | void isPlayingDidChange() override; |
65 | bool isPlayingAudio() const { return m_isEffectivelyPlayingAudio; } |
66 | void setMuted(bool muted) { m_muted = muted; } |
67 | |
68 | protected: |
69 | double tailTime() const override { return 0; } |
70 | double latencyTime() const override { return 0; } |
71 | |
72 | void setIsSilent(bool); |
73 | void updateIsEffectivelyPlayingAudio(); |
74 | |
75 | // Counts the number of sample-frames processed by the destination. |
76 | size_t m_currentSampleFrame; |
77 | |
78 | bool m_isSilent; |
79 | bool m_isEffectivelyPlayingAudio; |
80 | bool m_muted; |
81 | }; |
82 | |
83 | } // namespace WebCore |
84 | |