Top | ![]() |
![]() |
![]() |
![]() |
GUPnPDLNAProfileGuesserGUPnPDLNAProfileGuesser — Utility API for discovering DLNA profile for given media. |
gboolean | extended-mode | Read / Write / Construct Only |
gboolean | relaxed-mode | Read / Write / Construct Only |
The API provides synchronous and asynchronous guessing of DLNA profile. The asynchronous mode requires a running GMainLoop in the default GMainContext.
GUPnPDLNAProfileGuesser * gupnp_dlna_profile_guesser_new (gboolean relaxed_mode
,gboolean extended_mode
);
Creates a new guesser that will use specific DLNA profiles for
matching - i.e. which profiles will be used depends on
relaxed_mode
and extended_mode
.
gboolean gupnp_dlna_profile_guesser_guess_profile_async (GUPnPDLNAProfileGuesser *guesser
,const gchar *uri
,guint timeout_in_ms
,GError **error
);
Asynchronously guesses DLNA profile for given uri
. When guessing
is done, ::done signal is emitted on guesser
.
guesser |
GUPnPDLNAProfileGuesser object to use for guessing. |
|
uri |
URI of media. |
|
timeout_in_ms |
Timeout of guessing in miliseconds. |
|
error |
GError object or |
GUPnPDLNAProfile * gupnp_dlna_profile_guesser_guess_profile_sync (GUPnPDLNAProfileGuesser *guesser
,const gchar *uri
,guint timeout_in_ms
,GUPnPDLNAInformation **dlna_info
,GError **error
);
Synchronously guesses DLNA profile for given uri
.
guesser |
GUPnPDLNAProfileGuesser object to use for guessing. |
|
uri |
URI of media. |
|
timeout_in_ms |
Timeout of guessing in miliseconds. |
|
dlna_info |
A place where to
store DLNA information or |
[allow-none][transfer full][out] |
error |
GError object or |
[allow-none] |
GUPnPDLNAProfile * gupnp_dlna_profile_guesser_guess_profile_from_info (GUPnPDLNAProfileGuesser *guesser
,GUPnPDLNAInformation *info
);
Guesses the profile which fits to passed info
.
GUPnPDLNAProfile * gupnp_dlna_profile_guesser_get_profile (GUPnPDLNAProfileGuesser *guesser
,const gchar *name
);
Lookups for GUPnPDLNAProfile with given name
.
guesser |
The GUPnPDLNAProfileGuesser object. |
|
name |
The name of the DLNA profile to be retrieved. |
GList *
gupnp_dlna_profile_guesser_list_profiles
(GUPnPDLNAProfileGuesser *guesser
);
Gets a list of the all DLNA profiles supported by guesser
.
A GList
of GUPnPDLNAProfile on success, NULL
otherwise.
[transfer none][element-type GUPnPDLNAProfile]
gboolean
gupnp_dlna_profile_guesser_get_relaxed_mode
(GUPnPDLNAProfileGuesser *guesser
);
gboolean
gupnp_dlna_profile_guesser_get_extended_mode
(GUPnPDLNAProfileGuesser *guesser
);
void
gupnp_dlna_profile_guesser_cleanup (void
);
Cleans up the DLNA profiles. Provided to remove Valgrind noise. Not thread-safe. Do not call it if there is even a slightest chance that profile guessing will be performed during process lifetime. The profiles are not reloaded after cleanup.
typedef struct _GUPnPDLNAProfileGuesser GUPnPDLNAProfileGuesser;
The top-level object used to for DLNA profile guessing.
“extended-mode”
property “extended-mode” gboolean
Whether profile matching should be done also against DLNA profiles not being a part of DLNA specification.
Flags: Read / Write / Construct Only
Default value: FALSE
“done”
signalvoid user_function (GUPnPDLNAProfileGuesser *profile_guesser, GUPnPDLNAInformation *info, GUPnPDLNAProfile *dlna, GError *error, gpointer user_data)
Will be emitted when guessing DLNA profile for a URI has finished.
profile_guesser |
||
info |
URI metadata as GUPnPDLNAInformation. |
[transfer none] |
dlna |
The results as GUPnPDLNAProfile. |
[allow-none][transfer none] |
error |
Contains details of the error if discovery failed,
else is |
[allow-none] |
user_data |
user data set when the signal handler was connected. |
Flags: Run Last