src/third_party/WebKit/Source/platform/graphics/media/MediaPlayer.h

   1 /*
   2  * Copyright (C) 2007, 2008, 2009, 2010, 2011, 2012, 2013 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 COMPUTER, 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 COMPUTER, 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 #include "public/platform/WebMediaPlayer.h"
  30 #include "wtf/Forward.h"
  31 #include "wtf/Noncopyable.h"
  32
  33 namespace blink {
  34
  35 class AudioSourceProvider;
  36 class KURL;
  37 class MediaPlayer;
  38 class TimeRanges;
  39 class WebContentDecryptionModule;
  40 class WebInbandTextTrack;
  41 class WebLayer;
  42 class WebMediaSource;
  43
  44 class MediaPlayerClient {
  45 public:
  46     virtual ~MediaPlayerClient() { }
  47
  48     // the network state has changed
  49     virtual void mediaPlayerNetworkStateChanged() = 0;
  50
  51     // the ready state has changed
  52     virtual void mediaPlayerReadyStateChanged() = 0;
  53
  54     // time has jumped, eg. not as a result of normal playback
  55     virtual void mediaPlayerTimeChanged() = 0;
  56
  57     // the media file duration has changed, or is now known
  58     virtual void mediaPlayerDurationChanged() = 0;
  59
  60     // the play/pause status changed
  61     virtual void mediaPlayerPlaybackStateChanged() = 0;
  62
  63     virtual void mediaPlayerRequestFullscreen() = 0;
  64
  65     virtual void mediaPlayerRequestSeek(double) = 0;
  66
  67     // The URL for video poster image.
  68     // FIXME: Remove this when WebMediaPlayerClientImpl::loadInternal does not depend on it.
  69     virtual KURL mediaPlayerPosterURL() = 0;
  70
  71 // Presentation-related methods
  72     // a new frame of video is available
  73     virtual void mediaPlayerRepaint() = 0;
  74
  75     // the movie size has changed
  76     virtual void mediaPlayerSizeChanged() = 0;
  77
  78     virtual void mediaPlayerSetWebLayer(WebLayer*) = 0;
  79
  80     virtual void mediaPlayerDidAddTextTrack(WebInbandTextTrack*) = 0;
  81     virtual void mediaPlayerDidRemoveTextTrack(WebInbandTextTrack*) = 0;
  82
  83     virtual void mediaPlayerMediaSourceOpened(WebMediaSource*) = 0;
  84 };
  85
  86 typedef PassOwnPtr<MediaPlayer> (*CreateMediaEnginePlayer)(MediaPlayerClient*);
  87
  88 class PLATFORM_EXPORT MediaPlayer {
  89     WTF_MAKE_NONCOPYABLE(MediaPlayer);
  90 public:
  91     static PassOwnPtr<MediaPlayer> create(MediaPlayerClient*);
  92     static void setMediaEngineCreateFunction(CreateMediaEnginePlayer);
  93
  94     static double invalidTime() { return -1.0; }
  95
  96     MediaPlayer() { }
  97     virtual ~MediaPlayer() { }
  98
  99     virtual void load(WebMediaPlayer::LoadType, const String& url, WebMediaPlayer::CORSMode) = 0;
 100
 101     enum Preload { None, MetaData, Auto };
 102     virtual void setPreload(Preload) = 0;
 103
 104 #if ENABLE(WEB_AUDIO)
 105     virtual AudioSourceProvider* audioSourceProvider() = 0;
 106 #endif
 107     virtual WebMediaPlayer* webMediaPlayer() const = 0;
 108 };
 109
 110 } // namespace blink
 111
 112 #endif // MediaPlayer_h