Music Hub  ..
A session-wide music playback service
service_implementation.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 
19 #ifndef CORE_UBUNTU_MEDIA_SERVICE_IMPLEMENTATION_H_
20 #define CORE_UBUNTU_MEDIA_SERVICE_IMPLEMENTATION_H_
21 
22 #include "service_skeleton.h"
23 #include "external_services.h"
24 
25 namespace core
26 {
27 namespace ubuntu
28 {
29 namespace media
30 {
31 class Player;
32 
34 {
35 public:
36  // All creation time arguments go here.
38  {
41  };
42 
43  ServiceImplementation (const Configuration& configuration);
45 
46  std::shared_ptr<Player> create_session(const Player::Configuration&);
47  void detach_session(const std::string&, const Player::Configuration&);
48  std::shared_ptr<Player> reattach_session(const std::string&, const Player::Configuration&);
49  void destroy_session(const std::string&, const Player::Configuration&);
50  std::shared_ptr<Player> create_fixed_session(const std::string& name, const Player::Configuration&);
51  std::shared_ptr<Player> resume_session(Player::PlayerKey key);
53 
54  const core::Signal<void>& service_disconnected() const;
55  const core::Signal<void>& service_reconnected() const;
56 
57 private:
58  void pause_all_multimedia_sessions(bool resume_play_after_phonecall);
59  void resume_paused_multimedia_sessions(bool resume_video_sessions = true);
60  void resume_multimedia_session();
61 
62  struct Private;
63  std::shared_ptr<Private> d;
64 };
65 }
66 }
67 }
68 
69 #endif // CORE_UBUNTU_MEDIA_SERVICE_IMPLEMENTATION_H_
Definition: player.h:33
const core::Signal< void > & service_reconnected() const
Signals when the media-hub server reappears from the bus.
ServiceImplementation(const Configuration &configuration)
void pause_other_sessions(Player::PlayerKey key)
Pauses sessions other than the supplied one.
std::shared_ptr< Player > create_session(const Player::Configuration &)
Creates a session with the media-hub service.
std::shared_ptr< Player > resume_session(Player::PlayerKey key)
Resumes a fixed-name session directly by player key.
const core::Signal< void > & service_disconnected() const
Signals when the media-hub server disappears from the bus.
std::shared_ptr< Player > reattach_session(const std::string &, const Player::Configuration &)
Reattaches to a UUID-identified session that is in detached state.
void destroy_session(const std::string &, const Player::Configuration &)
Asks the service to destroy a session. The session is destroyed when the client exits.
void detach_session(const std::string &, const Player::Configuration &)
Detaches a UUID-identified session for later resuming.
std::shared_ptr< KeyedPlayerStore > Ptr
std::shared_ptr< Player > create_fixed_session(const std::string &name, const Player::Configuration &)
Creates a fixed-named session with the media-hub service.