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