Make passing PlatformAudioData in audioSamplesAvaliable const-correct.
[WebKit-https.git] / Source / WebCore / platform / audio / mac / AudioSampleDataSource.cpp
1 /*
2  * Copyright (C) 2017 Apple 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. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #include "config.h"
27 #include "AudioSampleDataSource.h"
28
29 #if ENABLE(MEDIA_STREAM)
30
31 #include "CAAudioStreamDescription.h"
32 #include "CARingBuffer.h"
33 #include "Logging.h"
34 #include "MediaTimeAVFoundation.h"
35 #include <AudioToolbox/AudioConverter.h>
36 #include <mach/mach.h>
37 #include <mach/mach_time.h>
38 #include <mutex>
39 #include <syslog.h>
40 #include <wtf/CurrentTime.h>
41 #include <wtf/StringPrintStream.h>
42
43 #include "CoreMediaSoftLink.h"
44
45 namespace WebCore {
46
47 using namespace JSC;
48
49 Ref<AudioSampleDataSource> AudioSampleDataSource::create(size_t maximumSampleCount)
50 {
51     return adoptRef(*new AudioSampleDataSource(maximumSampleCount));
52 }
53
54 AudioSampleDataSource::AudioSampleDataSource(size_t maximumSampleCount)
55     : m_inputSampleOffset(MediaTime::invalidTime())
56     , m_maximumSampleCount(maximumSampleCount)
57 {
58 }
59
60 AudioSampleDataSource::~AudioSampleDataSource()
61 {
62     m_inputDescription = nullptr;
63     m_outputDescription = nullptr;
64     m_ringBuffer = nullptr;
65     if (m_converter) {
66         AudioConverterDispose(m_converter);
67         m_converter = nullptr;
68     }
69 }
70
71 void AudioSampleDataSource::setPaused(bool paused)
72 {
73     std::lock_guard<Lock> lock(m_lock);
74
75     if (paused == m_paused)
76         return;
77
78     m_transitioningFromPaused = m_paused;
79     m_paused = paused;
80 }
81
82 OSStatus AudioSampleDataSource::setupConverter()
83 {
84     ASSERT(m_inputDescription && m_outputDescription);
85
86     if (m_converter) {
87         AudioConverterDispose(m_converter);
88         m_converter = nullptr;
89     }
90
91     if (*m_inputDescription == *m_outputDescription)
92         return 0;
93
94     OSStatus err = AudioConverterNew(&m_inputDescription->streamDescription(), &m_outputDescription->streamDescription(), &m_converter);
95     if (err)
96         LOG_ERROR("AudioSampleDataSource::setupConverter(%p) - AudioConverterNew returned error %d (%.4s)", this, (int)err, (char*)&err);
97
98     return err;
99
100 }
101
102 OSStatus AudioSampleDataSource::setInputFormat(const CAAudioStreamDescription& format)
103 {
104     ASSERT(format.sampleRate() >= 0);
105
106     m_inputDescription = std::make_unique<CAAudioStreamDescription>(format);
107     if (m_outputDescription)
108         return setupConverter();
109
110     return 0;
111 }
112
113 OSStatus AudioSampleDataSource::setOutputFormat(const CAAudioStreamDescription& format)
114 {
115     ASSERT(m_inputDescription);
116     ASSERT(format.sampleRate() >= 0);
117
118     m_outputDescription = std::make_unique<CAAudioStreamDescription>(format);
119     if (!m_ringBuffer)
120         m_ringBuffer = std::make_unique<CARingBuffer>();
121
122     m_ringBuffer->allocate(format, static_cast<size_t>(m_maximumSampleCount));
123     m_scratchBuffer = AudioSampleBufferList::create(m_outputDescription->streamDescription(), m_maximumSampleCount);
124
125     return setupConverter();
126 }
127
128 MediaTime AudioSampleDataSource::hostTime() const
129 {
130     // Based on listing #2 from Apple Technical Q&A QA1398, modified to be thread-safe.
131     static double frequency;
132     static mach_timebase_info_data_t timebaseInfo;
133     static std::once_flag initializeTimerOnceFlag;
134     std::call_once(initializeTimerOnceFlag, [] {
135         kern_return_t kr = mach_timebase_info(&timebaseInfo);
136         frequency = 1e-9 * static_cast<double>(timebaseInfo.numer) / static_cast<double>(timebaseInfo.denom);
137         ASSERT_UNUSED(kr, kr == KERN_SUCCESS);
138         ASSERT(timebaseInfo.denom);
139     });
140
141     return MediaTime::createWithDouble(mach_absolute_time() * frequency);
142 }
143
144 void AudioSampleDataSource::pushSamplesInternal(const AudioBufferList& bufferList, const MediaTime& presentationTime, size_t sampleCount)
145 {
146     ASSERT(m_lock.isHeld());
147
148     const AudioBufferList* sampleBufferList;
149     if (m_converter) {
150         m_scratchBuffer->reset();
151         OSStatus err = m_scratchBuffer->copyFrom(bufferList, m_converter);
152         if (err)
153             return;
154
155         sampleBufferList = m_scratchBuffer->bufferList().list();
156     } else
157         sampleBufferList = &bufferList;
158
159     MediaTime sampleTime = presentationTime;
160     if (m_inputSampleOffset == MediaTime::invalidTime()) {
161         m_inputSampleOffset = MediaTime(1 - sampleTime.timeValue(), sampleTime.timeScale());
162         if (m_inputSampleOffset.timeScale() != sampleTime.timeScale()) {
163             // FIXME: It should be possible to do this without calling CMTimeConvertScale.
164             m_inputSampleOffset = toMediaTime(CMTimeConvertScale(toCMTime(m_inputSampleOffset), sampleTime.timeScale(), kCMTimeRoundingMethod_Default));
165         }
166         LOG(MediaCaptureSamples, "@@ pushSamples: input sample offset is %lld, m_maximumSampleCount = %zu", m_inputSampleOffset.timeValue(), m_maximumSampleCount);
167     }
168     sampleTime += m_inputSampleOffset;
169
170 #if !LOG_DISABLED
171     uint64_t startFrame1 = 0;
172     uint64_t endFrame1 = 0;
173     m_ringBuffer->getCurrentFrameBounds(startFrame1, endFrame1);
174 #endif
175
176     m_ringBuffer->store(sampleBufferList, sampleCount, sampleTime.timeValue());
177     m_timeStamp = sampleTime.timeValue();
178
179     LOG(MediaCaptureSamples, "@@ pushSamples: added %ld samples for time = %s (was %s), mach time = %lld", sampleCount, toString(sampleTime).utf8().data(), toString(presentationTime).utf8().data(), mach_absolute_time());
180
181 #if !LOG_DISABLED
182     uint64_t startFrame2 = 0;
183     uint64_t endFrame2 = 0;
184     m_ringBuffer->getCurrentFrameBounds(startFrame2, endFrame2);
185     LOG(MediaCaptureSamples, "@@ pushSamples: buffered range was [%lld .. %lld], is [%lld .. %lld]", startFrame1, endFrame1, startFrame2, endFrame2);
186 #endif
187 }
188
189 void AudioSampleDataSource::pushSamples(const AudioStreamBasicDescription& sampleDescription, CMSampleBufferRef sampleBuffer)
190 {
191     std::lock_guard<Lock> lock(m_lock);
192
193     ASSERT_UNUSED(sampleDescription, *m_inputDescription == sampleDescription);
194     ASSERT(m_ringBuffer);
195     
196     WebAudioBufferList list(*m_inputDescription, sampleBuffer);
197     pushSamplesInternal(list, toMediaTime(CMSampleBufferGetPresentationTimeStamp(sampleBuffer)), CMSampleBufferGetNumSamples(sampleBuffer));
198 }
199
200 void AudioSampleDataSource::pushSamples(const MediaTime& sampleTime, const PlatformAudioData& audioData, size_t sampleCount)
201 {
202     std::unique_lock<Lock> lock(m_lock, std::try_to_lock);
203     ASSERT(is<WebAudioBufferList>(audioData));
204     pushSamplesInternal(downcast<WebAudioBufferList>(audioData), sampleTime, sampleCount);
205 }
206
207 bool AudioSampleDataSource::pullSamplesInternal(AudioBufferList& buffer, size_t& sampleCount, uint64_t timeStamp, double /*hostTime*/, PullMode mode)
208 {
209     ASSERT(m_lock.isHeld());
210
211     ASSERT(buffer.mNumberBuffers == m_ringBuffer->channelCount());
212     if (buffer.mNumberBuffers != m_ringBuffer->channelCount()) {
213         AudioSampleBufferList::zeroABL(buffer, sampleCount);
214         sampleCount = 0;
215         return false;
216     }
217
218     if (!m_ringBuffer || m_muted || m_inputSampleOffset == MediaTime::invalidTime()) {
219         AudioSampleBufferList::zeroABL(buffer, sampleCount);
220         sampleCount = 0;
221         return false;
222     }
223
224     uint64_t startFrame = 0;
225     uint64_t endFrame = 0;
226     m_ringBuffer->getCurrentFrameBounds(startFrame, endFrame);
227
228     if (m_transitioningFromPaused) {
229         uint64_t buffered = endFrame - m_timeStamp;
230         if (buffered < sampleCount * 2) {
231             AudioSampleBufferList::zeroABL(buffer, sampleCount);
232             sampleCount = 0;
233             return false;
234         }
235
236         const double twentyMS = .02;
237         const double tenMS = .01;
238         const double fiveMS = .005;
239         double sampleRate = m_outputDescription->sampleRate();
240         m_outputSampleOffset = timeStamp + m_timeStamp;
241         if (buffered > sampleRate * twentyMS)
242             m_outputSampleOffset -= sampleRate * twentyMS;
243         else if (buffered > sampleRate * tenMS)
244             m_outputSampleOffset -= sampleRate * tenMS;
245         else if (buffered > sampleRate * fiveMS)
246             m_outputSampleOffset -= sampleRate * fiveMS;
247
248         m_transitioningFromPaused = false;
249     }
250
251     timeStamp += m_outputSampleOffset;
252
253     LOG(MediaCaptureSamples, "** pullSamples: asking for %ld samples at time = %lld (was %lld)", sampleCount, timeStamp, timeStamp - m_outputSampleOffset);
254
255     int64_t framesAvailable = sampleCount;
256     if (timeStamp < startFrame || timeStamp + sampleCount > endFrame) {
257         if (timeStamp + sampleCount < startFrame || timeStamp > endFrame)
258             framesAvailable = 0;
259         else if (timeStamp < startFrame)
260             framesAvailable = timeStamp + sampleCount - startFrame;
261         else
262             framesAvailable = timeStamp + sampleCount - endFrame;
263
264         LOG(MediaCaptureSamples, "** pullSamplesInternal: sample %lld is not completely in range [%lld .. %lld], returning %lld frames", timeStamp, startFrame, endFrame, framesAvailable);
265
266         if (!framesAvailable) {
267             AudioSampleBufferList::zeroABL(buffer, sampleCount);
268             return false;
269         }
270     }
271
272     if (m_volume >= .95) {
273         m_ringBuffer->fetch(&buffer, sampleCount, timeStamp, mode == Copy ? CARingBuffer::Copy : CARingBuffer::Mix);
274         return true;
275     }
276
277     if (m_scratchBuffer->copyFrom(*m_ringBuffer.get(), sampleCount, timeStamp, mode == Copy ? CARingBuffer::Copy : CARingBuffer::Mix)) {
278         AudioSampleBufferList::zeroABL(buffer, sampleCount);
279         return false;
280     }
281
282     m_scratchBuffer->applyGain(m_volume);
283     if (m_scratchBuffer->copyTo(buffer, sampleCount))
284         AudioSampleBufferList::zeroABL(buffer, sampleCount);
285
286     return true;
287 }
288
289 bool AudioSampleDataSource::pullSamples(AudioBufferList& buffer, size_t sampleCount, uint64_t timeStamp, double hostTime, PullMode mode)
290 {
291     std::unique_lock<Lock> lock(m_lock, std::try_to_lock);
292     if (!lock.owns_lock() || !m_ringBuffer) {
293         AudioSampleBufferList::zeroABL(buffer, sampleCount);
294         return false;
295     }
296
297     return pullSamplesInternal(buffer, sampleCount, timeStamp, hostTime, mode);
298 }
299
300 bool AudioSampleDataSource::pullSamples(AudioSampleBufferList& buffer, size_t sampleCount, uint64_t timeStamp, double hostTime, PullMode mode)
301 {
302     std::unique_lock<Lock> lock(m_lock, std::try_to_lock);
303     if (!lock.owns_lock() || !m_ringBuffer) {
304         buffer.zero();
305         return false;
306     }
307
308     if (!pullSamplesInternal(buffer.bufferList(), sampleCount, timeStamp, hostTime, mode))
309         return false;
310
311     buffer.setTimes(timeStamp, hostTime);
312     buffer.setSampleCount(sampleCount);
313
314     return true;
315 }
316
317 } // namespace WebCore
318
319 #endif // ENABLE(MEDIA_STREAM)