/home/bifh1/fremantle-i386-fremantle-pe1.cs2007q3/work/libplayback-0.5/libplayback/playback.h

Go to the documentation of this file.

/*
** Playback manager - client library implementation (using D-Bus)
** (c) Nokia MM - Makoto Sugano, 2007
**
*/

#ifndef PLAYBACK_H_
# define PLAYBACK_H_

#include <dbus/dbus.h>
#include <stdint.h>
#include <unistd.h>
#include <sys/types.h>

#include <libplayback/playback-macros.h>
#include <libplayback/playback-types.h>

PB_BEGIN_DECLS

typedef struct pb_playback_s    pb_playback_t;

typedef struct pb_req_s         pb_req_t;

typedef void    (* PBStateRequest)              (pb_playback_t *pb, enum pb_state_e req_state, pb_req_t* ext_req, void *data);

typedef void    (* PBStateHint)                 (pb_playback_t *pb, const int allowed_state[], void *data);

typedef void (* PBPrivacyCb) (int override, const char *error, void *data);

typedef void (* PBMuteCb) (int mute, const char *error, void *data);

typedef void (* PBBluetoothCb) (enum pb_bt_override_status_e, const char *error, void *data);


/* FIXME: why is PB_STATE_NONE if denied? Why doesn't the manager just
 * tell the correct state? */
typedef void    (* PBStateReply)                (pb_playback_t *pb, enum pb_state_e granted_state, const char *reason,
                                                 pb_req_t* req, void *data);

pb_playback_t * pb_playback_new_2                       (DBusConnection *connection,
                                                 enum pb_class_e pb_class, uint32_t flags, enum pb_state_e pb_state,
                                                 PBStateRequest state_req_handler, void *data);

pb_playback_t * pb_playback_new                 (DBusConnection *connection,
                                                 enum pb_class_e pb_class, enum pb_state_e pb_state,
                                                 PBStateRequest state_req_handler, void *data);

void            pb_playback_set_state_hint      (pb_playback_t *pb, PBStateHint state_hint_handler, void *data);

pb_req_t*       pb_playback_req_state           (pb_playback_t *pb, enum pb_state_e pb_state, PBStateReply state_reply, void *data);

/* returns only error status, the current privacy override status comes
 * to the callback. */

int pb_get_privacy_override(DBusConnection *connection);

int pb_req_privacy_override(DBusConnection *connection, int override);

int pb_get_mute(DBusConnection *connection);

int pb_req_mute(DBusConnection *connection, int mute);

int pb_get_bluetooth_override(DBusConnection *connection);

int pb_req_bluetooth_override(DBusConnection *connection, int override);
/* setters for the callbacks */

void pb_set_privacy_override_cb(DBusConnection *connection, PBPrivacyCb privacy_cb, void *data);

void pb_set_mute_cb(DBusConnection *connection, PBMuteCb mute_cb, void *data);

void pb_set_bluetooth_override_cb(DBusConnection *connection, PBBluetoothCb bluetooth_cb, void *data);

void pb_playback_set_pid(pb_playback_t *pb, pid_t pid);
void pb_playback_set_stream(pb_playback_t *pb, char *stream);

int             pb_playback_req_discarded       (pb_playback_t *pb, pb_req_t *req, const char *reason);
int             pb_playback_req_completed       (pb_playback_t *pb, pb_req_t *req);

void            pb_playback_destroy             (pb_playback_t *pb);

PB_END_DECLS

#endif /* !PLAYBACK_H_ */

---