dacp-share

dacp-share

Synopsis

#define             DACP_TYPE_SHARE
#define             DACP_SHARE                          (o)
#define             DACP_SHARE_CLASS                    (k)
#define             IS_DACP_SHARE                       (o)
#define             IS_DACP_SHARE_CLASS                 (k)
#define             DACP_SHARE_GET_CLASS                (o)
typedef             DACPSharePrivate;
gboolean            (*lookup_guid)                      (DACPShare *share,
                                                         gchar *guid);
void                (*add_guid)                         (DACPShare *share,
                                                         gchar *guid);
void                (*remote_found)                     (DACPShare *share,
                                                         gchar *service_name,
                                                         gchar *remote_name);
void                (*remote_lost)                      (DACPShare *share,
                                                         gchar *service_name);
void                (*remote_paired)                    (DACPShare *share,
                                                         gchar *service_name,
                                                         gboolean connected);
GType               dacp_share_get_type                 (void);
DACPShare *         dacp_share_new                      (const gchar *library_name,
                                                         DACPPlayer *player,
                                                         DMAPDb *db,
                                                         DMAPContainerDb *container_db);
void                dacp_share_pair                     (DACPShare *share,
                                                         gchar *service_name,
                                                         gchar passcode[4]);
void                dacp_share_start_lookup             (DACPShare *share);
void                dacp_share_stop_lookup              (DACPShare *share);
void                dacp_share_player_updated           (DACPShare *share);

Description

Details

DACP_TYPE_SHARE

#define DACP_TYPE_SHARE         (dacp_share_get_type ())

The type for DACPShare.


DACP_SHARE()

#define             DACP_SHARE(o)

Casts a DACPShare or derived pointer into a (DACPShare*) pointer. Depending on the current debugging level, this function may invoke certain runtime checks to identify invalid casts.

o :

Object which is subject to casting.

DACP_SHARE_CLASS()

#define             DACP_SHARE_CLASS(k)

Casts a derived DACPShareClass structure into a DACPShareClass structure.

k :

a valid DACPShareClass

IS_DACP_SHARE()

#define             IS_DACP_SHARE(o)

Checks whether a valid GTypeInstance pointer is of type DACP_TYPE_SHARE.

o :

Instance to check for being a DACP_TYPE_SHARE.

IS_DACP_SHARE_CLASS()

#define             IS_DACP_SHARE_CLASS(k)

Checks whether k "is a" valid DACPShareClass structure of type DACP_SHARE or derived.

k :

a DACPShareClass

DACP_SHARE_GET_CLASS()

#define             DACP_SHARE_GET_CLASS(o)

Get the class structure associated to a DACPShare instance.

o :

a DACPShare instance.

Returns :

pointer to object class structure.

DACPSharePrivate

typedef struct DACPSharePrivate DACPSharePrivate;


lookup_guid ()

gboolean            (*lookup_guid)                      (DACPShare *share,
                                                         gchar *guid);


add_guid ()

void                (*add_guid)                         (DACPShare *share,
                                                         gchar *guid);


remote_found ()

void                (*remote_found)                     (DACPShare *share,
                                                         gchar *service_name,
                                                         gchar *remote_name);


remote_lost ()

void                (*remote_lost)                      (DACPShare *share,
                                                         gchar *service_name);


remote_paired ()

void                (*remote_paired)                    (DACPShare *share,
                                                         gchar *service_name,
                                                         gboolean connected);


dacp_share_get_type ()

GType               dacp_share_get_type                 (void);


dacp_share_new ()

DACPShare *         dacp_share_new                      (const gchar *library_name,
                                                         DACPPlayer *player,
                                                         DMAPDb *db,
                                                         DMAPContainerDb *container_db);

Creates a new DACP share and publishes it using mDNS.

library_name :

The library name that will be shown in the remote.

player :

A DACPPlayer instance, used to retrieve information from a player implementation.

db :

a media database represented by a DMAPDb instance.

container_db :

a container (album) database represented by a DMAPContainerDb instance.

Returns :

a pointer to a DACPShare.

dacp_share_pair ()

void                dacp_share_pair                     (DACPShare *share,
                                                         gchar *service_name,
                                                         gchar passcode[4]);

Pairs a DACP client (Remote) with this server. If the passcode is correct (the same as shown on the remote), the remote will start connecting to this server.

share :

a DACPShare

service_name :

DACP client (remote) service identifier.

passcode :

4-Digit PIN code entered by the user.

dacp_share_start_lookup ()

void                dacp_share_start_lookup             (DACPShare *share);

Start looking up for DACP remotes. Connect to "remote-found" signal to detect new remotes. Be aware that when a DACPShare is created, only after calling this function is that it starts looking up for Remotes on the network.

share :

A DACPShare.

dacp_share_stop_lookup ()

void                dacp_share_stop_lookup              (DACPShare *share);

Stop looking up for DACP remotes.

share :

A DACPShare.

dacp_share_player_updated ()

void                dacp_share_player_updated           (DACPShare *share);