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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
|
/*
* Copyright (C) 2013 Google Inc. All rights reserved.
* Copyright (C) 2013-2020 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following disclaimer
* in the documentation and/or other materials provided with the
* distribution.
* * Neither the name of Google Inc. nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#pragma once
#if ENABLE(MEDIA_SOURCE)
#include "InbandTextTrackPrivate.h"
#include "MediaDescription.h"
#include "MediaPlayer.h"
#include "MediaSample.h"
#include "PlatformTimeRanges.h"
#include "SampleMap.h"
#include "SourceBufferPrivateClient.h"
#include "TimeRanges.h"
#include <optional>
#include <wtf/Deque.h>
#include <wtf/Forward.h>
#include <wtf/Logger.h>
#include <wtf/LoggerHelper.h>
#include <wtf/NativePromise.h>
#include <wtf/Ref.h>
#include <wtf/StdUnorderedMap.h>
#include <wtf/ThreadSafeWeakPtr.h>
#include <wtf/UniqueRef.h>
#include <wtf/WeakPtr.h>
#include <wtf/WorkQueue.h>
namespace WebCore {
class MediaSourcePrivate;
class SharedBuffer;
class TrackBuffer;
class TimeRanges;
#if ENABLE(ENCRYPTED_MEDIA)
class CDMInstance;
#endif
#if ENABLE(LEGACY_ENCRYPTED_MEDIA)
class LegacyCDMSession;
#endif
enum class SourceBufferAppendMode : uint8_t {
Segments,
Sequence
};
class SourceBufferPrivate
: public ThreadSafeRefCountedAndCanMakeThreadSafeWeakPtr<SourceBufferPrivate, WTF::DestructionThread::Main>
#if !RELEASE_LOG_DISABLED
, public LoggerHelper
#endif
{
public:
WEBCORE_EXPORT SourceBufferPrivate(MediaSourcePrivate&);
WEBCORE_EXPORT virtual ~SourceBufferPrivate();
virtual constexpr MediaPlatformType platformType() const = 0;
WEBCORE_EXPORT virtual void setActive(bool);
WEBCORE_EXPORT virtual Ref<MediaPromise> append(Ref<SharedBuffer>&&);
virtual void abort();
// Overrides must call the base class.
virtual void resetParserState();
virtual void removedFromMediaSource();
virtual bool canSwitchToType(const ContentType&) { return false; }
WEBCORE_EXPORT virtual void setMediaSourceEnded(bool);
virtual void setMode(SourceBufferAppendMode mode) { m_appendMode = mode; }
WEBCORE_EXPORT virtual void reenqueueMediaIfNeeded(const MediaTime& currentMediaTime);
WEBCORE_EXPORT virtual void addTrackBuffer(TrackID, RefPtr<MediaDescription>&&);
WEBCORE_EXPORT virtual void resetTrackBuffers();
WEBCORE_EXPORT virtual void clearTrackBuffers(bool shouldReportToClient = false);
WEBCORE_EXPORT virtual void setAllTrackBuffersNeedRandomAccess();
virtual void setGroupStartTimestamp(const MediaTime& mediaTime) { m_groupStartTimestamp = mediaTime; }
virtual void setGroupStartTimestampToEndTimestamp() { m_groupStartTimestamp = m_groupEndTimestamp; }
virtual void setShouldGenerateTimestamps(bool flag) { m_shouldGenerateTimestamps = flag; }
WEBCORE_EXPORT virtual Ref<MediaPromise> removeCodedFrames(const MediaTime& start, const MediaTime& end, const MediaTime& currentMediaTime);
WEBCORE_EXPORT virtual void evictCodedFrames(uint64_t newDataSize, uint64_t maximumBufferSize, const MediaTime& currentTime);
WEBCORE_EXPORT virtual size_t platformEvictionThreshold() const;
WEBCORE_EXPORT virtual uint64_t totalTrackBufferSizeInBytes() const;
WEBCORE_EXPORT virtual void resetTimestampOffsetInTrackBuffers();
virtual void startChangingType() { m_pendingInitializationSegmentForChangeType = true; }
virtual void setTimestampOffset(const MediaTime& timestampOffset) { m_timestampOffset = timestampOffset; }
virtual void setAppendWindowStart(const MediaTime& appendWindowStart) { m_appendWindowStart = appendWindowStart;}
virtual void setAppendWindowEnd(const MediaTime& appendWindowEnd) { m_appendWindowEnd = appendWindowEnd; }
using ComputeSeekPromise = MediaTimePromise;
WEBCORE_EXPORT virtual Ref<ComputeSeekPromise> computeSeekTime(const SeekTarget&);
WEBCORE_EXPORT virtual void seekToTime(const MediaTime&);
WEBCORE_EXPORT virtual void updateTrackIds(Vector<std::pair<TrackID, TrackID>>&& trackIdPairs);
WEBCORE_EXPORT void setClient(SourceBufferPrivateClient&);
WEBCORE_EXPORT void detach();
void setMediaSourceDuration(const MediaTime& duration) { m_mediaSourceDuration = duration; }
bool isBufferFullFor(uint64_t requiredSize, uint64_t maximumBufferSize);
WEBCORE_EXPORT Vector<PlatformTimeRanges> trackBuffersRanges() const;
// Methods used by MediaSourcePrivate
bool hasAudio() const { return m_hasAudio; }
bool hasVideo() const { return m_hasVideo; }
bool hasReceivedFirstInitializationSegment() const { return m_receivedFirstInitializationSegment; }
MediaTime timestampOffset() const { return m_timestampOffset; }
virtual size_t platformMaximumBufferSize() const { return 0; }
// Methods for ManagedSourceBuffer
WEBCORE_EXPORT virtual void memoryPressure(uint64_t maximumBufferSize, const MediaTime& currentTime);
// Internals Utility methods
using SamplesPromise = NativePromise<Vector<String>, int>;
WEBCORE_EXPORT virtual Ref<SamplesPromise> bufferedSamplesForTrackId(TrackID);
WEBCORE_EXPORT virtual Ref<SamplesPromise> enqueuedSamplesForTrackID(TrackID);
virtual MediaTime minimumUpcomingPresentationTimeForTrackID(TrackID) { return MediaTime::invalidTime(); }
virtual void setMaximumQueueDepthForTrackID(TrackID, uint64_t) { }
#if !RELEASE_LOG_DISABLED
virtual const Logger& sourceBufferLogger() const = 0;
virtual const void* sourceBufferLogIdentifier() = 0;
#endif
#if ENABLE(LEGACY_ENCRYPTED_MEDIA)
virtual void setCDMSession(LegacyCDMSession*) { }
#endif
#if ENABLE(ENCRYPTED_MEDIA)
virtual void setCDMInstance(CDMInstance*) { }
virtual bool waitingForKey() const { return false; }
virtual void attemptToDecrypt() { }
#endif
protected:
MediaTime currentMediaTime() const;
MediaTime mediaSourceDuration() const;
using InitializationSegment = SourceBufferPrivateClient::InitializationSegment;
WEBCORE_EXPORT void didReceiveInitializationSegment(InitializationSegment&&);
WEBCORE_EXPORT void didUpdateFormatDescriptionForTrackId(Ref<TrackInfo>&&, uint64_t);
WEBCORE_EXPORT void didReceiveSample(Ref<MediaSample>&&);
virtual Ref<MediaPromise> appendInternal(Ref<SharedBuffer>&&) = 0;
virtual void resetParserStateInternal() = 0;
virtual MediaTime timeFudgeFactor() const { return PlatformTimeRanges::timeFudgeFactor(); }
bool isActive() const { return m_isActive; }
virtual bool isSeeking() const { return false; }
virtual void flush(TrackID) { }
virtual void enqueueSample(Ref<MediaSample>&&, TrackID) { }
virtual void allSamplesInTrackEnqueued(TrackID) { }
virtual bool isReadyForMoreSamples(TrackID) { return false; }
virtual void notifyClientWhenReadyForMoreSamples(TrackID) { }
virtual bool canSetMinimumUpcomingPresentationTime(TrackID) const { return false; }
virtual void setMinimumUpcomingPresentationTime(TrackID, const MediaTime&) { }
virtual void clearMinimumUpcomingPresentationTime(TrackID) { }
void reenqueSamples(TrackID);
virtual bool precheckInitializationSegment(const InitializationSegment&) { return true; }
virtual void processInitializationSegment(std::optional<InitializationSegment>&&) { }
virtual void processFormatDescriptionForTrackId(Ref<TrackInfo>&&, uint64_t) { }
void provideMediaData(TrackID);
virtual bool isMediaSampleAllowed(const MediaSample&) const { return true; }
// Must be called once all samples have been processed.
WEBCORE_EXPORT void appendCompleted(bool parsingSucceeded, Function<void()>&& = [] { });
WEBCORE_EXPORT RefPtr<SourceBufferPrivateClient> client() const;
ThreadSafeWeakPtr<MediaSourcePrivate> m_mediaSource { nullptr };
private:
MediaTime minimumBufferedTime() const;
MediaTime maximumBufferedTime() const;
Ref<MediaPromise> updateBuffered();
void updateHighestPresentationTimestamp();
void updateMinimumUpcomingPresentationTime(TrackBuffer&, TrackID);
void reenqueueMediaForTime(TrackBuffer&, TrackID, const MediaTime&);
bool validateInitializationSegment(const InitializationSegment&);
void provideMediaData(TrackBuffer&, TrackID);
void setBufferedDirty(bool);
void trySignalAllSamplesInTrackEnqueued(TrackBuffer&, TrackID);
MediaTime findPreviousSyncSamplePresentationTime(const MediaTime&);
void removeCodedFramesInternal(const MediaTime& start, const MediaTime& end, const MediaTime& currentMediaTime);
bool evictFrames(uint64_t newDataSize, uint64_t maximumBufferSize, const MediaTime& currentTime);
bool hasTooManySamples() const;
void iterateTrackBuffers(Function<void(TrackBuffer&)>&&);
void iterateTrackBuffers(Function<void(const TrackBuffer&)>&&) const;
bool m_hasAudio { false };
bool m_hasVideo { false };
bool m_isActive { false };
ThreadSafeWeakPtr<SourceBufferPrivateClient> m_client;
StdUnorderedMap<TrackID, UniqueRef<TrackBuffer>> m_trackBufferMap;
SourceBufferAppendMode m_appendMode { SourceBufferAppendMode::Segments };
using OperationPromise = NativePromise<void, PlatformMediaError, WTF::PromiseOption::Default | WTF::PromiseOption::NonExclusive>;
Ref<OperationPromise> m_currentSourceBufferOperation { OperationPromise::createAndResolve() };
bool m_shouldGenerateTimestamps { false };
bool m_receivedFirstInitializationSegment { false };
bool m_pendingInitializationSegmentForChangeType { false };
size_t m_abortCount { 0 };
void processPendingMediaSamples();
bool processMediaSample(SourceBufferPrivateClient&, Ref<MediaSample>&&);
using SamplesVector = Vector<Ref<MediaSample>>;
SamplesVector m_pendingSamples;
Ref<MediaPromise> m_currentAppendProcessing { MediaPromise::createAndResolve() };
MediaTime m_timestampOffset;
MediaTime m_appendWindowStart { MediaTime::zeroTime() };
MediaTime m_appendWindowEnd { MediaTime::positiveInfiniteTime() };
MediaTime m_highestPresentationTimestamp;
MediaTime m_mediaSourceDuration { MediaTime::invalidTime() };
MediaTime m_groupStartTimestamp { MediaTime::invalidTime() };
MediaTime m_groupEndTimestamp { MediaTime::zeroTime() };
bool m_isMediaSourceEnded { false };
};
} // namespace WebCore
#endif
|
