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