org.freedesktop.gstreamer.device

Class DeviceMonitor

java.lang.Object

org.freedesktop.gstreamer.glib.NativeObject

org.freedesktop.gstreamer.glib.RefCountedObject

org.freedesktop.gstreamer.glib.GObject

org.freedesktop.gstreamer.GstObject

org.freedesktop.gstreamer.device.DeviceMonitor

All Implemented Interfaces:

AutoCloseable

public class DeviceMonitor
extends GstObject

A device monitor and prober

See upstream documentation at https://gstreamer.freedesktop.org/data/doc/gstreamer/stable/gstreamer/html/gstreamer-GstDeviceMonitor.html

Applications should create a DeviceMonitor when they want to probe, list and monitor devices of a specific type. The DeviceMonitor will create the appropriate DeviceProvider objects and manage them. It will then post messages on its Bus for devices that have been added and removed.

The device monitor will monitor all devices matching the filters that the application has set.

Nested Class Summary

Nested classes/interfaces inherited from class org.freedesktop.gstreamer.GstObject

GstObject.Handle

Nested classes/interfaces inherited from class org.freedesktop.gstreamer.glib.GObject

GObject.GCallback, GObject.GInterface

Nested classes/interfaces inherited from class org.freedesktop.gstreamer.glib.NativeObject

NativeObject.Initializer, NativeObject.TypeProvider, NativeObject.TypeRegistration<T extends NativeObject>

Field Summary

Fields

Modifier and Type	Field and Description
static String	GTYPE_NAME

Constructor Summary

Constructors

Constructor and Description
DeviceMonitor()

Method Summary

Modifier and Type	Method and Description
int	addFilter(String classes, Caps caps) Adds a filter for which devices will be monitored, any device that matches all these classes and the Caps will be returned.
Bus	getBus() Get the Bus for this DeviceMonitor
List<Device>	getDevices() Gets a list of devices from all of the relevant monitors.
boolean	removeFilter(int filterId) Remove a filter from the DeviceMonitor using the id that was returned from addFilter(java.lang.String, org.freedesktop.gstreamer.Caps)
boolean	start() Starts monitoring the devices, once this has succeeded, the GST_MESSAGE_DEVICE_ADDED and GST_MESSAGE_DEVICE_REMOVED messages will be emitted on the bus when the list of devices changes.
void	stop() Stop monitoring devices.

Methods inherited from class org.freedesktop.gstreamer.GstObject

addControlBinding, getAsString, getControlBinding, getName, getParent, hasActiveControlBindings, removeControlBinding, setAsString, setControlBindingDisabled, setControlBindingsDisabled, setName, suggestNextSync, syncValues, toString

Methods inherited from class org.freedesktop.gstreamer.glib.GObject

addCallback, connect, connect, disconnect, dispose, emit, emit, get, getPropertyDefaultValue, getPropertyMaximumValue, getPropertyMinimumValue, getRefCount, getTypeName, invalidate, listPropertyNames, removeCallback, set

Methods inherited from class org.freedesktop.gstreamer.glib.NativeObject

close, disown, equals, getPointer, getRawPointer, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

GTYPE_NAME

public static final String GTYPE_NAME

See Also:

Constant Field Values

Constructor Detail

DeviceMonitor

public DeviceMonitor()

Method Detail

getBus

public Bus getBus()

Get the Bus for this DeviceMonitor

Returns:

bus

addFilter

public int addFilter(String classes,
                     Caps caps)

Adds a filter for which devices will be monitored, any device that matches all these classes and the Caps will be returned.

If this function is called multiple times to add more filters, each will be matched independently. That is, adding more filters will not further restrict what devices are matched.

The GstCaps supported by the device as returned by gst_device_get_caps() are not intersected with caps filters added using this function.

Filters must be added before the GstDeviceMonitor is started.

Parameters:

classes - device classes to use as filter or NULL for any class.

caps - the GstCaps to filter or NULL for ANY.

Returns:

id the id of the new filter or 0 if no provider matched the filter's classes.

removeFilter

public boolean removeFilter(int filterId)

Remove a filter from the DeviceMonitor using the id that was returned from addFilter(java.lang.String, org.freedesktop.gstreamer.Caps)

Parameters:

filterId - of filter to remove

Returns:

true if the filter id was valid and the filter was removed

start

public boolean start()

Starts monitoring the devices, once this has succeeded, the GST_MESSAGE_DEVICE_ADDED and GST_MESSAGE_DEVICE_REMOVED messages will be emitted on the bus when the list of devices changes.

Returns:

true if the device monitoring could be started

stop

public void stop()

Stop monitoring devices.

getDevices

public List<Device> getDevices()

Gets a list of devices from all of the relevant monitors. This may actually probe the hardware if the monitor is not currently started.

Returns:

list of Device