PipeWire Link¶
digraph inheritance { rankdir=LR; GObject -> WpObject; WpObject -> WpProxy; WpProxy -> WpGlobalProxy; WpGlobalProxy -> WpLink; GInterface -> WpPipewireObject; WpPipewireObject -> WpLink; }-
struct
WpLink
¶ The WpLink class allows accessing the properties and methods of a PipeWire link object (
struct pw_link
).A WpLink is constructed internally when a new link appears on the PipeWire registry and it is made available through the WpObjectManager API. Alternatively, a WpLink can also be constructed using wp_link_new_from_factory(), which creates a new link object on the remote PipeWire server by calling into a factory.
GObject Properties
GObject Signals
- state-changed
-
wplink::
WpLinkState
¶ The state of the link.
- Since
- 0.4.11
Values:
-
2
¶ the link is in error
-
1
¶ the link is unlinked
-
0
¶ the link is initialized
-
1
the link is negotiating formats
-
2
the link is allocating buffers
-
3
¶ the link is paused
-
4
¶ the link is active
-
WpLink *
wp_link_new_from_factory
(WpCore * core, const gchar * factory_name, WpProperties * properties)¶ Constructs a link on the PipeWire server by asking the remote factory factory_name to create it.
Because of the nature of the PipeWire protocol, this operation completes asynchronously at some point in the future. In order to find out when this is done, you should call wp_object_activate(), requesting at least WP_PROXY_FEATURE_BOUND. When this feature is ready, the link is ready for use on the server. If the link cannot be created, this activation operation will fail.
- Return
- (nullable) (transfer full): the new link or NULL if the core is not connected and therefore the link cannot be created
- Parameters
core
: the wireplumber corefactory_name
: the pipewire factory name to construct the linkproperties
: (nullable) (transfer full): the properties to pass to the factory
-
void
wp_link_get_linked_object_ids
(WpLink * self, guint32 * output_node, guint32 * output_port, guint32 * input_node, guint32 * input_port)¶ Retrieves the ids of the objects that are linked by this link.
- Remark
- Requires WP_PIPEWIRE_OBJECT_FEATURE_INFO
- Parameters
self
: the linkoutput_node
: (out) (optional): the bound id of the output (source) nodeoutput_port
: (out) (optional): the bound id of the output (source) portinput_node
: (out) (optional): the bound id of the input (sink) nodeinput_port
: (out) (optional): the bound id of the input (sink) port
-
WpLinkState
wp_link_get_state
(WpLink * self, const gchar ** error)¶ Gets the current state of the link.
- Return
- the current state of the link
- Since
- 0.4.11
- Parameters
self
: the linkerror
: (out) (optional) (transfer none): the error
-
WP_TYPE_LINK
(wp_link_get_type ())¶ The WpLink GType.