Gst.PbUtils.Discoverer – gstreamer-pbutils-1.0

Description:

[ CCode ( cname = "GstDiscoverer" , lower_case_cprefix = "gst_discoverer_" , type_id = "gst_discoverer_get_type ()" ) ]
[ GIR ( name = "Discoverer" ) ]
public class Discoverer : Object

The Discoverer is a utility object which allows to get as much information as possible from one or many URIs.

It provides two APIs, allowing usage in blocking or non-blocking mode.

The blocking mode just requires calling discover_uri with the URI one wishes to discover.

The non-blocking mode requires a running MainLoop iterating a MainContext, where one connects to the various signals, appends the URIs to be processed (through discover_uri_async) and then asks for the discovery to begin (through start). By default this will use the GLib default main context unless you have set a custom context using push_thread_default.

All the information is returned in a DiscovererInfo structure.

Content:

Properties:

public uint64 timeout { get; set construct; }

The duration (in nanoseconds) after which the discovery of an individual URI will timeout.

public bool use_cache { get; set construct; }

Creation methods:

public Discoverer (ClockTime timeout) throws Error

Creates a new Discoverer with the provided timeout.

Methods:

public DiscovererInfo discover_uri (string uri) throws Error

Synchronously discovers the given uri.

public bool discover_uri_async (string uri)

Appends the given uri to the list of URIs to discoverer.

public void start ()

Allow asynchronous discovering of URIs to take place.

public void stop ()

Stop the discovery of any pending URIs and clears the list of pending URIS (if any).

Signals:

public virtual signal void discovered (DiscovererInfo info, Error? err)

Will be emitted in async mode when all information on a URI could be discovered, or an error occurred.

public virtual signal void finished ()

Will be emitted in async mode when all pending URIs have been processed.

public virtual signal void source_setup (Element source)

This signal is emitted after the source element has been created for, so the URI being discovered, so it can be configured by setting additional properties (e.g. set a proxy server for an http source, or set the device and read speed for an audio cd source).

public virtual signal void starting ()

Will be emitted when the discover starts analyzing the pending URIs

Inherited Members:

All known members inherited from class GLib.Object

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref

Discoverer