Migrate GraphicsContexts from pointers to references
[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 "NativeImagePtr.h"
40 #include "PlatformLayer.h"
41 #include "PlatformMediaResourceLoader.h"
42 #include "PlatformMediaSession.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 OBJC_CLASS AVAsset;
57 OBJC_CLASS AVPlayer;
58 OBJC_CLASS NSArray;
59 OBJC_CLASS QTMovie;
60
61 class AVCFPlayer;
62 class QTMovieGWorld;
63 class QTMovieVisualContext;
64
65 namespace WebCore {
66
67 class AudioSourceProvider;
68 class AuthenticationChallenge;
69 class MediaPlaybackTarget;
70 #if ENABLE(MEDIA_SOURCE)
71 class MediaSourcePrivateClient;
72 #endif
73 #if ENABLE(MEDIA_STREAM)
74 class MediaStreamPrivate;
75 #endif
76 class MediaPlayerPrivateInterface;
77 class TextTrackRepresentation;
78 struct Cookie;
79
80 // Structure that will hold every native
81 // types supported by the current media player.
82 // We have to do that has multiple media players
83 // backend can live at runtime.
84 struct PlatformMedia {
85     enum {
86         None,
87         QTMovieType,
88         QTMovieGWorldType,
89         QTMovieVisualContextType,
90         AVFoundationMediaPlayerType,
91         AVFoundationCFMediaPlayerType,
92         AVFoundationAssetType,
93     } type;
94
95     union {
96         QTMovie* qtMovie;
97         QTMovieGWorld* qtMovieGWorld;
98         QTMovieVisualContext* qtMovieVisualContext;
99         AVPlayer* avfMediaPlayer;
100         AVCFPlayer* avcfMediaPlayer;
101         AVAsset* avfAsset;
102     } media;
103 };
104
105 struct MediaEngineSupportParameters {
106     String type;
107     String codecs;
108     URL url;
109 #if ENABLE(ENCRYPTED_MEDIA)
110     String keySystem;
111 #endif
112 #if ENABLE(MEDIA_SOURCE)
113     bool isMediaSource;
114 #endif
115 #if ENABLE(MEDIA_STREAM)
116     bool isMediaStream;
117 #endif
118
119     MediaEngineSupportParameters()
120 #if ENABLE(MEDIA_SOURCE)
121         : isMediaSource(false)
122 #endif
123     {
124 #if ENABLE(MEDIA_STREAM)
125         isMediaStream = false;
126 #endif
127     }
128 };
129
130 extern const PlatformMedia NoPlatformMedia;
131
132 class CachedResourceLoader;
133 class ContentType;
134 class GraphicsContext;
135 class GraphicsContext3D;
136 class IntRect;
137 class IntSize;
138 class MediaPlayer;
139 class PlatformTimeRanges;
140
141 struct MediaPlayerFactory;
142
143 #if PLATFORM(WIN) && USE(AVFOUNDATION)
144 struct GraphicsDeviceAdapter;
145 #endif
146
147 #if USE(GSTREAMER)
148 class MediaPlayerRequestInstallMissingPluginsCallback;
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(MEDIA_STREAM)
229     virtual String mediaPlayerMediaDeviceIdentifierStorageDirectory() const { return emptyString(); }
230 #endif
231
232     
233 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
234     virtual void mediaPlayerCurrentPlaybackTargetIsWirelessChanged(MediaPlayer*) { };
235 #endif
236
237     virtual String mediaPlayerReferrer() const { return String(); }
238     virtual String mediaPlayerUserAgent() const { return String(); }
239     virtual void mediaPlayerEnterFullscreen() { }
240     virtual void mediaPlayerExitFullscreen() { }
241     virtual bool mediaPlayerIsFullscreen() const { return false; }
242     virtual bool mediaPlayerIsFullscreenPermitted() const { return false; }
243     virtual bool mediaPlayerIsVideo() const { return false; }
244     virtual LayoutRect mediaPlayerContentBoxRect() const { return LayoutRect(); }
245     virtual float mediaPlayerContentsScale() const { return 1; }
246     virtual void mediaPlayerSetSize(const IntSize&) { }
247     virtual void mediaPlayerPause() { }
248     virtual void mediaPlayerPlay() { }
249     virtual bool mediaPlayerPlatformVolumeConfigurationRequired() const { return false; }
250     virtual bool mediaPlayerIsPaused() const { return true; }
251     virtual bool mediaPlayerIsLooping() const { return false; }
252     virtual CachedResourceLoader* mediaPlayerCachedResourceLoader() { return 0; }
253     virtual RefPtr<PlatformMediaResourceLoader> mediaPlayerCreateResourceLoader(std::unique_ptr<PlatformMediaResourceLoaderClient>) { return nullptr; }
254     virtual bool doesHaveAttribute(const AtomicString&, AtomicString* = 0) const { return false; }
255
256 #if ENABLE(VIDEO_TRACK)
257     virtual void mediaPlayerDidAddAudioTrack(PassRefPtr<AudioTrackPrivate>) { }
258     virtual void mediaPlayerDidAddTextTrack(PassRefPtr<InbandTextTrackPrivate>) { }
259     virtual void mediaPlayerDidAddVideoTrack(PassRefPtr<VideoTrackPrivate>) { }
260     virtual void mediaPlayerDidRemoveAudioTrack(PassRefPtr<AudioTrackPrivate>) { }
261     virtual void mediaPlayerDidRemoveTextTrack(PassRefPtr<InbandTextTrackPrivate>) { }
262     virtual void mediaPlayerDidRemoveVideoTrack(PassRefPtr<VideoTrackPrivate>) { }
263
264     virtual void textTrackRepresentationBoundsChanged(const IntRect&) { }
265 #if ENABLE(AVF_CAPTIONS)
266     virtual Vector<RefPtr<PlatformTextTrack>> outOfBandTrackSources() { return Vector<RefPtr<PlatformTextTrack>>(); }
267 #endif
268 #endif
269
270 #if PLATFORM(IOS)
271     virtual String mediaPlayerNetworkInterfaceName() const { return String(); }
272     virtual bool mediaPlayerGetRawCookies(const URL&, Vector<Cookie>&) const { return false; }
273 #endif
274     
275     virtual bool mediaPlayerShouldWaitForResponseToAuthenticationChallenge(const AuthenticationChallenge&) { return false; }
276     virtual void mediaPlayerHandlePlaybackCommand(PlatformMediaSession::RemoteControlCommandType) { }
277
278     virtual String mediaPlayerSourceApplicationIdentifier() const { return emptyString(); }
279
280     virtual bool mediaPlayerIsInMediaDocument() const { return false; }
281     virtual void mediaPlayerEngineFailedToLoad() const { }
282
283     virtual double mediaPlayerRequestedPlaybackRate() const { return 0; }
284     virtual MediaPlayerEnums::VideoFullscreenMode mediaPlayerFullscreenMode() const { return MediaPlayerEnums::VideoFullscreenModeNone; }
285     virtual Vector<String> mediaPlayerPreferredAudioCharacteristics() const { return Vector<String>(); }
286
287 #if USE(GSTREAMER)
288     virtual void requestInstallMissingPlugins(const String&, const String&, MediaPlayerRequestInstallMissingPluginsCallback&) { };
289 #endif
290 };
291
292 class MediaPlayerSupportsTypeClient {
293 public:
294     virtual ~MediaPlayerSupportsTypeClient() { }
295
296     virtual bool mediaPlayerNeedsSiteSpecificHacks() const { return false; }
297     virtual String mediaPlayerDocumentHost() const { return String(); }
298 };
299
300 class MediaPlayer : public MediaPlayerEnums {
301     WTF_MAKE_NONCOPYABLE(MediaPlayer); WTF_MAKE_FAST_ALLOCATED;
302 public:
303     explicit MediaPlayer(MediaPlayerClient&);
304     virtual ~MediaPlayer();
305
306     // Media engine support.
307     enum SupportsType { IsNotSupported, IsSupported, MayBeSupported };
308     static MediaPlayer::SupportsType supportsType(const MediaEngineSupportParameters&, const MediaPlayerSupportsTypeClient*);
309     static void getSupportedTypes(HashSet<String>&);
310     static bool isAvailable();
311     static void getSitesInMediaCache(Vector<String>&);
312     static void clearMediaCache();
313     static void clearMediaCacheForSite(const String&);
314     static bool supportsKeySystem(const String& keySystem, const String& mimeType);
315
316     bool supportsFullscreen() const;
317     bool supportsScanning() const;
318     bool canSaveMediaData() const;
319     bool requiresImmediateCompositing() const;
320     bool doesHaveAttribute(const AtomicString&, AtomicString* value = nullptr) const;
321     PlatformMedia platformMedia() const;
322     PlatformLayer* platformLayer() const;
323 #if PLATFORM(IOS)
324     void setVideoFullscreenLayer(PlatformLayer*);
325     void setVideoFullscreenFrame(FloatRect);
326     using MediaPlayerEnums::VideoGravity;
327     void setVideoFullscreenGravity(VideoGravity);
328     void setVideoFullscreenMode(VideoFullscreenMode);
329     VideoFullscreenMode fullscreenMode() const;
330
331     NSArray *timedMetadata() const;
332     String accessLog() const;
333     String errorLog() const;
334 #endif
335
336     FloatSize naturalSize();
337     bool hasVideo() const;
338     bool hasAudio() const;
339
340     bool inMediaDocument() const;
341
342     IntSize size() const { return m_size; }
343     void setSize(const IntSize& size);
344
345     bool load(const URL&, const ContentType&, const String& keySystem);
346 #if ENABLE(MEDIA_SOURCE)
347     bool load(const URL&, const ContentType&, MediaSourcePrivateClient*);
348 #endif
349 #if ENABLE(MEDIA_STREAM)
350     bool load(MediaStreamPrivate*);
351 #endif
352     void cancelLoad();
353
354     bool visible() const;
355     void setVisible(bool);
356
357     void prepareToPlay();
358     void play();
359     void pause();
360     void setShouldBufferData(bool);
361
362 #if ENABLE(ENCRYPTED_MEDIA) || ENABLE(ENCRYPTED_MEDIA_V2)
363     // Represents synchronous exceptions that can be thrown from the Encrypted Media methods.
364     // This is different from the asynchronous MediaKeyError.
365     enum MediaKeyException { NoError, InvalidPlayerState, KeySystemNotSupported };
366 #endif
367
368 #if ENABLE(ENCRYPTED_MEDIA)
369     MediaKeyException generateKeyRequest(const String& keySystem, const unsigned char* initData, unsigned initDataLength);
370     MediaKeyException addKey(const String& keySystem, const unsigned char* key, unsigned keyLength, const unsigned char* initData, unsigned initDataLength, const String& sessionId);
371     MediaKeyException cancelKeyRequest(const String& keySystem, const String& sessionId);
372 #endif
373
374 #if ENABLE(ENCRYPTED_MEDIA_V2)
375     std::unique_ptr<CDMSession> createSession(const String& keySystem);
376     void setCDMSession(CDMSession*);
377     void keyAdded();
378 #endif
379
380     bool paused() const;
381     bool seeking() const;
382
383     static double invalidTime() { return -1.0;}
384     MediaTime duration() const;
385     MediaTime currentTime() const;
386     void seek(const MediaTime&);
387     void seekWithTolerance(const MediaTime&, const MediaTime& negativeTolerance, const MediaTime& positiveTolerance);
388
389     MediaTime startTime() const;
390     MediaTime initialTime() const;
391
392     MediaTime getStartDate() const;
393
394     double rate() const;
395     void setRate(double);
396     double requestedRate() const;
397
398     bool preservesPitch() const;
399     void setPreservesPitch(bool);
400
401     std::unique_ptr<PlatformTimeRanges> buffered();
402     std::unique_ptr<PlatformTimeRanges> seekable();
403     MediaTime minTimeSeekable();
404     MediaTime maxTimeSeekable();
405
406     bool didLoadingProgress();
407
408     double volume() const;
409     void setVolume(double);
410     bool platformVolumeConfigurationRequired() const { return m_client.mediaPlayerPlatformVolumeConfigurationRequired(); }
411
412     bool muted() const;
413     void setMuted(bool);
414
415     bool hasClosedCaptions() const;
416     void setClosedCaptionsVisible(bool closedCaptionsVisible);
417
418     bool autoplay() const;
419     void setAutoplay(bool);
420
421     void paint(GraphicsContext&, const FloatRect&);
422     void paintCurrentFrameInContext(GraphicsContext&, const FloatRect&);
423
424     // copyVideoTextureToPlatformTexture() is used to do the GPU-GPU textures copy without a readback to system memory.
425     // The first five parameters denote the corresponding GraphicsContext, destination texture, requested level, requested type and the required internalFormat for destination texture.
426     // The last two parameters premultiplyAlpha and flipY denote whether addtional premultiplyAlpha and flip operation are required during the copy.
427     // It returns true on success and false on failure.
428
429     // In the GPU-GPU textures copy, the source texture(Video texture) should have valid target, internalFormat and size, etc.
430     // The destination texture may need to be resized to to the dimensions of the source texture or re-defined to the required internalFormat.
431     // 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.
432
433     // Each platform port can have its own implementation on this function. The default implementation for it is a single "return false" in MediaPlayerPrivate.h.
434     // In chromium, the implementation is based on GL_CHROMIUM_copy_texture extension which is documented at
435     // http://src.chromium.org/viewvc/chrome/trunk/src/gpu/GLES2/extensions/CHROMIUM/CHROMIUM_copy_texture.txt and implemented at
436     // http://src.chromium.org/viewvc/chrome/trunk/src/gpu/command_buffer/service/gles2_cmd_copy_texture_chromium.cc via shaders.
437     bool copyVideoTextureToPlatformTexture(GraphicsContext3D*, Platform3DObject texture, GC3Dint level, GC3Denum type, GC3Denum internalFormat, bool premultiplyAlpha, bool flipY);
438
439     PassNativeImagePtr nativeImageForCurrentTime();
440
441     using MediaPlayerEnums::NetworkState;
442     NetworkState networkState();
443
444     using MediaPlayerEnums::ReadyState;
445     ReadyState readyState();
446
447     using MediaPlayerEnums::MovieLoadType;
448     MovieLoadType movieLoadType() const;
449
450     using MediaPlayerEnums::Preload;
451     Preload preload() const;
452     void setPreload(Preload);
453
454     void networkStateChanged();
455     void readyStateChanged();
456     void volumeChanged(double);
457     void muteChanged(bool);
458     void timeChanged();
459     void sizeChanged();
460     void rateChanged();
461     void playbackStateChanged();
462     void durationChanged();
463     void firstVideoFrameAvailable();
464     void characteristicChanged();
465
466     void repaint();
467
468     MediaPlayerClient& client() const { return m_client; }
469
470     bool hasAvailableVideoFrame() const;
471     void prepareForRendering();
472
473     bool canLoadPoster() const;
474     void setPoster(const String&);
475
476 #if USE(NATIVE_FULLSCREEN_VIDEO)
477     void enterFullscreen();
478     void exitFullscreen();
479 #endif
480
481 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
482     enum WirelessPlaybackTargetType { TargetTypeNone, TargetTypeAirPlay, TargetTypeTVOut };
483     WirelessPlaybackTargetType wirelessPlaybackTargetType() const;
484
485     String wirelessPlaybackTargetName() const;
486
487     bool wirelessVideoPlaybackDisabled() const;
488     void setWirelessVideoPlaybackDisabled(bool);
489
490     void currentPlaybackTargetIsWirelessChanged();
491     void playbackTargetAvailabilityChanged();
492
493     bool isCurrentPlaybackTargetWireless() const;
494     bool canPlayToWirelessPlaybackTarget() const;
495     void setWirelessPlaybackTarget(Ref<MediaPlaybackTarget>&&);
496
497     void setShouldPlayToPlaybackTarget(bool);
498 #endif
499
500     double minFastReverseRate() const;
501     double maxFastForwardRate() const;
502
503 #if USE(NATIVE_FULLSCREEN_VIDEO)
504     bool canEnterFullscreen() const;
505 #endif
506
507     // whether accelerated rendering is supported by the media engine for the current media.
508     bool supportsAcceleratedRendering() const;
509     // called when the rendering system flips the into or out of accelerated rendering mode.
510     void acceleratedRenderingStateChanged();
511
512     bool shouldMaintainAspectRatio() const;
513     void setShouldMaintainAspectRatio(bool);
514
515 #if PLATFORM(WIN) && USE(AVFOUNDATION)
516     GraphicsDeviceAdapter* graphicsDeviceAdapter() const;
517 #endif
518
519     bool hasSingleSecurityOrigin() const;
520
521     bool didPassCORSAccessCheck() const;
522
523     MediaTime mediaTimeForTimeValue(const MediaTime&) const;
524
525     double maximumDurationToCacheMediaTime() const;
526
527     unsigned decodedFrameCount() const;
528     unsigned droppedFrameCount() const;
529     unsigned audioDecodedByteCount() const;
530     unsigned videoDecodedByteCount() const;
531
532     void setPrivateBrowsingMode(bool);
533
534 #if ENABLE(WEB_AUDIO)
535     AudioSourceProvider* audioSourceProvider();
536 #endif
537
538 #if ENABLE(ENCRYPTED_MEDIA)
539     void keyAdded(const String& keySystem, const String& sessionId);
540     void keyError(const String& keySystem, const String& sessionId, MediaPlayerClient::MediaKeyErrorCode, unsigned short systemCode);
541     void keyMessage(const String& keySystem, const String& sessionId, const unsigned char* message, unsigned messageLength, const URL& defaultURL);
542     bool keyNeeded(const String& keySystem, const String& sessionId, const unsigned char* initData, unsigned initDataLength);
543 #endif
544
545 #if ENABLE(ENCRYPTED_MEDIA_V2)
546     RefPtr<ArrayBuffer> cachedKeyForKeyId(const String& keyId) const;
547     bool keyNeeded(Uint8Array* initData);
548     String mediaKeysStorageDirectory() const;
549 #endif
550
551     String referrer() const;
552     String userAgent() const;
553
554     String engineDescription() const;
555     long platformErrorCode() const;
556
557     CachedResourceLoader* cachedResourceLoader();
558     PassRefPtr<PlatformMediaResourceLoader> createResourceLoader(std::unique_ptr<PlatformMediaResourceLoaderClient>);
559
560 #if ENABLE(VIDEO_TRACK)
561     void addAudioTrack(PassRefPtr<AudioTrackPrivate>);
562     void addTextTrack(PassRefPtr<InbandTextTrackPrivate>);
563     void addVideoTrack(PassRefPtr<VideoTrackPrivate>);
564     void removeAudioTrack(PassRefPtr<AudioTrackPrivate>);
565     void removeTextTrack(PassRefPtr<InbandTextTrackPrivate>);
566     void removeVideoTrack(PassRefPtr<VideoTrackPrivate>);
567
568     bool requiresTextTrackRepresentation() const;
569     void setTextTrackRepresentation(TextTrackRepresentation*);
570     void syncTextTrackBounds();
571     void tracksChanged();
572 #if ENABLE(AVF_CAPTIONS)
573     void notifyTrackModeChanged();
574     Vector<RefPtr<PlatformTextTrack>> outOfBandTrackSources();
575 #endif
576 #endif
577
578 #if PLATFORM(IOS)
579     String mediaPlayerNetworkInterfaceName() const;
580     bool getRawCookies(const URL&, Vector<Cookie>&) const;
581 #endif
582
583     static void resetMediaEngines();
584
585 #if USE(GSTREAMER)
586     void simulateAudioInterruption();
587 #endif
588
589     String languageOfPrimaryAudioTrack() const;
590
591     size_t extraMemoryCost() const;
592
593     unsigned long long fileSize() const;
594
595 #if ENABLE(MEDIA_SOURCE)
596     unsigned long totalVideoFrames();
597     unsigned long droppedVideoFrames();
598     unsigned long corruptedVideoFrames();
599     MediaTime totalFrameDelay();
600 #endif
601
602     bool shouldWaitForResponseToAuthenticationChallenge(const AuthenticationChallenge&);
603     void handlePlaybackCommand(PlatformMediaSession::RemoteControlCommandType);
604     String sourceApplicationIdentifier() const;
605     Vector<String> preferredAudioCharacteristics() const;
606
607 private:
608     const MediaPlayerFactory* nextBestMediaEngine(const MediaPlayerFactory*) const;
609     void loadWithNextMediaEngine(const MediaPlayerFactory*);
610     void reloadTimerFired();
611
612     static void initializeMediaEngines();
613
614     MediaPlayerClient& m_client;
615     Timer m_reloadTimer;
616     std::unique_ptr<MediaPlayerPrivateInterface> m_private;
617     const MediaPlayerFactory* m_currentMediaEngine;
618     URL m_url;
619     String m_contentMIMEType;
620     String m_contentTypeCodecs;
621     String m_keySystem;
622     IntSize m_size;
623     Preload m_preload;
624     bool m_visible;
625     double m_volume;
626     bool m_muted;
627     bool m_preservesPitch;
628     bool m_privateBrowsing;
629     bool m_shouldPrepareToRender;
630     bool m_contentMIMETypeWasInferredFromExtension;
631
632 #if ENABLE(MEDIA_SOURCE)
633     RefPtr<MediaSourcePrivateClient> m_mediaSource;
634 #endif
635 #if ENABLE(MEDIA_STREAM)
636     RefPtr<MediaStreamPrivate> m_mediaStream;
637 #endif
638 };
639
640 typedef std::function<std::unique_ptr<MediaPlayerPrivateInterface> (MediaPlayer*)> CreateMediaEnginePlayer;
641 typedef void (*MediaEngineSupportedTypes)(HashSet<String>& types);
642 typedef MediaPlayer::SupportsType (*MediaEngineSupportsType)(const MediaEngineSupportParameters& parameters);
643 typedef void (*MediaEngineGetSitesInMediaCache)(Vector<String>&);
644 typedef void (*MediaEngineClearMediaCache)();
645 typedef void (*MediaEngineClearMediaCacheForSite)(const String&);
646 typedef bool (*MediaEngineSupportsKeySystem)(const String& keySystem, const String& mimeType);
647
648 typedef void (*MediaEngineRegistrar)(CreateMediaEnginePlayer, MediaEngineSupportedTypes, MediaEngineSupportsType,
649     MediaEngineGetSitesInMediaCache, MediaEngineClearMediaCache, MediaEngineClearMediaCacheForSite, MediaEngineSupportsKeySystem);
650 typedef void (*MediaEngineRegister)(MediaEngineRegistrar);
651
652 class MediaPlayerFactorySupport {
653 public:
654     WEBCORE_EXPORT static void callRegisterMediaEngine(MediaEngineRegister);
655 };
656
657 }
658
659 #endif // ENABLE(VIDEO)
660
661 #endif