Audacious $Id:Doxyfile42802007-03-2104:39:00Znenolod$
dbus-service.h
Go to the documentation of this file.
00001 /*
00002  * Audacious: A cross-platform multimedia player
00003  * Copyright (c) 2007 Ben Tucker
00004  *
00005  * This program is free software; you can redistribute it and/or modify
00006  * it under the terms of the GNU General Public License as published by
00007  * the Free Software Foundation; under version 3 of the License.
00008  *
00009  * This program is distributed in the hope that it will be useful,
00010  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00011  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00012  * GNU General Public License for more details.
00013  *
00014  * You should have received a copy of the GNU General Public License
00015  * along with this program.  If not, see <http://www.gnu.org/licenses>.
00016  *
00017  * The Audacious team does not consider modular code linking to
00018  * Audacious or using our public API to be a derived work.
00019  */
00020 
00021 #ifndef AUDACIOUS_DBUS_SERVICE_H
00022 #define AUDACIOUS_DBUS_SERVICE_H
00023 
00024 #include <glib.h>
00025 
00026 #define DBUS_API_SUBJECT_TO_CHANGE
00027 #include <dbus/dbus-glib.h>
00028 
00029 typedef struct {
00030     GObject parent;
00031     DBusGProxy *proxy;
00032 } RemoteObject, MprisRoot, MprisPlayer, MprisTrackList;
00033 
00034 typedef struct {
00035     GObjectClass parent_class;
00036 } RemoteObjectClass, MprisRootClass, MprisPlayerClass, MprisTrackListClass;
00037 
00038 void init_dbus();
00039 void free_dbus();
00040 DBusGProxy *audacious_get_dbus_proxy();
00041 
00042 /* MPRIS API */
00043 // Capabilities
00044 enum {
00045     MPRIS_CAPS_NONE                     = 0,
00046     MPRIS_CAPS_CAN_GO_NEXT              = 1 << 0,
00047     MPRIS_CAPS_CAN_GO_PREV              = 1 << 1,
00048     MPRIS_CAPS_CAN_PAUSE                = 1 << 2,
00049     MPRIS_CAPS_CAN_PLAY                 = 1 << 3,
00050     MPRIS_CAPS_CAN_SEEK                 = 1 << 4,
00051     MPRIS_CAPS_CAN_PROVIDE_METADATA     = 1 << 5,
00052     MPRIS_CAPS_PROVIDES_TIMING          = 1 << 6,
00053 };
00054 
00055 // Status
00056 typedef enum {
00057         MPRIS_STATUS_PLAY = 0,
00058         MPRIS_STATUS_PAUSE,
00059         MPRIS_STATUS_STOP
00060 } PlaybackStatus;
00061 
00062 // MPRIS /
00063 gboolean mpris_root_identity(MprisRoot *obj, gchar **identity,
00064                              GError **error);
00065 gboolean mpris_root_quit(MprisPlayer *obj, GError **error);
00066 
00067 // MPRIS /Player
00068 gboolean mpris_player_next(MprisPlayer *obj, GError **error);
00069 gboolean mpris_player_prev(MprisPlayer *obj, GError **error);
00070 gboolean mpris_player_pause(MprisPlayer *obj, GError **error);
00071 gboolean mpris_player_stop(MprisPlayer *obj, GError **error);
00072 gboolean mpris_player_play(MprisPlayer *obj, GError **error);
00073 gboolean mpris_player_repeat(MprisPlayer *obj, gboolean rpt, GError **error);
00074 gboolean mpris_player_get_status(MprisPlayer *obj, GValueArray **status,
00075                                  GError **error);
00076 gboolean mpris_player_get_metadata(MprisPlayer *obj, GHashTable **metadata,
00077                                    GError **error);
00078 gboolean mpris_player_get_caps(MprisPlayer *obj, gint *capabilities,
00079                                  GError **error);
00080 gboolean mpris_player_volume_set(MprisPlayer *obj, gint vol, GError **error);
00081 gboolean mpris_player_volume_get(MprisPlayer *obj, gint *vol,
00082                                  GError **error);
00083 gboolean mpris_player_position_set(MprisPlayer *obj, gint pos, GError **error);
00084 gboolean mpris_player_position_get(MprisPlayer *obj, gint *pos,
00085                                    GError **error);
00086 enum {
00087     TRACK_CHANGE_SIG,
00088     STATUS_CHANGE_SIG,
00089     CAPS_CHANGE_SIG,
00090     LAST_SIG
00091 };
00092 
00093 enum {
00094     TRACKLIST_CHANGE_SIG,
00095     LAST_TRACKLIST_SIG
00096 };
00097 
00098 gboolean mpris_emit_track_change(MprisPlayer *obj);
00099 gboolean mpris_emit_status_change(MprisPlayer *obj, PlaybackStatus status);
00100 gboolean mpris_emit_caps_change(MprisPlayer *obj);
00101 gboolean mpris_emit_tracklist_change(MprisTrackList *obj, gint playlist);
00102 
00103 // MPRIS /TrackList
00104 gboolean mpris_tracklist_get_metadata(MprisTrackList *obj, gint pos,
00105                                       GHashTable **metadata, GError **error);
00106 gboolean mpris_tracklist_get_current_track(MprisTrackList *obj, gint *pos,
00107                                            GError **error);
00108 gboolean mpris_tracklist_get_length(MprisTrackList *obj, gint *length,
00109                                     GError **error);
00110 gboolean mpris_tracklist_add_track(MprisTrackList *obj, gchar *uri,
00111                                    gboolean play, GError **error);
00112 gboolean mpris_tracklist_del_track(MprisTrackList *obj, gint pos,
00113                                    GError **error);
00114 gboolean mpris_tracklist_loop(MprisTrackList *obj, gboolean loop,
00115                               GError **error);
00116 gboolean mpris_tracklist_random(MprisTrackList *obj, gboolean random,
00117                                 GError **error);
00118 
00119 /* Legacy API */
00120 // Audacious General Information
00121 gboolean audacious_rc_version(RemoteObject *obj, gchar **version, GError **error);
00122 gboolean audacious_rc_quit(RemoteObject *obj, GError **error);
00123 gboolean audacious_rc_eject(RemoteObject *obj, GError **error);
00124 gboolean audacious_rc_main_win_visible(RemoteObject *obj,
00125                                        gboolean *is_main_win, GError **error);
00126 gboolean audacious_rc_show_main_win(RemoteObject *obj, gboolean show,
00127                                     GError **error);
00128 gboolean audacious_rc_equalizer_visible(RemoteObject *obj, gboolean *is_eq_win,
00129                                         GError **error);
00130 gboolean audacious_rc_show_equalizer(RemoteObject *obj, gboolean show,
00131                                      GError **error);
00132 gboolean audacious_rc_playlist_visible(RemoteObject *obj,
00133                                        gboolean *is_pl_win,
00134                                        GError **error);
00135 gboolean audacious_rc_show_playlist(RemoteObject *obj, gboolean show,
00136                                     GError **error);
00137 gboolean audacious_rc_get_tuple_fields(RemoteObject *obj, gchar ***fields,
00138                                     GError **error);
00139 
00140 // Playback Information/Manipulation
00141 gboolean audacious_rc_play(RemoteObject *obj, GError **error);
00142 gboolean audacious_rc_pause(RemoteObject *obj, GError **error);
00143 gboolean audacious_rc_stop(RemoteObject *obj, GError **error);
00144 gboolean audacious_rc_playing(RemoteObject *obj, gboolean *is_playing,
00145                               GError **error);
00146 gboolean audacious_rc_paused(RemoteObject *obj, gboolean *is_paused,
00147                              GError **error);
00148 gboolean audacious_rc_stopped(RemoteObject *obj, gboolean *is_stopped,
00149                               GError **error);
00150 gboolean audacious_rc_status(RemoteObject *obj, gchar **status,
00151                              GError **error);
00152 gboolean audacious_rc_info(RemoteObject *obj, gint *rate, gint *freq,
00153                            gint *nch, GError **error);
00154 gboolean audacious_rc_time(RemoteObject *obj, gint *time, GError **error);
00155 gboolean audacious_rc_seek(RemoteObject *obj, guint pos, GError **error);
00156 gboolean audacious_rc_volume(RemoteObject *obj, gint *vl, gint *vr,
00157                              GError **error);
00158 gboolean audacious_rc_set_volume(RemoteObject *obj, gint vl, gint vr,
00159                                  GError **error);
00160 gboolean audacious_rc_balance(RemoteObject *obj, gint *balance,
00161                               GError **error);
00162 
00163 // Playlist Information/Manipulation
00164 gboolean audacious_rc_position(RemoteObject *obj, int *pos, GError **error);
00165 gboolean audacious_rc_advance(RemoteObject *obj, GError **error);
00166 gboolean audacious_rc_reverse(RemoteObject *obj, GError **error);
00167 gboolean audacious_rc_length(RemoteObject *obj, int *length,
00168                              GError **error);
00169 gboolean audacious_rc_song_title(RemoteObject *obj, guint pos,
00170                                  gchar **title, GError **error);
00171 gboolean audacious_rc_song_filename(RemoteObject *obj, guint pos,
00172                                     gchar **filename, GError **error);
00173 gboolean audacious_rc_song_length(RemoteObject *obj, guint pos, int *length,
00174                                   GError **error);
00175 gboolean audacious_rc_song_frames(RemoteObject *obj, guint pos, int *length,
00176                                   GError **error);
00177 gboolean audacious_rc_song_tuple(RemoteObject *obj, guint pos, gchar *tuple,
00178                                  GValue *value, GError **error);
00179 gboolean audacious_rc_jump(RemoteObject *obj, guint pos, GError **error);
00180 gboolean audacious_rc_add(RemoteObject *obj, gchar *file, GError **error);
00181 gboolean audacious_rc_add_url(RemoteObject *obj, gchar *url,
00182                               GError **error);
00183 gboolean audacious_rc_add_list (RemoteObject * obj, gchar * * filenames,
00184  GError * * error);
00185 gboolean audacious_rc_open_list (RemoteObject * obj, gchar * * filenames,
00186  GError * * error);
00187 gboolean audacious_rc_open_list_to_temp (RemoteObject * obj, gchar * *
00188  filenames, GError * * error);
00189 gboolean audacious_rc_delete(RemoteObject *obj, guint pos, GError **error);
00190 gboolean audacious_rc_clear(RemoteObject *obj, GError **error);
00191 gboolean audacious_rc_auto_advance(RemoteObject *obj, gboolean *is_advance,
00192                                    GError **error);
00193 gboolean audacious_rc_toggle_auto_advance(RemoteObject *obj, GError **error);
00194 gboolean audacious_rc_repeat(RemoteObject *obj, gboolean *is_repeat,
00195                              GError **error);
00196 gboolean audacious_rc_toggle_repeat(RemoteObject *obj, GError **error);
00197 gboolean audacious_rc_shuffle(RemoteObject *obj, gboolean *is_shuffle,
00198                               GError **error);
00199 gboolean audacious_rc_toggle_shuffle(RemoteObject *obj, GError **error);
00200 
00201 /* new */
00202 gboolean audacious_rc_show_prefs_box(RemoteObject *obj, gboolean show, GError **error);
00203 gboolean audacious_rc_show_about_box(RemoteObject *obj, gboolean show, GError **error);
00204 gboolean audacious_rc_show_jtf_box(RemoteObject *obj, gboolean show, GError **error);
00205 gboolean audacious_rc_show_filebrowser(RemoteObject *obj, gboolean show, GError **error); //new Nov 8
00206 gboolean audacious_rc_play_pause(RemoteObject *obj, GError **error);
00207 gboolean audacious_rc_activate(RemoteObject *obj, GError **error);
00208 gboolean audacious_rc_queue_get_list_pos(RemoteObject *obj, gint qpos, gint *pos, GError **error);
00209 gboolean audacious_rc_queue_get_queue_pos(RemoteObject *obj, gint pos, gint *qpos, GError **error);
00210 gboolean audacious_rc_get_info(RemoteObject *obj, gint *rate, gint *freq, gint *nch, GError **error);
00211 gboolean audacious_rc_toggle_aot(RemoteObject *obj, gboolean ontop, GError **error);
00212 gboolean audacious_rc_get_playqueue_length(RemoteObject *obj, gint *length, GError **error);
00213 gboolean audacious_rc_playqueue_add(RemoteObject *obj, gint pos, GError **error);
00214 gboolean audacious_rc_playqueue_remove(RemoteObject *obj, gint pos, GError **error);
00215 gboolean audacious_rc_playqueue_clear(RemoteObject *obj, GError **error);
00216 gboolean audacious_rc_playqueue_is_queued(RemoteObject *obj, gint pos, gboolean *is_queued, GError **error);
00217 gboolean audacious_rc_playlist_ins_url_string(RemoteObject *obj, gchar *url, gint pos, GError **error);
00218 gboolean audacious_rc_playlist_enqueue_to_temp(RemoteObject *obj, gchar *url, GError **error);
00219 gboolean audacious_rc_playlist_add(RemoteObject *obj, gpointer list, GError **error);
00220 
00221 /* new on nov 7 */
00222 gboolean audacious_rc_get_eq(RemoteObject *obj, gdouble *preamp, GArray **bands, GError **error);
00223 gboolean audacious_rc_get_eq_preamp(RemoteObject *obj, gdouble *preamp, GError **error);
00224 gboolean audacious_rc_get_eq_band(RemoteObject *obj, gint band, gdouble *value, GError **error);
00225 gboolean audacious_rc_set_eq(RemoteObject *obj, gdouble preamp, GArray *bands, GError **error);
00226 gboolean audacious_rc_set_eq_preamp(RemoteObject *obj, gdouble preamp, GError **error);
00227 gboolean audacious_rc_set_eq_band(RemoteObject *obj, gint band, gdouble value, GError **error);
00228 gboolean audacious_rc_equalizer_activate(RemoteObject *obj, gboolean active, GError **error);
00229 
00230 /* new in 2.4 */
00231 gboolean audacious_rc_get_active_playlist_name(RemoteObject *obj, gchar **title, GError **error);
00232 
00233 #endif /* AUDACIOUS_DBUS_SERVICE_H */