92f248568dec9a1b3299e6a073d84ee4ae5f36da
[WebKit-https.git] / Source / WebCore / platform / graphics / MediaPlayer.h
1 /*
2  * Copyright (C) 2007-2014 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 #ifndef MediaPlayer_h
27 #define MediaPlayer_h
28
29 #if ENABLE(VIDEO)
30 #include "GraphicsTypes3D.h"
31
32 #include "AudioTrackPrivate.h"
33 #include "ContentType.h"
34 #include "LegacyCDMSession.h"
35 #include "InbandTextTrackPrivate.h"
36 #include "IntRect.h"
37 #include "URL.h"
38 #include "LayoutRect.h"
39 #include "MediaPlayerEnums.h"
40 #include "NativeImage.h"
41 #include "PlatformLayer.h"
42 #include "PlatformMediaResourceLoader.h"
43 #include "PlatformMediaSession.h"
44 #include "SecurityOriginHash.h"
45 #include "Timer.h"
46 #include "VideoTrackPrivate.h"
47 #include <runtime/Uint8Array.h>
48 #include <wtf/Forward.h>
49 #include <wtf/Function.h>
50 #include <wtf/HashSet.h>
51 #include <wtf/MediaTime.h>
52 #include <wtf/Noncopyable.h>
53 #include <wtf/Ref.h>
54 #include <wtf/RefCounted.h>
55 #include <wtf/text/StringHash.h>
56
57 #if ENABLE(AVF_CAPTIONS)
58 #include "PlatformTextTrack.h"
59 #endif
60
61 OBJC_CLASS AVAsset;
62 OBJC_CLASS AVPlayer;
63 OBJC_CLASS NSArray;
64 OBJC_CLASS QTMovie;
65
66 class AVCFPlayer;
67 class QTMovieGWorld;
68 class QTMovieVisualContext;
69
70 namespace WebCore {
71
72 class AudioSourceProvider;
73 class AuthenticationChallenge;
74 class MediaPlaybackTarget;
75 #if ENABLE(MEDIA_SOURCE)
76 class MediaSourcePrivateClient;
77 #endif
78 #if ENABLE(MEDIA_STREAM)
79 class MediaStreamPrivate;
80 #endif
81 class MediaPlayerPrivateInterface;
82 class TextTrackRepresentation;
83 struct Cookie;
84
85 // Structure that will hold every native
86 // types supported by the current media player.
87 // We have to do that has multiple media players
88 // backend can live at runtime.
89 struct PlatformMedia {
90     enum {
91         None,
92         QTMovieType,
93         QTMovieGWorldType,
94         QTMovieVisualContextType,
95         AVFoundationMediaPlayerType,
96         AVFoundationCFMediaPlayerType,
97         AVFoundationAssetType,
98     } type;
99
100     union {
101         QTMovie* qtMovie;
102         QTMovieGWorld* qtMovieGWorld;
103         QTMovieVisualContext* qtMovieVisualContext;
104         AVPlayer* avfMediaPlayer;
105         AVCFPlayer* avcfMediaPlayer;
106         AVAsset* avfAsset;
107     } media;
108 };
109
110 struct MediaEngineSupportParameters {
111
112     MediaEngineSupportParameters() { }
113
114     ContentType type;
115     URL url;
116     bool isMediaSource { false };
117     bool isMediaStream { false };
118     Vector<ContentType> contentTypesRequiringHardwareSupport;
119 };
120
121 extern const PlatformMedia NoPlatformMedia;
122
123 class CDMSessionClient;
124 class CachedResourceLoader;
125 class ContentType;
126 class GraphicsContext;
127 class GraphicsContext3D;
128 class IntRect;
129 class IntSize;
130 class MediaPlayer;
131 class PlatformTimeRanges;
132
133 struct MediaPlayerFactory;
134
135 #if PLATFORM(WIN) && USE(AVFOUNDATION)
136 struct GraphicsDeviceAdapter;
137 #endif
138
139 #if USE(GSTREAMER)
140 class MediaPlayerRequestInstallMissingPluginsCallback;
141 #endif
142
143 class MediaPlayerClient {
144 public:
145     virtual ~MediaPlayerClient() { }
146
147     // the network state has changed
148     virtual void mediaPlayerNetworkStateChanged(MediaPlayer*) { }
149
150     // the ready state has changed
151     virtual void mediaPlayerReadyStateChanged(MediaPlayer*) { }
152
153     // the volume state has changed
154     virtual void mediaPlayerVolumeChanged(MediaPlayer*) { }
155
156     // the mute state has changed
157     virtual void mediaPlayerMuteChanged(MediaPlayer*) { }
158
159     // time has jumped, eg. not as a result of normal playback
160     virtual void mediaPlayerTimeChanged(MediaPlayer*) { }
161
162     // the media file duration has changed, or is now known
163     virtual void mediaPlayerDurationChanged(MediaPlayer*) { }
164
165     // the playback rate has changed
166     virtual void mediaPlayerRateChanged(MediaPlayer*) { }
167
168     // the play/pause status changed
169     virtual void mediaPlayerPlaybackStateChanged(MediaPlayer*) { }
170
171     // The MediaPlayer has found potentially problematic media content.
172     // This is used internally to trigger swapping from a <video>
173     // element to an <embed> in standalone documents
174     virtual void mediaPlayerSawUnsupportedTracks(MediaPlayer*) { }
175
176     // The MediaPlayer could not discover an engine which supports the requested resource.
177     virtual void mediaPlayerResourceNotSupported(MediaPlayer*) { }
178
179 // Presentation-related methods
180     // a new frame of video is available
181     virtual void mediaPlayerRepaint(MediaPlayer*) { }
182
183     // the movie size has changed
184     virtual void mediaPlayerSizeChanged(MediaPlayer*) { }
185
186     virtual void mediaPlayerEngineUpdated(MediaPlayer*) { }
187
188     // The first frame of video is available to render. A media engine need only make this callback if the
189     // first frame is not available immediately when prepareForRendering is called.
190     virtual void mediaPlayerFirstVideoFrameAvailable(MediaPlayer*) { }
191
192     // A characteristic of the media file, eg. video, audio, closed captions, etc, has changed.
193     virtual void mediaPlayerCharacteristicChanged(MediaPlayer*) { }
194     
195     // whether the rendering system can accelerate the display of this MediaPlayer.
196     virtual bool mediaPlayerRenderingCanBeAccelerated(MediaPlayer*) { return false; }
197
198     // called when the media player's rendering mode changed, which indicates a change in the
199     // availability of the platformLayer().
200     virtual void mediaPlayerRenderingModeChanged(MediaPlayer*) { }
201
202     // whether accelerated compositing is enabled for video rendering
203     virtual bool mediaPlayerAcceleratedCompositingEnabled() { return false; }
204
205     virtual void mediaPlayerActiveSourceBuffersChanged(const MediaPlayer*) { }
206
207 #if PLATFORM(WIN) && USE(AVFOUNDATION)
208     virtual GraphicsDeviceAdapter* mediaPlayerGraphicsDeviceAdapter(const MediaPlayer*) const { return 0; }
209 #endif
210
211 #if ENABLE(LEGACY_ENCRYPTED_MEDIA)
212     virtual RefPtr<ArrayBuffer> mediaPlayerCachedKeyForKeyId(const String&) const { return nullptr; }
213     virtual bool mediaPlayerKeyNeeded(MediaPlayer*, Uint8Array*) { return false; }
214     virtual String mediaPlayerMediaKeysStorageDirectory() const { return emptyString(); }
215 #endif
216     
217 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
218     virtual void mediaPlayerCurrentPlaybackTargetIsWirelessChanged(MediaPlayer*) { };
219 #endif
220
221     virtual String mediaPlayerReferrer() const { return String(); }
222     virtual String mediaPlayerUserAgent() const { return String(); }
223     virtual void mediaPlayerEnterFullscreen() { }
224     virtual void mediaPlayerExitFullscreen() { }
225     virtual bool mediaPlayerIsFullscreen() const { return false; }
226     virtual bool mediaPlayerIsFullscreenPermitted() const { return false; }
227     virtual bool mediaPlayerIsVideo() const { return false; }
228     virtual LayoutRect mediaPlayerContentBoxRect() const { return LayoutRect(); }
229     virtual float mediaPlayerContentsScale() const { return 1; }
230     virtual void mediaPlayerSetSize(const IntSize&) { }
231     virtual void mediaPlayerPause() { }
232     virtual void mediaPlayerPlay() { }
233     virtual bool mediaPlayerPlatformVolumeConfigurationRequired() const { return false; }
234     virtual bool mediaPlayerIsPaused() const { return true; }
235     virtual bool mediaPlayerIsLooping() const { return false; }
236     virtual CachedResourceLoader* mediaPlayerCachedResourceLoader() { return 0; }
237     virtual RefPtr<PlatformMediaResourceLoader> mediaPlayerCreateResourceLoader() { return nullptr; }
238     virtual bool doesHaveAttribute(const AtomicString&, AtomicString* = 0) const { return false; }
239     virtual bool mediaPlayerShouldUsePersistentCache() const { return true; }
240     virtual const String& mediaPlayerMediaCacheDirectory() const { return emptyString(); }
241
242 #if ENABLE(VIDEO_TRACK)
243     virtual void mediaPlayerDidAddAudioTrack(AudioTrackPrivate&) { }
244     virtual void mediaPlayerDidAddTextTrack(InbandTextTrackPrivate&) { }
245     virtual void mediaPlayerDidAddVideoTrack(VideoTrackPrivate&) { }
246     virtual void mediaPlayerDidRemoveAudioTrack(AudioTrackPrivate&) { }
247     virtual void mediaPlayerDidRemoveTextTrack(InbandTextTrackPrivate&) { }
248     virtual void mediaPlayerDidRemoveVideoTrack(VideoTrackPrivate&) { }
249
250     virtual void textTrackRepresentationBoundsChanged(const IntRect&) { }
251 #if ENABLE(AVF_CAPTIONS)
252     virtual Vector<RefPtr<PlatformTextTrack>> outOfBandTrackSources() { return Vector<RefPtr<PlatformTextTrack>>(); }
253 #endif
254 #endif
255
256 #if PLATFORM(IOS)
257     virtual String mediaPlayerNetworkInterfaceName() const { return String(); }
258     virtual bool mediaPlayerGetRawCookies(const URL&, Vector<Cookie>&) const { return false; }
259 #endif
260     
261     virtual bool mediaPlayerShouldWaitForResponseToAuthenticationChallenge(const AuthenticationChallenge&) { return false; }
262     virtual void mediaPlayerHandlePlaybackCommand(PlatformMediaSession::RemoteControlCommandType) { }
263
264     virtual String mediaPlayerSourceApplicationIdentifier() const { return emptyString(); }
265
266     virtual bool mediaPlayerIsInMediaDocument() const { return false; }
267     virtual void mediaPlayerEngineFailedToLoad() const { }
268
269     virtual double mediaPlayerRequestedPlaybackRate() const { return 0; }
270     virtual MediaPlayerEnums::VideoFullscreenMode mediaPlayerFullscreenMode() const { return MediaPlayerEnums::VideoFullscreenModeNone; }
271     virtual Vector<String> mediaPlayerPreferredAudioCharacteristics() const { return Vector<String>(); }
272
273 #if USE(GSTREAMER)
274     virtual void requestInstallMissingPlugins(const String&, const String&, MediaPlayerRequestInstallMissingPluginsCallback&) { };
275 #endif
276
277     virtual bool mediaPlayerShouldDisableSleep() const { return false; }
278     virtual const Vector<ContentType>& mediaContentTypesRequiringHardwareSupport() const;
279 };
280
281 class MediaPlayerSupportsTypeClient {
282 public:
283     virtual ~MediaPlayerSupportsTypeClient() { }
284
285     virtual bool mediaPlayerNeedsSiteSpecificHacks() const { return false; }
286     virtual String mediaPlayerDocumentHost() const { return String(); }
287 };
288
289 class MediaPlayer : public MediaPlayerEnums, public RefCounted<MediaPlayer> {
290     WTF_MAKE_NONCOPYABLE(MediaPlayer); WTF_MAKE_FAST_ALLOCATED;
291 public:
292     static Ref<MediaPlayer> create(MediaPlayerClient&);
293     virtual ~MediaPlayer();
294
295     void invalidate();
296
297     // Media engine support.
298     enum SupportsType { IsNotSupported, IsSupported, MayBeSupported };
299     static MediaPlayer::SupportsType supportsType(const MediaEngineSupportParameters&, const MediaPlayerSupportsTypeClient*);
300     static void getSupportedTypes(HashSet<String, ASCIICaseInsensitiveHash>&);
301     static bool isAvailable();
302     static HashSet<RefPtr<SecurityOrigin>> originsInMediaCache(const String& path);
303     static void clearMediaCache(const String& path, std::chrono::system_clock::time_point modifiedSince);
304     static void clearMediaCacheForOrigins(const String& path, const HashSet<RefPtr<SecurityOrigin>>&);
305     static bool supportsKeySystem(const String& keySystem, const String& mimeType);
306
307     bool supportsPictureInPicture() const;
308     bool supportsFullscreen() const;
309     bool supportsScanning() const;
310     bool canSaveMediaData() const;
311     bool requiresImmediateCompositing() const;
312     bool doesHaveAttribute(const AtomicString&, AtomicString* value = nullptr) const;
313     PlatformMedia platformMedia() const;
314     PlatformLayer* platformLayer() const;
315
316 #if PLATFORM(IOS) || (PLATFORM(MAC) && ENABLE(VIDEO_PRESENTATION_MODE))
317     void setVideoFullscreenLayer(PlatformLayer*, WTF::Function<void()>&& completionHandler = [] { });
318     void setVideoFullscreenFrame(FloatRect);
319     using MediaPlayerEnums::VideoGravity;
320     void setVideoFullscreenGravity(VideoGravity);
321     void setVideoFullscreenMode(VideoFullscreenMode);
322     VideoFullscreenMode fullscreenMode() const;
323 #endif
324
325 #if PLATFORM(IOS)
326     NSArray *timedMetadata() const;
327     String accessLog() const;
328     String errorLog() const;
329 #endif
330
331     FloatSize naturalSize();
332     bool hasVideo() const;
333     bool hasAudio() const;
334
335     bool inMediaDocument() const;
336
337     IntSize size() const { return m_size; }
338     void setSize(const IntSize& size);
339
340     bool load(const URL&, const ContentType&, const String& keySystem);
341 #if ENABLE(MEDIA_SOURCE)
342     bool load(const URL&, const ContentType&, MediaSourcePrivateClient*);
343 #endif
344 #if ENABLE(MEDIA_STREAM)
345     bool load(MediaStreamPrivate&);
346 #endif
347     void cancelLoad();
348
349     bool visible() const;
350     void setVisible(bool);
351
352     void prepareToPlay();
353     void play();
354     void pause();
355     void setShouldBufferData(bool);
356
357 #if ENABLE(LEGACY_ENCRYPTED_MEDIA)
358     // Represents synchronous exceptions that can be thrown from the Encrypted Media methods.
359     // This is different from the asynchronous MediaKeyError.
360     enum MediaKeyException { NoError, InvalidPlayerState, KeySystemNotSupported };
361
362     std::unique_ptr<CDMSession> createSession(const String& keySystem, CDMSessionClient*);
363     void setCDMSession(CDMSession*);
364     void keyAdded();
365 #endif
366
367     bool paused() const;
368     bool seeking() const;
369
370     static double invalidTime() { return -1.0;}
371     MediaTime duration() const;
372     MediaTime currentTime() const;
373     void seek(const MediaTime&);
374     void seekWithTolerance(const MediaTime&, const MediaTime& negativeTolerance, const MediaTime& positiveTolerance);
375
376     MediaTime startTime() const;
377     MediaTime initialTime() const;
378
379     MediaTime getStartDate() const;
380
381     double rate() const;
382     void setRate(double);
383     double requestedRate() const;
384
385     bool preservesPitch() const;
386     void setPreservesPitch(bool);
387
388     std::unique_ptr<PlatformTimeRanges> buffered();
389     std::unique_ptr<PlatformTimeRanges> seekable();
390     MediaTime minTimeSeekable();
391     MediaTime maxTimeSeekable();
392
393     double seekableTimeRangesLastModifiedTime();
394     double liveUpdateInterval();
395
396     bool didLoadingProgress();
397
398     double volume() const;
399     void setVolume(double);
400     bool platformVolumeConfigurationRequired() const { return client().mediaPlayerPlatformVolumeConfigurationRequired(); }
401
402     bool muted() const;
403     void setMuted(bool);
404
405     bool hasClosedCaptions() const;
406     void setClosedCaptionsVisible(bool closedCaptionsVisible);
407
408     void paint(GraphicsContext&, const FloatRect&);
409     void paintCurrentFrameInContext(GraphicsContext&, const FloatRect&);
410
411     // copyVideoTextureToPlatformTexture() is used to do the GPU-GPU textures copy without a readback to system memory.
412     // The first five parameters denote the corresponding GraphicsContext, destination texture, requested level, requested type and the required internalFormat for destination texture.
413     // The last two parameters premultiplyAlpha and flipY denote whether addtional premultiplyAlpha and flip operation are required during the copy.
414     // It returns true on success and false on failure.
415
416     // In the GPU-GPU textures copy, the source texture(Video texture) should have valid target, internalFormat and size, etc.
417     // The destination texture may need to be resized to to the dimensions of the source texture or re-defined to the required internalFormat.
418     // The current restrictions require that format shoud be RGB or RGBA, type should be UNSIGNED_BYTE and level should be 0. It may be lifted in the future.
419
420     // Each platform port can have its own implementation on this function. The default implementation for it is a single "return false" in MediaPlayerPrivate.h.
421     // In chromium, the implementation is based on GL_CHROMIUM_copy_texture extension which is documented at
422     // http://src.chromium.org/viewvc/chrome/trunk/src/gpu/GLES2/extensions/CHROMIUM/CHROMIUM_copy_texture.txt and implemented at
423     // http://src.chromium.org/viewvc/chrome/trunk/src/gpu/command_buffer/service/gles2_cmd_copy_texture_chromium.cc via shaders.
424     bool copyVideoTextureToPlatformTexture(GraphicsContext3D*, Platform3DObject texture, GC3Denum target, GC3Dint level, GC3Denum internalFormat, GC3Denum format, GC3Denum type, bool premultiplyAlpha, bool flipY);
425
426     NativeImagePtr nativeImageForCurrentTime();
427
428     using MediaPlayerEnums::NetworkState;
429     NetworkState networkState();
430
431     using MediaPlayerEnums::ReadyState;
432     ReadyState readyState();
433
434     using MediaPlayerEnums::MovieLoadType;
435     MovieLoadType movieLoadType() const;
436
437     using MediaPlayerEnums::Preload;
438     Preload preload() const;
439     void setPreload(Preload);
440
441     void networkStateChanged();
442     void readyStateChanged();
443     void volumeChanged(double);
444     void muteChanged(bool);
445     void timeChanged();
446     void sizeChanged();
447     void rateChanged();
448     void playbackStateChanged();
449     void durationChanged();
450     void firstVideoFrameAvailable();
451     void characteristicChanged();
452
453     void repaint();
454
455     MediaPlayerClient& client() const { return *m_client; }
456
457     bool hasAvailableVideoFrame() const;
458     void prepareForRendering();
459
460     bool canLoadPoster() const;
461     void setPoster(const String&);
462
463 #if USE(NATIVE_FULLSCREEN_VIDEO)
464     void enterFullscreen();
465     void exitFullscreen();
466 #endif
467
468 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
469     enum WirelessPlaybackTargetType { TargetTypeNone, TargetTypeAirPlay, TargetTypeTVOut };
470     WirelessPlaybackTargetType wirelessPlaybackTargetType() const;
471
472     String wirelessPlaybackTargetName() const;
473
474     bool wirelessVideoPlaybackDisabled() const;
475     void setWirelessVideoPlaybackDisabled(bool);
476
477     void currentPlaybackTargetIsWirelessChanged();
478     void playbackTargetAvailabilityChanged();
479
480     bool isCurrentPlaybackTargetWireless() const;
481     bool canPlayToWirelessPlaybackTarget() const;
482     void setWirelessPlaybackTarget(Ref<MediaPlaybackTarget>&&);
483
484     void setShouldPlayToPlaybackTarget(bool);
485 #endif
486
487     double minFastReverseRate() const;
488     double maxFastForwardRate() const;
489
490 #if USE(NATIVE_FULLSCREEN_VIDEO)
491     bool canEnterFullscreen() const;
492 #endif
493
494     // whether accelerated rendering is supported by the media engine for the current media.
495     bool supportsAcceleratedRendering() const;
496     // called when the rendering system flips the into or out of accelerated rendering mode.
497     void acceleratedRenderingStateChanged();
498
499     bool shouldMaintainAspectRatio() const;
500     void setShouldMaintainAspectRatio(bool);
501
502 #if PLATFORM(WIN) && USE(AVFOUNDATION)
503     GraphicsDeviceAdapter* graphicsDeviceAdapter() const;
504 #endif
505
506     bool hasSingleSecurityOrigin() const;
507
508     bool didPassCORSAccessCheck() const;
509
510     MediaTime mediaTimeForTimeValue(const MediaTime&) const;
511
512     double maximumDurationToCacheMediaTime() const;
513
514     unsigned decodedFrameCount() const;
515     unsigned droppedFrameCount() const;
516     unsigned audioDecodedByteCount() const;
517     unsigned videoDecodedByteCount() const;
518
519     void setPrivateBrowsingMode(bool);
520
521 #if ENABLE(WEB_AUDIO)
522     AudioSourceProvider* audioSourceProvider();
523 #endif
524
525 #if ENABLE(LEGACY_ENCRYPTED_MEDIA)
526     RefPtr<ArrayBuffer> cachedKeyForKeyId(const String& keyId) const;
527     bool keyNeeded(Uint8Array* initData);
528     String mediaKeysStorageDirectory() const;
529 #endif
530
531     String referrer() const;
532     String userAgent() const;
533
534     String engineDescription() const;
535     long platformErrorCode() const;
536
537     CachedResourceLoader* cachedResourceLoader();
538     RefPtr<PlatformMediaResourceLoader> createResourceLoader();
539
540 #if ENABLE(VIDEO_TRACK)
541     void addAudioTrack(AudioTrackPrivate&);
542     void addTextTrack(InbandTextTrackPrivate&);
543     void addVideoTrack(VideoTrackPrivate&);
544     void removeAudioTrack(AudioTrackPrivate&);
545     void removeTextTrack(InbandTextTrackPrivate&);
546     void removeVideoTrack(VideoTrackPrivate&);
547
548     bool requiresTextTrackRepresentation() const;
549     void setTextTrackRepresentation(TextTrackRepresentation*);
550     void syncTextTrackBounds();
551     void tracksChanged();
552 #if ENABLE(AVF_CAPTIONS)
553     void notifyTrackModeChanged();
554     Vector<RefPtr<PlatformTextTrack>> outOfBandTrackSources();
555 #endif
556 #endif
557
558 #if PLATFORM(IOS)
559     String mediaPlayerNetworkInterfaceName() const;
560     bool getRawCookies(const URL&, Vector<Cookie>&) const;
561 #endif
562
563     static void resetMediaEngines();
564
565 #if USE(GSTREAMER)
566     WEBCORE_EXPORT void simulateAudioInterruption();
567 #endif
568
569     String languageOfPrimaryAudioTrack() const;
570
571     size_t extraMemoryCost() const;
572
573     unsigned long long fileSize() const;
574
575 #if ENABLE(MEDIA_SOURCE)
576     unsigned long totalVideoFrames();
577     unsigned long droppedVideoFrames();
578     unsigned long corruptedVideoFrames();
579     MediaTime totalFrameDelay();
580 #endif
581
582     bool shouldWaitForResponseToAuthenticationChallenge(const AuthenticationChallenge&);
583     void handlePlaybackCommand(PlatformMediaSession::RemoteControlCommandType);
584     String sourceApplicationIdentifier() const;
585     Vector<String> preferredAudioCharacteristics() const;
586
587     bool ended() const;
588
589     void setShouldDisableSleep(bool);
590     bool shouldDisableSleep() const;
591
592     String contentMIMEType() const { return m_contentType.containerType(); }
593     String contentTypeCodecs() const { return m_contentType.parameter(ContentType::codecsParameter()); }
594     bool contentMIMETypeWasInferredFromExtension() const { return m_contentMIMETypeWasInferredFromExtension; }
595
596     const Vector<ContentType>& mediaContentTypesRequiringHardwareSupport() const;
597
598 private:
599     MediaPlayer(MediaPlayerClient&);
600
601     const MediaPlayerFactory* nextBestMediaEngine(const MediaPlayerFactory*) const;
602     void loadWithNextMediaEngine(const MediaPlayerFactory*);
603     void reloadTimerFired();
604
605     MediaPlayerClient* m_client;
606     Timer m_reloadTimer;
607     std::unique_ptr<MediaPlayerPrivateInterface> m_private;
608     const MediaPlayerFactory* m_currentMediaEngine;
609     URL m_url;
610     ContentType m_contentType;
611     String m_keySystem;
612     IntSize m_size;
613     Preload m_preload;
614     bool m_visible;
615     double m_volume;
616     bool m_muted;
617     bool m_preservesPitch;
618     bool m_privateBrowsing;
619     bool m_shouldPrepareToRender;
620     bool m_contentMIMETypeWasInferredFromExtension;
621     bool m_initializingMediaEngine { false };
622
623 #if ENABLE(MEDIA_SOURCE)
624     RefPtr<MediaSourcePrivateClient> m_mediaSource;
625 #endif
626 #if ENABLE(MEDIA_STREAM)
627     RefPtr<MediaStreamPrivate> m_mediaStream;
628 #endif
629 };
630
631 using CreateMediaEnginePlayer = WTF::Function<std::unique_ptr<MediaPlayerPrivateInterface> (MediaPlayer*)>;
632 typedef void (*MediaEngineSupportedTypes)(HashSet<String, ASCIICaseInsensitiveHash>& types);
633 typedef MediaPlayer::SupportsType (*MediaEngineSupportsType)(const MediaEngineSupportParameters& parameters);
634 typedef HashSet<RefPtr<SecurityOrigin>> (*MediaEngineOriginsInMediaCache)(const String& path);
635 typedef void (*MediaEngineClearMediaCache)(const String& path, std::chrono::system_clock::time_point modifiedSince);
636 typedef void (*MediaEngineClearMediaCacheForOrigins)(const String& path, const HashSet<RefPtr<SecurityOrigin>>&);
637 typedef bool (*MediaEngineSupportsKeySystem)(const String& keySystem, const String& mimeType);
638
639 typedef void (*MediaEngineRegistrar)(CreateMediaEnginePlayer&&, MediaEngineSupportedTypes, MediaEngineSupportsType,
640     MediaEngineOriginsInMediaCache, MediaEngineClearMediaCache, MediaEngineClearMediaCacheForOrigins, MediaEngineSupportsKeySystem);
641 typedef void (*MediaEngineRegister)(MediaEngineRegistrar);
642
643 class MediaPlayerFactorySupport {
644 public:
645     WEBCORE_EXPORT static void callRegisterMediaEngine(MediaEngineRegister);
646 };
647
648 }
649
650 #endif // ENABLE(VIDEO)
651
652 #endif