Music Hub  ..
A session-wide music playback service
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros
player.h
Go to the documentation of this file.
1 /*
2  * Copyright © 2013 Canonical Ltd.
3  *
4  * This program is free software: you can redistribute it and/or modify it
5  * under the terms of the GNU Lesser General Public License version 3,
6  * as published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU Lesser General Public License for more details.
12  *
13  * You should have received a copy of the GNU Lesser General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  *
16  * Authored by: Thomas Voß <thomas.voss@canonical.com>
17  */
18 #ifndef CORE_UBUNTU_MEDIA_PLAYER_H_
19 #define CORE_UBUNTU_MEDIA_PLAYER_H_
20 
21 #include <core/media/track.h>
22 
23 #include <core/property.h>
24 
25 #include <chrono>
26 #include <memory>
27 
28 namespace core
29 {
30 namespace ubuntu
31 {
32 namespace media
33 {
34 class Service;
35 class TrackList;
36 
37 class Player : public std::enable_shared_from_this<Player>
38 {
39  public:
40  typedef double PlaybackRate;
41  typedef double Volume;
42  typedef uint32_t PlayerKey;
43  typedef void* GLConsumerWrapperHybris;
44 
46  typedef void (*FrameAvailableCbHybris)(GLConsumerWrapperHybris wrapper, void *context);
47  typedef void (*FrameAvailableCb)(void *context);
48  typedef void (*PlaybackCompleteCb)(void *context);
49 
50  struct Configuration;
51 
52  struct Client
53  {
54  Client() = delete;
55 
56  static const Configuration& default_configuration();
57  };
58 
60  {
66  };
67 
69  {
73  };
74 
75  Player(const Player&) = delete;
76  virtual ~Player();
77 
78  Player& operator=(const Player&) = delete;
79  bool operator==(const Player&) const = delete;
80 
81  virtual std::shared_ptr<TrackList> track_list() = 0;
82  virtual PlayerKey key() const = 0;
83 
84  virtual bool open_uri(const Track::UriType& uri) = 0;
85  virtual void create_video_sink(uint32_t texture_id) = 0;
86  virtual GLConsumerWrapperHybris gl_consumer() const = 0;
87  virtual void next() = 0;
88  virtual void previous() = 0;
89  virtual void play() = 0;
90  virtual void pause() = 0;
91  virtual void stop() = 0;
92  virtual void seek_to(const std::chrono::microseconds& offset) = 0;
93 
94  // TODO: Convert this to be a signal
95  virtual void set_frame_available_callback(FrameAvailableCb cb, void *context) = 0;
96  virtual void set_playback_complete_callback(PlaybackCompleteCb cb, void *context) = 0;
97 
98  virtual const core::Property<bool>& can_play() const = 0;
99  virtual const core::Property<bool>& can_pause() const = 0;
100  virtual const core::Property<bool>& can_seek() const = 0;
101  virtual const core::Property<bool>& can_go_previous() const = 0;
102  virtual const core::Property<bool>& can_go_next() const = 0;
103  virtual const core::Property<bool>& is_video_source() const = 0;
104  virtual const core::Property<bool>& is_audio_source() const = 0;
105  virtual const core::Property<PlaybackStatus>& playback_status() const = 0;
106  virtual const core::Property<LoopStatus>& loop_status() const = 0;
107  virtual const core::Property<PlaybackRate>& playback_rate() const = 0;
108  virtual const core::Property<bool>& is_shuffle() const = 0;
109  virtual const core::Property<Track::MetaData>& meta_data_for_current_track() const = 0;
110  virtual const core::Property<Volume>& volume() const = 0;
111  virtual const core::Property<PlaybackRate>& minimum_playback_rate() const = 0;
112  virtual const core::Property<PlaybackRate>& maximum_playback_rate() const = 0;
113  virtual const core::Property<uint64_t>& position() const = 0;
114  virtual const core::Property<uint64_t>& duration() const = 0;
115 
116  virtual core::Property<LoopStatus>& loop_status() = 0;
117  virtual core::Property<PlaybackRate>& playback_rate() = 0;
118  virtual core::Property<bool>& is_shuffle() = 0;
119  virtual core::Property<Volume>& volume() = 0;
120 
121  virtual const core::Signal<uint64_t>& seeked_to() const = 0;
122  virtual const core::Signal<void>& end_of_stream() const = 0;
123  virtual core::Signal<PlaybackStatus>& playback_status_changed() = 0;
124  protected:
125  Player();
126 
127 };
128 }
129 }
130 }
131 
132 #endif // CORE_UBUNTU_MEDIA_PLAYER_H_
virtual const core::Property< PlaybackStatus > & playback_status() const =0
void * GLConsumerWrapperHybris
Definition: player.h:43
virtual const core::Property< bool > & is_video_source() const =0
virtual const core::Property< bool > & can_play() const =0
bool operator==(const Player &) const =delete
virtual const core::Property< bool > & can_seek() const =0
virtual const core::Property< Track::MetaData > & meta_data_for_current_track() const =0
virtual void previous()=0
virtual const core::Property< uint64_t > & duration() const =0
virtual const core::Property< bool > & can_go_previous() const =0
virtual core::Signal< PlaybackStatus > & playback_status_changed()=0
virtual const core::Property< bool > & is_audio_source() const =0
virtual const core::Property< PlaybackRate > & playback_rate() const =0
Player & operator=(const Player &)=delete
virtual const core::Property< Volume > & volume() const =0
void(* FrameAvailableCb)(void *context)
Definition: player.h:47
virtual bool open_uri(const Track::UriType &uri)=0
virtual const core::Property< bool > & can_pause() const =0
virtual void create_video_sink(uint32_t texture_id)=0
virtual void set_playback_complete_callback(PlaybackCompleteCb cb, void *context)=0
virtual const core::Property< bool > & can_go_next() const =0
static const Configuration & default_configuration()
Definition: player.cpp:25
void(* PlaybackCompleteCb)(void *context)
Definition: player.h:48
virtual const core::Signal< void > & end_of_stream() const =0
virtual void set_frame_available_callback(FrameAvailableCb cb, void *context)=0
virtual GLConsumerWrapperHybris gl_consumer() const =0
virtual const core::Signal< uint64_t > & seeked_to() const =0
virtual const core::Property< uint64_t > & position() const =0
virtual const core::Property< bool > & is_shuffle() const =0
virtual const core::Property< PlaybackRate > & maximum_playback_rate() const =0
std::string UriType
Definition: track.h:40
virtual PlayerKey key() const =0
virtual const core::Property< PlaybackRate > & minimum_playback_rate() const =0
virtual const core::Property< LoopStatus > & loop_status() const =0
virtual std::shared_ptr< TrackList > track_list()=0
void(* FrameAvailableCbHybris)(GLConsumerWrapperHybris wrapper, void *context)
Definition: player.h:46
virtual void seek_to(const std::chrono::microseconds &offset)=0