|
1
|
1 #pragma once
|
|
|
2
|
|
|
3 //! Provides control for various playback-related operations. \n
|
|
|
4 //! All methods provided by this interface work from main app thread only. Calling from another thread will do nothing or trigger an exception. If you need to trigger one of playback_control methods from another thread, see main_thread_callback. \n
|
|
|
5 //! Do not call playback_control methods from inside any kind of global callback (e.g. playlist callback), otherwise race conditions may occur. \n
|
|
|
6 //! Use playback_control::get() to obtain an instance.
|
|
|
7 class NOVTABLE playback_control : public service_base {
|
|
|
8 FB2K_MAKE_SERVICE_COREAPI(playback_control);
|
|
|
9 public:
|
|
|
10
|
|
|
11 // Playback stop reason enum.
|
|
|
12 enum t_stop_reason {
|
|
|
13 stop_reason_user = 0,
|
|
|
14 stop_reason_eof,
|
|
|
15 stop_reason_starting_another,
|
|
|
16 stop_reason_shutting_down,
|
|
|
17 };
|
|
|
18
|
|
|
19 // Playback start mode enum.
|
|
|
20 enum t_track_command {
|
|
|
21 track_command_default = 0,
|
|
|
22 track_command_play,
|
|
|
23 //! Plays the next track from the current playlist according to the current playback order.
|
|
|
24 track_command_next,
|
|
|
25 //! Plays the previous track from the current playlist according to the current playback order.
|
|
|
26 track_command_prev,
|
|
|
27 //! For internal use only, do not use.
|
|
|
28 track_command_settrack,
|
|
|
29 //! Plays a random track from the current playlist.
|
|
|
30 track_command_rand,
|
|
|
31
|
|
|
32 //! For internal use only, do not use.
|
|
|
33 track_command_resume,
|
|
|
34 };
|
|
|
35
|
|
|
36 //! Retrieves now playing item handle.
|
|
|
37 //! @returns true on success, false on failure (not playing).
|
|
|
38 virtual bool get_now_playing(metadb_handle_ptr & p_out) = 0;
|
|
|
39 //! Starts playback. If playback is already active, existing process is stopped first.
|
|
|
40 //! @param p_command Specifies what track to start playback from. See t_track_Command enum for more info.
|
|
|
41 //! @param p_paused Specifies whether playback should be started as paused.
|
|
|
42 virtual void start(t_track_command p_command = track_command_play,bool p_paused = false) = 0;
|
|
|
43 //! Stops playback.
|
|
|
44 virtual void stop() = 0;
|
|
|
45 //! Returns whether playback is active.
|
|
|
46 virtual bool is_playing() = 0;
|
|
|
47 //! Returns whether playback is active and in paused state.
|
|
|
48 virtual bool is_paused() = 0;
|
|
|
49 //! Toggles pause state if playback is active.
|
|
|
50 //! @param p_state set to true when pausing or to false when unpausing.
|
|
|
51 virtual void pause(bool p_state) = 0;
|
|
|
52
|
|
|
53 //! Retrieves stop-after-current-track option state.
|
|
|
54 virtual bool get_stop_after_current() = 0;
|
|
|
55 //! Alters stop-after-current-track option state.
|
|
|
56 virtual void set_stop_after_current(bool p_state) = 0;
|
|
|
57
|
|
|
58 //! Alters playback volume level.
|
|
|
59 //! @param p_value volume in dB; 0 for full volume.
|
|
|
60 virtual void set_volume(float p_value) = 0;
|
|
|
61 //! Retrieves playback volume level.
|
|
|
62 //! @returns current playback volume level, in dB; 0 for full volume.
|
|
|
63 virtual float get_volume() = 0;
|
|
|
64 //! Alters playback volume level one step up.
|
|
|
65 virtual void volume_up() = 0;
|
|
|
66 //! Alters playback volume level one step down.
|
|
|
67 virtual void volume_down() = 0;
|
|
|
68 //! Toggles playback mute state.
|
|
|
69 virtual void volume_mute_toggle() = 0;
|
|
|
70 //! Seeks in currenly played track to specified time.
|
|
|
71 //! @param p_time target time in seconds.
|
|
|
72 virtual void playback_seek(double p_time) = 0;
|
|
|
73 //! Seeks in currently played track by specified time forward or back.
|
|
|
74 //! @param p_delta time in seconds to seek by; can be positive to seek forward or negative to seek back.
|
|
|
75 virtual void playback_seek_delta(double p_delta) = 0;
|
|
|
76 //! Returns whether currently played track is seekable. If it's not, playback_seek/playback_seek_delta calls will be ignored.
|
|
|
77 virtual bool playback_can_seek() = 0;
|
|
|
78 //! Returns current playback position within currently played track, in seconds.
|
|
|
79 virtual double playback_get_position() = 0;
|
|
|
80
|
|
|
81 //! Type used to indicate level of dynamic playback-related info displayed. Safe to use with <> opereators, e.g. level above N always includes information rendered by level N.
|
|
|
82 enum t_display_level {
|
|
|
83 //! No playback-related info
|
|
|
84 display_level_none,
|
|
|
85 //! Static info and is_playing/is_paused stats
|
|
|
86 display_level_basic,
|
|
|
87 //! display_level_basic + dynamic track titles on e.g. live streams
|
|
|
88 display_level_titles,
|
|
|
89 //! display_level_titles + timing + VBR bitrate display etc
|
|
|
90 display_level_all,
|
|
|
91 };
|
|
|
92
|
|
|
93 //! Renders information about currently playing item.
|
|
|
94 //! @param p_hook Optional callback object overriding fields and functions; set to NULL if not used.
|
|
|
95 //! @param p_out String receiving the output on success.
|
|
|
96 //! @param p_script Titleformat script to use. Use titleformat_compiler service to create one.
|
|
|
97 //! @param p_filter Optional callback object allowing input to be filtered according to context (i.e. removal of linebreak characters present in tags when rendering playlist lines). Set to NULL when not used.
|
|
|
98 //! @param p_level Indicates level of dynamic playback-related info displayed. See t_display_level enum for more details.
|
|
|
99 //! @returns true on success, false when no item is currently being played.
|
|
|
100 virtual bool playback_format_title(titleformat_hook * p_hook,pfc::string_base & p_out,const service_ptr_t<class titleformat_object> & p_script,titleformat_text_filter * p_filter,t_display_level p_level) = 0;
|
|
|
101
|
|
|
102
|
|
|
103
|
|
|
104 //! Helper; renders info about any item, including currently playing item info if the item is currently played.
|
|
|
105 bool playback_format_title_ex(metadb_handle_ptr p_item,titleformat_hook * p_hook,pfc::string_base & p_out,const service_ptr_t<class titleformat_object> & p_script,titleformat_text_filter * p_filter,t_display_level p_level) {
|
|
|
106 if (p_item.is_empty()) return playback_format_title(p_hook,p_out,p_script,p_filter,p_level);
|
|
|
107 metadb_handle_ptr temp;
|
|
|
108 if (get_now_playing(temp)) {
|
|
|
109 if (temp == p_item) {
|
|
|
110 return playback_format_title(p_hook,p_out,p_script,p_filter,p_level);
|
|
|
111 }
|
|
|
112 }
|
|
|
113 p_item->format_title(p_hook,p_out,p_script,p_filter);
|
|
|
114 return true;
|
|
|
115 }
|
|
|
116
|
|
|
117 //! Helper; retrieves length of currently playing item.
|
|
|
118 double playback_get_length();
|
|
|
119 // Extended version: queries dynamic track info for the rare cases where that is different from static info.
|
|
|
120 double playback_get_length_ex();
|
|
|
121
|
|
|
122 //! Toggles stop-after-current state.
|
|
|
123 void toggle_stop_after_current() {set_stop_after_current(!get_stop_after_current());}
|
|
|
124 //! Toggles pause state.
|
|
|
125 void toggle_pause() {pause(!is_paused());}
|
|
|
126
|
|
|
127 //! Starts playback if playback is inactive, otherwise toggles pause.
|
|
|
128 void play_or_pause() {if (is_playing()) toggle_pause(); else start();}
|
|
|
129 void play_or_unpause() { if (is_playing()) pause(false); else start();}
|
|
|
130
|
|
|
131 void previous() { start(track_command_prev); }
|
|
|
132 void next() { start(track_command_next); }
|
|
|
133
|
|
|
134 //deprecated
|
|
|
135 inline void play_start(t_track_command p_command = track_command_play,bool p_paused = false) {start(p_command,p_paused);}
|
|
|
136 //deprecated
|
|
|
137 inline void play_stop() {stop();}
|
|
|
138
|
|
|
139 bool is_muted() {return get_volume() == volume_mute;}
|
|
|
140
|
|
|
141 static const int volume_mute = -100;
|
|
|
142
|
|
|
143
|
|
|
144
|
|
|
145 // new fb2k mobile specific user command handlers
|
|
|
146 void userPrev();
|
|
|
147 void userNext();
|
|
|
148 void userMute();
|
|
|
149 void userStop();
|
|
|
150 void userPlay();
|
|
|
151 void userPause();
|
|
|
152 void userStart();
|
|
|
153 void userFastForward();
|
|
|
154 void userRewind();
|
|
|
155 void nonUserPause();
|
|
|
156
|
|
|
157 // #$@! FiiO hack $!#@
|
|
|
158 void userActionHook() {}
|
|
|
159 };
|
|
|
160
|
|
|
161 class playback_control_v2 : public playback_control {
|
|
|
162 FB2K_MAKE_SERVICE_COREAPI_EXTENSION(playback_control_v2,playback_control);
|
|
|
163 public:
|
|
|
164 //! Returns user-specified the step dB value for volume decrement/increment.
|
|
|
165 virtual float get_volume_step() = 0;
|
|
|
166 };
|
|
|
167
|
|
|
168 //! \since 1.2
|
|
|
169 class playback_control_v3 : public playback_control_v2 {
|
|
|
170 FB2K_MAKE_SERVICE_COREAPI_EXTENSION(playback_control_v3, playback_control_v2);
|
|
|
171 public:
|
|
|
172 //! Custom volume API - for use with specific output devices only. \n
|
|
|
173 //! Note that custom volume SHOULD NOT EVER be presented as a slider where the user can immediately go to the maximum value. \n
|
|
|
174 //! Custom volume mode dispatches on_volume_changed callbacks on change, though the passed value is meaningless; \n
|
|
|
175 //! the components should query the current value from playback_control_v3. \n
|
|
|
176 //! Note that custom volume mode makes set_volume() / get_volume() meaningless, \n
|
|
|
177 //! but volume_up() / volume_down() / volume_mute_toggle() still work like they should (increment/decrement by one unit).
|
|
|
178 //! @returns whether custom volume mode is active.
|
|
|
179 virtual bool custom_volume_is_active() = 0;
|
|
|
180 //! Retrieves the current volume value for the custom volume mode. \n
|
|
|
181 //! The volume units are arbitrary and specified by the device maker; see also: custom_volume_min(), custom_volume_max().
|
|
|
182 virtual int custom_volume_get() = 0;
|
|
|
183 //! Sets the current volume value for the custom volume mode. \n
|
|
|
184 //! The volume units are arbitrary and specified by the device maker; see also: custom_volume_min(), custom_volume_max().
|
|
|
185 //! CAUTION: you should NOT allow the user to easily go immediately to any value, it might blow their speakers out!
|
|
|
186 virtual void custom_volume_set(int val) = 0;
|
|
|
187 //! Returns the minimum custom volume value for the current output device.
|
|
|
188 virtual int custom_volume_min() = 0;
|
|
|
189 //! Returns the maximum custom volume value for the current output device.
|
|
|
190 virtual int custom_volume_max() = 0;
|
|
|
191
|
|
|
192 virtual void restart() = 0;
|
|
|
193 };
|
|
|
194
|
|
|
195 //for compatibility with old code
|
|
|
196 typedef playback_control play_control;
|
|
|
197
|
|
|
198 namespace fb2k {
|
|
|
199 metadb_handle_ptr nowPlaying(bool bAudible = false);
|
|
|
200 metadb_handle_ptr nowPlayingAudible();
|
|
|
201 bool isNowPlaying(metadb_handle_ptr const&, bool bAudible = false);
|
|
|
202 bool isNowPlayingAudible(metadb_handle_ptr const&);
|
|
|
203 bool isNowPlaying(const playable_location&, bool bAudible = false);
|
|
|
204 bool isNowPlayingAudible(const playable_location&);
|
|
|
205 } |
