![]() |
![]() |
![]() |
libdmapsharing Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
#define TYPE_DACP_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; DACPShare; DACPShareClass; 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
);
"add-guid" : Run Last "lookup-guid" : Run Last "remote-found" : Run Last "remote-lost" : Run Last "remote-paired" : Run Last
#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.
|
Object which is subject to casting. |
#define DACP_SHARE_CLASS(k)
Casts a derived DACPShareClass structure into a DACPShareClass structure.
|
a valid DACPShareClass |
#define IS_DACP_SHARE(o)
Checks whether a valid GTypeInstance pointer is of type TYPE_DACP_SHARE
.
|
Instance to check for being a TYPE_DACP_SHARE .
|
#define IS_DACP_SHARE_CLASS(k)
Checks whether k
"is a" valid DACPShareClass structure of type
DACP_SHARE
or derived.
|
a DACPShareClass |
#define DACP_SHARE_GET_CLASS(o)
Get the class structure associated to a DACPShare instance.
|
a DACPShare instance. |
Returns : |
pointer to object class structure. |
typedef struct { DAAPShareClass daap_share_class; 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); } DACPShareClass;
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.
|
The library name that will be shown in the remote. |
|
A DACPPlayer instance, used to retrieve information from a player implementation. |
|
a media database represented by a DMAPDb instance. |
|
a container (album) database represented by a DMAPContainerDb instance. |
Returns : |
a pointer to a DACPShare. |
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.
|
a DACPShare |
|
DACP client (remote) service identifier. |
|
4-Digit PIN code entered by the user. |
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.
|
A DACPShare. |
void dacp_share_stop_lookup (DACPShare *share
);
Stop looking up for DACP remotes.
|
A DACPShare. |
"library-name"
property"library-name" gchar* : Read / Write
Library name as will be shown in the Remote.
Default value: NULL
"add-guid"
signalvoid user_function (DACPShare *share, gchar *guid, gpointer user_data) : Run Last
Signal emited when the remote wants to log in and save a special guid which will be used later when it wants to reconnect. With this guid, we know that this remote has connected before, thus this signal must save somewhere all guids that connected before, so that ::lookup-guid will find this remote. The user interface probably wants to include a button to forget previously connected remotes, so that the user may disconnect all previously connected remotes.
|
the DACPShare that received the signal |
|
a string containing the guid to be saved. |
|
user data set when the signal handler was connected. |
"lookup-guid"
signalgboolean user_function (DACPShare *share, gchar *guid, gpointer user_data) : Run Last
Signal emited when the remote has logged in before and wants to be validated. An implementation must implement this signal to lookup for guids saved by ::add-guid
|
the DACPShare that received the signal |
|
a string containing the guid to be validated. |
|
user data set when the signal handler was connected. |
"remote-found"
signalvoid user_function (DACPShare *share, gchar *service_name, gchar *remote_name, gpointer user_data) : Run Last
Signal emited when a remote is found in the local network.
|
the DACPShare that received the signal. |
|
the remote identifier. |
|
the remote friendly name. |
|
user data set when the signal handler was connected. |
"remote-lost"
signalvoid user_function (DACPShare *share, gchar *service_name, gpointer user_data) : Run Last
Signal emited when a remote is lost in the local network.
|
the DACPShare that received the signal |
|
the remote identifier. |
|
user data set when the signal handler was connected. |
"remote-paired"
signalvoid user_function (DACPShare *share, gchar *service_name, gboolean connected, gpointer user_data) : Run Last
Signal emited when a remote is paired.
|
the DACPShare that received the signal |
|
the remote identifier. |
|
indicates if the connection was succesfull or not. |
|
user data set when the signal handler was connected. |