Touching HTMLMediaElement.h or MediaPlayer.h causes a world rebuild.
[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 "CDMSession.h"
34 #include "InbandTextTrackPrivate.h"
35 #include "IntRect.h"
36 #include "URL.h"
37 #include "LayoutRect.h"
38 #include "MediaPlayerEnums.h"
39 #include "MediaSession.h"
40 #include "NativeImagePtr.h"
41 #include "PlatformLayer.h"
42 #include "PlatformMediaResourceLoader.h"
43 #include "Timer.h"
44 #include "VideoTrackPrivate.h"
45 #include <runtime/Uint8Array.h>
46 #include <wtf/Forward.h>
47 #include <wtf/HashSet.h>
48 #include <wtf/MediaTime.h>
49 #include <wtf/Noncopyable.h>
50 #include <wtf/text/StringHash.h>
51
52 #if ENABLE(AVF_CAPTIONS)
53 #include "PlatformTextTrack.h"
54 #endif
55
56 #if USE(PLATFORM_TEXT_TRACK_MENU)
57 #include "PlatformTextTrackMenu.h"
58 #endif
59
60 OBJC_CLASS AVAsset;
61 OBJC_CLASS AVPlayer;
62 OBJC_CLASS NSArray;
63 OBJC_CLASS QTMovie;
64
65 class AVCFPlayer;
66 class QTMovieGWorld;
67 class QTMovieVisualContext;
68
69 namespace WebCore {
70
71 class AudioSourceProvider;
72 class AuthenticationChallenge;
73 class MediaPlaybackTarget;
74 #if ENABLE(MEDIA_SOURCE)
75 class MediaSourcePrivateClient;
76 #endif
77 #if ENABLE(MEDIA_STREAM)
78 class MediaStreamPrivate;
79 #endif
80 class MediaPlayerPrivateInterface;
81 class TextTrackRepresentation;
82 struct Cookie;
83
84 // Structure that will hold every native
85 // types supported by the current media player.
86 // We have to do that has multiple media players
87 // backend can live at runtime.
88 struct PlatformMedia {
89     enum {
90         None,
91         QTMovieType,
92         QTMovieGWorldType,
93         QTMovieVisualContextType,
94         AVFoundationMediaPlayerType,
95         AVFoundationCFMediaPlayerType,
96         AVFoundationAssetType,
97     } type;
98
99     union {
100         QTMovie* qtMovie;
101         QTMovieGWorld* qtMovieGWorld;
102         QTMovieVisualContext* qtMovieVisualContext;
103         AVPlayer* avfMediaPlayer;
104         AVCFPlayer* avcfMediaPlayer;
105         AVAsset* avfAsset;
106     } media;
107 };
108
109 struct MediaEngineSupportParameters {
110     String type;
111     String codecs;
112     URL url;
113 #if ENABLE(ENCRYPTED_MEDIA)
114     String keySystem;
115 #endif
116 #if ENABLE(MEDIA_SOURCE)
117     bool isMediaSource;
118 #endif
119 #if ENABLE(MEDIA_STREAM)
120     bool isMediaStream;
121 #endif
122
123     MediaEngineSupportParameters()
124 #if ENABLE(MEDIA_SOURCE)
125         : isMediaSource(false)
126 #endif
127     {
128 #if ENABLE(MEDIA_STREAM)
129         isMediaStream = false;
130 #endif
131     }
132 };
133
134 extern const PlatformMedia NoPlatformMedia;
135
136 class CachedResourceLoader;
137 class ContentType;
138 class GraphicsContext;
139 class GraphicsContext3D;
140 class IntRect;
141 class IntSize;
142 class MediaPlayer;
143 class PlatformTimeRanges;
144
145 struct MediaPlayerFactory;
146
147 #if PLATFORM(WIN) && USE(AVFOUNDATION)
148 struct GraphicsDeviceAdapter;
149 #endif
150
151 class MediaPlayerClient {
152 public:
153     virtual ~MediaPlayerClient() { }
154
155     // the network state has changed
156     virtual void mediaPlayerNetworkStateChanged(MediaPlayer*) { }
157
158     // the ready state has changed
159     virtual void mediaPlayerReadyStateChanged(MediaPlayer*) { }
160
161     // the volume state has changed
162     virtual void mediaPlayerVolumeChanged(MediaPlayer*) { }
163
164     // the mute state has changed
165     virtual void mediaPlayerMuteChanged(MediaPlayer*) { }
166
167     // time has jumped, eg. not as a result of normal playback
168     virtual void mediaPlayerTimeChanged(MediaPlayer*) { }
169
170     // the media file duration has changed, or is now known
171     virtual void mediaPlayerDurationChanged(MediaPlayer*) { }
172
173     // the playback rate has changed
174     virtual void mediaPlayerRateChanged(MediaPlayer*) { }
175
176     // the play/pause status changed
177     virtual void mediaPlayerPlaybackStateChanged(MediaPlayer*) { }
178
179     // The MediaPlayer has found potentially problematic media content.
180     // This is used internally to trigger swapping from a <video>
181     // element to an <embed> in standalone documents
182     virtual void mediaPlayerSawUnsupportedTracks(MediaPlayer*) { }
183
184     // The MediaPlayer could not discover an engine which supports the requested resource.
185     virtual void mediaPlayerResourceNotSupported(MediaPlayer*) { }
186
187 // Presentation-related methods
188     // a new frame of video is available
189     virtual void mediaPlayerRepaint(MediaPlayer*) { }
190
191     // the movie size has changed
192     virtual void mediaPlayerSizeChanged(MediaPlayer*) { }
193
194     virtual void mediaPlayerEngineUpdated(MediaPlayer*) { }
195
196     // The first frame of video is available to render. A media engine need only make this callback if the
197     // first frame is not available immediately when prepareForRendering is called.
198     virtual void mediaPlayerFirstVideoFrameAvailable(MediaPlayer*) { }
199
200     // A characteristic of the media file, eg. video, audio, closed captions, etc, has changed.
201     virtual void mediaPlayerCharacteristicChanged(MediaPlayer*) { }
202     
203     // whether the rendering system can accelerate the display of this MediaPlayer.
204     virtual bool mediaPlayerRenderingCanBeAccelerated(MediaPlayer*) { return false; }
205
206     // called when the media player's rendering mode changed, which indicates a change in the
207     // availability of the platformLayer().
208     virtual void mediaPlayerRenderingModeChanged(MediaPlayer*) { }
209
210 #if PLATFORM(WIN) && USE(AVFOUNDATION)
211     virtual GraphicsDeviceAdapter* mediaPlayerGraphicsDeviceAdapter(const MediaPlayer*) const { return 0; }
212 #endif
213
214 #if ENABLE(ENCRYPTED_MEDIA)
215     enum MediaKeyErrorCode { UnknownError = 1, ClientError, ServiceError, OutputError, HardwareChangeError, DomainError };
216     virtual void mediaPlayerKeyAdded(MediaPlayer*, const String& /* keySystem */, const String& /* sessionId */) { }
217     virtual void mediaPlayerKeyError(MediaPlayer*, const String& /* keySystem */, const String& /* sessionId */, MediaKeyErrorCode, unsigned short /* systemCode */) { }
218     virtual void mediaPlayerKeyMessage(MediaPlayer*, const String& /* keySystem */, const String& /* sessionId */, const unsigned char* /* message */, unsigned /* messageLength */, const URL& /* defaultURL */) { }
219     virtual bool mediaPlayerKeyNeeded(MediaPlayer*, const String& /* keySystem */, const String& /* sessionId */, const unsigned char* /* initData */, unsigned /* initDataLength */) { return false; }
220 #endif
221
222 #if ENABLE(ENCRYPTED_MEDIA_V2)
223     virtual RefPtr<ArrayBuffer> mediaPlayerCachedKeyForKeyId(const String&) const { return nullptr; }
224     virtual bool mediaPlayerKeyNeeded(MediaPlayer*, Uint8Array*) { return false; }
225     virtual String mediaPlayerMediaKeysStorageDirectory() const { return emptyString(); }
226 #endif
227     
228 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
229     virtual void mediaPlayerCurrentPlaybackTargetIsWirelessChanged(MediaPlayer*) { };
230 #endif
231
232     virtual String mediaPlayerReferrer() const { return String(); }
233     virtual String mediaPlayerUserAgent() const { return String(); }
234     virtual void mediaPlayerEnterFullscreen() { }
235     virtual void mediaPlayerExitFullscreen() { }
236     virtual bool mediaPlayerIsFullscreen() const { return false; }
237     virtual bool mediaPlayerIsFullscreenPermitted() const { return false; }
238     virtual bool mediaPlayerIsVideo() const { return false; }
239     virtual LayoutRect mediaPlayerContentBoxRect() const { return LayoutRect(); }
240     virtual float mediaPlayerContentsScale() const { return 1; }
241     virtual void mediaPlayerSetSize(const IntSize&) { }
242     virtual void mediaPlayerPause() { }
243     virtual void mediaPlayerPlay() { }
244     virtual bool mediaPlayerPlatformVolumeConfigurationRequired() const { return false; }
245     virtual bool mediaPlayerIsPaused() const { return true; }
246     virtual bool mediaPlayerIsLooping() const { return false; }
247     virtual CachedResourceLoader* mediaPlayerCachedResourceLoader() { return 0; }
248     virtual RefPtr<PlatformMediaResourceLoader> mediaPlayerCreateResourceLoader(std::unique_ptr<PlatformMediaResourceLoaderClient>) { return nullptr; }
249     virtual bool doesHaveAttribute(const AtomicString&, AtomicString* = 0) const { return false; }
250
251 #if ENABLE(VIDEO_TRACK)
252     virtual void mediaPlayerDidAddAudioTrack(PassRefPtr<AudioTrackPrivate>) { }
253     virtual void mediaPlayerDidAddTextTrack(PassRefPtr<InbandTextTrackPrivate>) { }
254     virtual void mediaPlayerDidAddVideoTrack(PassRefPtr<VideoTrackPrivate>) { }
255     virtual void mediaPlayerDidRemoveAudioTrack(PassRefPtr<AudioTrackPrivate>) { }
256     virtual void mediaPlayerDidRemoveTextTrack(PassRefPtr<InbandTextTrackPrivate>) { }
257     virtual void mediaPlayerDidRemoveVideoTrack(PassRefPtr<VideoTrackPrivate>) { }
258
259     virtual void textTrackRepresentationBoundsChanged(const IntRect&) { }
260 #if ENABLE(AVF_CAPTIONS)
261     virtual Vector<RefPtr<PlatformTextTrack>> outOfBandTrackSources() { return Vector<RefPtr<PlatformTextTrack>>(); }
262 #endif
263 #endif
264
265 #if PLATFORM(IOS)
266     virtual String mediaPlayerNetworkInterfaceName() const { return String(); }
267     virtual bool mediaPlayerGetRawCookies(const URL&, Vector<Cookie>&) const { return false; }
268 #endif
269     
270     virtual bool mediaPlayerShouldWaitForResponseToAuthenticationChallenge(const AuthenticationChallenge&) { return false; }
271     virtual void mediaPlayerHandlePlaybackCommand(MediaSession::RemoteControlCommandType) { }
272
273     virtual String mediaPlayerSourceApplicationIdentifier() const { return emptyString(); }
274
275     virtual bool mediaPlayerIsInMediaDocument() const { return false; }
276     virtual void mediaPlayerEngineFailedToLoad() const { }
277
278     virtual double mediaPlayerRequestedPlaybackRate() const { return 0; }
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 {
290     WTF_MAKE_NONCOPYABLE(MediaPlayer); WTF_MAKE_FAST_ALLOCATED;
291 public:
292     explicit MediaPlayer(MediaPlayerClient&);
293     virtual ~MediaPlayer();
294
295     // Media engine support.
296     enum SupportsType { IsNotSupported, IsSupported, MayBeSupported };
297     static MediaPlayer::SupportsType supportsType(const MediaEngineSupportParameters&, const MediaPlayerSupportsTypeClient*);
298     static void getSupportedTypes(HashSet<String>&);
299     static bool isAvailable();
300     static void getSitesInMediaCache(Vector<String>&);
301     static void clearMediaCache();
302     static void clearMediaCacheForSite(const String&);
303     static bool supportsKeySystem(const String& keySystem, const String& mimeType);
304
305     bool supportsFullscreen() const;
306     bool supportsScanning() const;
307     bool canSaveMediaData() const;
308     bool requiresImmediateCompositing() const;
309     bool doesHaveAttribute(const AtomicString&, AtomicString* value = nullptr) const;
310     PlatformMedia platformMedia() const;
311     PlatformLayer* platformLayer() const;
312 #if PLATFORM(IOS)
313     void setVideoFullscreenLayer(PlatformLayer*);
314     void setVideoFullscreenFrame(FloatRect);
315     using MediaPlayerEnums::VideoGravity;
316     void setVideoFullscreenGravity(VideoGravity);
317
318     NSArray *timedMetadata() const;
319     String accessLog() const;
320     String errorLog() const;
321 #endif
322
323     FloatSize naturalSize();
324     bool hasVideo() const;
325     bool hasAudio() const;
326
327     bool inMediaDocument() const;
328
329     IntSize size() const { return m_size; }
330     void setSize(const IntSize& size);
331
332     bool load(const URL&, const ContentType&, const String& keySystem);
333 #if ENABLE(MEDIA_SOURCE)
334     bool load(const URL&, const ContentType&, MediaSourcePrivateClient*);
335 #endif
336 #if ENABLE(MEDIA_STREAM)
337     bool load(MediaStreamPrivate*);
338 #endif
339     void cancelLoad();
340
341     bool visible() const;
342     void setVisible(bool);
343
344     void prepareToPlay();
345     void play();
346     void pause();
347     void setShouldBufferData(bool);
348
349 #if ENABLE(ENCRYPTED_MEDIA) || ENABLE(ENCRYPTED_MEDIA_V2)
350     // Represents synchronous exceptions that can be thrown from the Encrypted Media methods.
351     // This is different from the asynchronous MediaKeyError.
352     enum MediaKeyException { NoError, InvalidPlayerState, KeySystemNotSupported };
353 #endif
354
355 #if ENABLE(ENCRYPTED_MEDIA)
356     MediaKeyException generateKeyRequest(const String& keySystem, const unsigned char* initData, unsigned initDataLength);
357     MediaKeyException addKey(const String& keySystem, const unsigned char* key, unsigned keyLength, const unsigned char* initData, unsigned initDataLength, const String& sessionId);
358     MediaKeyException cancelKeyRequest(const String& keySystem, const String& sessionId);
359 #endif
360
361 #if ENABLE(ENCRYPTED_MEDIA_V2)
362     std::unique_ptr<CDMSession> createSession(const String& keySystem);
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     double rate() const;
380     void setRate(double);
381     double requestedRate() const;
382
383     bool preservesPitch() const;
384     void setPreservesPitch(bool);
385
386     std::unique_ptr<PlatformTimeRanges> buffered();
387     std::unique_ptr<PlatformTimeRanges> seekable();
388     MediaTime minTimeSeekable();
389     MediaTime maxTimeSeekable();
390
391     bool didLoadingProgress();
392
393     double volume() const;
394     void setVolume(double);
395     bool platformVolumeConfigurationRequired() const { return m_client.mediaPlayerPlatformVolumeConfigurationRequired(); }
396
397     bool muted() const;
398     void setMuted(bool);
399
400     bool hasClosedCaptions() const;
401     void setClosedCaptionsVisible(bool closedCaptionsVisible);
402
403     bool autoplay() const;
404     void setAutoplay(bool);
405
406     void paint(GraphicsContext*, const FloatRect&);
407     void paintCurrentFrameInContext(GraphicsContext*, const FloatRect&);
408
409     // copyVideoTextureToPlatformTexture() is used to do the GPU-GPU textures copy without a readback to system memory.
410     // The first five parameters denote the corresponding GraphicsContext, destination texture, requested level, requested type and the required internalFormat for destination texture.
411     // The last two parameters premultiplyAlpha and flipY denote whether addtional premultiplyAlpha and flip operation are required during the copy.
412     // It returns true on success and false on failure.
413
414     // In the GPU-GPU textures copy, the source texture(Video texture) should have valid target, internalFormat and size, etc.
415     // The destination texture may need to be resized to to the dimensions of the source texture or re-defined to the required internalFormat.
416     // 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.
417
418     // Each platform port can have its own implementation on this function. The default implementation for it is a single "return false" in MediaPlayerPrivate.h.
419     // In chromium, the implementation is based on GL_CHROMIUM_copy_texture extension which is documented at
420     // http://src.chromium.org/viewvc/chrome/trunk/src/gpu/GLES2/extensions/CHROMIUM/CHROMIUM_copy_texture.txt and implemented at
421     // http://src.chromium.org/viewvc/chrome/trunk/src/gpu/command_buffer/service/gles2_cmd_copy_texture_chromium.cc via shaders.
422     bool copyVideoTextureToPlatformTexture(GraphicsContext3D*, Platform3DObject texture, GC3Dint level, GC3Denum type, GC3Denum internalFormat, bool premultiplyAlpha, bool flipY);
423
424     PassNativeImagePtr nativeImageForCurrentTime();
425
426     using MediaPlayerEnums::NetworkState;
427     NetworkState networkState();
428
429     using MediaPlayerEnums::ReadyState;
430     ReadyState readyState();
431
432     using MediaPlayerEnums::MovieLoadType;
433     MovieLoadType movieLoadType() const;
434
435     using MediaPlayerEnums::Preload;
436     Preload preload() const;
437     void setPreload(Preload);
438
439     void networkStateChanged();
440     void readyStateChanged();
441     void volumeChanged(double);
442     void muteChanged(bool);
443     void timeChanged();
444     void sizeChanged();
445     void rateChanged();
446     void playbackStateChanged();
447     void durationChanged();
448     void firstVideoFrameAvailable();
449     void characteristicChanged();
450
451     void repaint();
452
453     MediaPlayerClient& client() const { return m_client; }
454
455     bool hasAvailableVideoFrame() const;
456     void prepareForRendering();
457
458     bool canLoadPoster() const;
459     void setPoster(const String&);
460
461 #if USE(NATIVE_FULLSCREEN_VIDEO)
462     void enterFullscreen();
463     void exitFullscreen();
464 #endif
465
466 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
467     bool isCurrentPlaybackTargetWireless() const;
468
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 canPlayToWirelessPlaybackTarget() const;
481     bool isPlayingToWirelessPlaybackTarget() 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(ENCRYPTED_MEDIA)
526     void keyAdded(const String& keySystem, const String& sessionId);
527     void keyError(const String& keySystem, const String& sessionId, MediaPlayerClient::MediaKeyErrorCode, unsigned short systemCode);
528     void keyMessage(const String& keySystem, const String& sessionId, const unsigned char* message, unsigned messageLength, const URL& defaultURL);
529     bool keyNeeded(const String& keySystem, const String& sessionId, const unsigned char* initData, unsigned initDataLength);
530 #endif
531
532 #if ENABLE(ENCRYPTED_MEDIA_V2)
533     RefPtr<ArrayBuffer> cachedKeyForKeyId(const String& keyId) const;
534     bool keyNeeded(Uint8Array* initData);
535     String mediaKeysStorageDirectory() const;
536 #endif
537
538     String referrer() const;
539     String userAgent() const;
540
541     String engineDescription() const;
542     long platformErrorCode() const;
543
544     CachedResourceLoader* cachedResourceLoader();
545     PassRefPtr<PlatformMediaResourceLoader> createResourceLoader(std::unique_ptr<PlatformMediaResourceLoaderClient>);
546
547 #if ENABLE(VIDEO_TRACK)
548     void addAudioTrack(PassRefPtr<AudioTrackPrivate>);
549     void addTextTrack(PassRefPtr<InbandTextTrackPrivate>);
550     void addVideoTrack(PassRefPtr<VideoTrackPrivate>);
551     void removeAudioTrack(PassRefPtr<AudioTrackPrivate>);
552     void removeTextTrack(PassRefPtr<InbandTextTrackPrivate>);
553     void removeVideoTrack(PassRefPtr<VideoTrackPrivate>);
554
555     bool requiresTextTrackRepresentation() const;
556     void setTextTrackRepresentation(TextTrackRepresentation*);
557     void syncTextTrackBounds();
558 #if ENABLE(AVF_CAPTIONS)
559     void notifyTrackModeChanged();
560     Vector<RefPtr<PlatformTextTrack>> outOfBandTrackSources();
561 #endif
562 #endif
563
564 #if PLATFORM(IOS)
565     String mediaPlayerNetworkInterfaceName() const;
566     bool getRawCookies(const URL&, Vector<Cookie>&) const;
567 #endif
568
569     static void resetMediaEngines();
570
571 #if USE(PLATFORM_TEXT_TRACK_MENU)
572     bool implementsTextTrackControls() const;
573     PassRefPtr<PlatformTextTrackMenuInterface> textTrackMenu();
574 #endif
575
576 #if USE(GSTREAMER)
577     void simulateAudioInterruption();
578 #endif
579
580     String languageOfPrimaryAudioTrack() const;
581
582     size_t extraMemoryCost() const;
583
584     unsigned long long fileSize() const;
585
586 #if ENABLE(MEDIA_SOURCE)
587     unsigned long totalVideoFrames();
588     unsigned long droppedVideoFrames();
589     unsigned long corruptedVideoFrames();
590     MediaTime totalFrameDelay();
591 #endif
592
593     bool shouldWaitForResponseToAuthenticationChallenge(const AuthenticationChallenge&);
594     void handlePlaybackCommand(MediaSession::RemoteControlCommandType);
595     String sourceApplicationIdentifier() const;
596
597 private:
598     const MediaPlayerFactory* nextBestMediaEngine(const MediaPlayerFactory*) const;
599     void loadWithNextMediaEngine(const MediaPlayerFactory*);
600     void reloadTimerFired();
601
602     static void initializeMediaEngines();
603
604     MediaPlayerClient& m_client;
605     Timer m_reloadTimer;
606     std::unique_ptr<MediaPlayerPrivateInterface> m_private;
607     const MediaPlayerFactory* m_currentMediaEngine;
608     URL m_url;
609     String m_contentMIMEType;
610     String m_contentTypeCodecs;
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
622 #if ENABLE(MEDIA_SOURCE)
623     RefPtr<MediaSourcePrivateClient> m_mediaSource;
624 #endif
625 #if ENABLE(MEDIA_STREAM)
626     RefPtr<MediaStreamPrivate> m_mediaStream;
627 #endif
628 };
629
630 typedef std::function<std::unique_ptr<MediaPlayerPrivateInterface> (MediaPlayer*)> CreateMediaEnginePlayer;
631 typedef void (*MediaEngineSupportedTypes)(HashSet<String>& types);
632 typedef MediaPlayer::SupportsType (*MediaEngineSupportsType)(const MediaEngineSupportParameters& parameters);
633 typedef void (*MediaEngineGetSitesInMediaCache)(Vector<String>&);
634 typedef void (*MediaEngineClearMediaCache)();
635 typedef void (*MediaEngineClearMediaCacheForSite)(const String&);
636 typedef bool (*MediaEngineSupportsKeySystem)(const String& keySystem, const String& mimeType);
637
638 typedef void (*MediaEngineRegistrar)(CreateMediaEnginePlayer, MediaEngineSupportedTypes, MediaEngineSupportsType,
639     MediaEngineGetSitesInMediaCache, MediaEngineClearMediaCache, MediaEngineClearMediaCacheForSite, MediaEngineSupportsKeySystem);
640 typedef void (*MediaEngineRegister)(MediaEngineRegistrar);
641
642 class MediaPlayerFactorySupport {
643 public:
644     WEBCORE_EXPORT static void callRegisterMediaEngine(MediaEngineRegister);
645 };
646
647 }
648
649 #endif // ENABLE(VIDEO)
650
651 #endif