Discoverer

Object Hierarchy:

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.

Namespace: Gst.PbUtils

Package: gstreamer-pbutils-1.0

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 virtual DiscovererInfo load_serialize_info (string uri)
Loads the serialized info from the given uri.
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 signal DiscovererInfo? load_serialized_info (string uri)
Retrieves information about a URI from and external source of information, like a cache file.
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