Session Items

digraph inheritance { rankdir=LR; GObject -> WpObject; WpObject -> WpSessionItem; }

struct WpSessionItem

Session items are high level objects that wrap underlying PipeWire objects and manage them. For example, a session item may be managing a node, taking responsibility for configuring the PortConfig and Format parameters of the node. Or another may be managing links between two nodes.

All the implementations are provided by modules and instantiated via the WpSiFactory class.

GObject Properties

id

The session item unique id

guint

G_PARAM_READABLE

properties

The session item properties

WpProperties *

G_PARAM_READABLE

struct _WpSessionItemClass

Public Members

WpObjectClass parent_class
void (*reset)(WpSessionItem *self)

See wp_session_item_reset()

gboolean (*configure)(WpSessionItem *self, WpProperties *props)

See wp_session_item_configure()

gpointer (*get_associated_proxy)(WpSessionItem *self, GType proxy_type)

See wp_session_item_get_associated_proxy()

void (*disable_active)(WpSessionItem *self)

disables the active feature of the session item

void (*disable_exported)(WpSessionItem *self)

disables the exported feature of the session item

void (*enable_active)(WpSessionItem *self, WpTransition *transition)

enables the active feature of the session item

void (*enable_exported)(WpSessionItem *self, WpTransition *transition)

enables the exported feature of the session item

enum WpSessionItemFeatures

Flags to be used as WpObjectFeatures for WpSessionItem subclasses.

Values:

enumerator WP_SESSION_ITEM_FEATURE_ACTIVE = (1 << 0)
enumerator WP_SESSION_ITEM_FEATURE_EXPORTED = (1 << 1)
enumerator WP_SESSION_ITEM_FEATURE_CUSTOM_START = (1 << 16)
guint wp_object_get_id(WpObject *self)

Gets the unique wireplumber Id of this object.

Parameters:

  • self – the session item

void wp_session_item_reset(WpSessionItem *self)

Resets the session item.

This essentially removes the configuration and deactivates all active features.

Parameters:

  • self – the session item

gboolean wp_session_item_configure(WpSessionItem *self, WpProperties *props)

Configures the session item with a set of properties.

Parameters:

  • self – the session item

  • props – (transfer full): the properties used to configure the item

Returns:

TRUE on success, FALSE if the item could not be configured

gboolean wp_session_item_is_configured(WpSessionItem *self)

Checks if the session item is configured.

Parameters:

  • self – the session item

Returns:

TRUE if the item is configured, FALSE otherwise

gpointer wp_session_item_get_associated_proxy(WpSessionItem *self, GType proxy_type)

An associated proxy is a WpProxy subclass instance that is somehow related to this item.

Parameters:

  • self – the session item

  • proxy_type – a WpProxy subclass GType

Returns:

(nullable) (transfer full) (type WpProxy): the associated proxy of the specified proxy_type, or NULL if there is no association to such a proxy

guint32 wp_session_item_get_associated_proxy_id(WpSessionItem *self, GType proxy_type)

Gets the bound id of a proxy associated with the session item.

Parameters:

  • self – the session item

  • proxy_type – a WpProxy subclass GType

Returns:

the bound id of the associated proxy of the specified proxy_type, or SPA_ID_INVALID if there is no association to such a proxy

void wp_session_item_register(WpSessionItem *self)

Registers the session item to its associated core.

Parameters:

  • self – (transfer full): the session item

void wp_session_item_remove(WpSessionItem *self)

Removes the session item from its associated core.

Parameters:

  • self – (transfer none): the session item

WpProperties *wp_session_item_get_properties(WpSessionItem *self)

Gets the properties of a session item.

Parameters:

  • self – the session item

Returns:

(transfer full): the item’s properties.

const gchar *wp_session_item_get_property(WpSessionItem *self, const gchar *key)

Looks up a named session item property value for a given key.

Parameters:

  • self – the session item

  • key – the property key

Returns:

the item property value for the given key.

void wp_session_item_set_properties(WpSessionItem *self, WpProperties *props)

Sets the item’s properties.

This should only be done by sub-classes after the configuration has been done.

Parameters:

  • self – the session item

  • props – (transfer full): the new properties to set

void wp_session_item_handle_proxy_destroyed(WpProxy *proxy, WpSessionItem *item)

Helper callback for sub-classes that deffers and unexports the session item.

Only meant to be used when the pipewire proxy destroyed signal is triggered.

Parameters:

  • proxy – the proxy that was destroyed by the server

  • item – the associated session item

WP_TYPE_SESSION_ITEM (wp_session_item_get_type ())

The WpSessionItem GType.