mirror of
https://gitlab.freedesktop.org/pipewire/pipewire.git
synced 2025-10-31 22:25:38 -04:00
188 lines
6.7 KiB
XML
188 lines
6.7 KiB
XML
<!DOCTYPE node PUBLIC
|
|
"-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
|
|
"http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd" >
|
|
<node xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
|
|
<!--
|
|
org.pinos.Daemon1:
|
|
@short_description: Main interface for the pinos daemon
|
|
|
|
Interface to get properties from the pinos daemon and to
|
|
establish a client connection.
|
|
-->
|
|
<interface name='org.pinos.Daemon1'>
|
|
<!-- UserName: Name of the user that started the daemon -->
|
|
<property name='UserName' type='s' access='read' />
|
|
<!-- HostName: Name of the machine the daemon is running on -->
|
|
<property name='HostName' type='s' access='read' />
|
|
<!-- Version: Version of the daemon -->
|
|
<property name='Version' type='s' access='read' />
|
|
<!-- Name: Name of the daemon -->
|
|
<property name='Name' type='s' access='read' />
|
|
<!-- Cookie: A random cookie for identifying this instance of Pinos -->
|
|
<property name='Cookie' type='u' access='read' />
|
|
<!-- Properties: Extra properties of the daemon -->
|
|
<property name='Properties' type='a{sv}' access='read' />
|
|
<!-- ConnectClient:
|
|
@properties: properties of the client
|
|
@client: a new client object
|
|
|
|
Register a client to the pinos daemon. A new client object
|
|
will be generated that should be used to perform any other
|
|
action on the server.
|
|
-->
|
|
<method name='ConnectClient'>
|
|
<arg type='a{sv}' name='properties' direction='in'/>
|
|
<arg type='o' name='client' direction='out'/>
|
|
</method>
|
|
</interface>
|
|
|
|
<!--
|
|
org.pinos.Client1:
|
|
@short_description: Main client interface
|
|
|
|
Interface obtained after connecting a client and allows for
|
|
obtaining an output object from a source.
|
|
-->
|
|
<interface name='org.pinos.Client1'>
|
|
<!-- Name: Name of the client -->
|
|
<property name='Name' type='s' access='read' />
|
|
<!-- Name: Properties of the client -->
|
|
<property name='Properties' type='a{sv}' access='read' />
|
|
<!-- Disconnect:
|
|
|
|
Disconnect the client from the server.
|
|
-->
|
|
<method name='Disconnect'/>
|
|
<!-- CreateSourceOutput:
|
|
@source: the Source1 object path or / for default
|
|
@accepted_formats: the formats that can be accepted
|
|
@properties: extra properties
|
|
@output: the SourceOutput1 object path
|
|
|
|
Create a new output for @source with given @incaps
|
|
-->
|
|
<method name='CreateSourceOutput'>
|
|
<arg type='s' name='source' direction='in'/>
|
|
<arg type='s' name='accepted_formats' direction='in'/>
|
|
<arg type='a{sv}' name='properties' direction='in'/>
|
|
<arg type='o' name='output' direction='out'/>
|
|
</method>
|
|
<!-- CreateSourceInput:
|
|
@possible_formats: the formats that can be provided
|
|
@properties: extra properties
|
|
@input: the SourceInput1 object path
|
|
|
|
Create a new source and input object with given @incaps
|
|
-->
|
|
<method name='CreateSourceInput'>
|
|
<arg type='s' name='possible_formats' direction='in'/>
|
|
<arg type='a{sv}' name='properties' direction='in'/>
|
|
<arg type='o' name='input' direction='out'/>
|
|
</method>
|
|
</interface>
|
|
|
|
<!--
|
|
org.pinos.Source1:
|
|
@short_description: Main source interface
|
|
|
|
A source is an object that can provide media content.
|
|
-->
|
|
<interface name='org.pinos.Source1'>
|
|
<!-- Name: the name of the source -->
|
|
<property name='Name' type='s' access='read' />
|
|
<!-- Properties: extra source properties -->
|
|
<property name='Properties' type='a{sv}' access='read' />
|
|
<!-- state: state of the source
|
|
-1 = the source is in error
|
|
0 = the source is suspended, this means the device is closed
|
|
1 = the source is initializing
|
|
2 = the source is idle, this means the device is opened but
|
|
no source-output is consuming the data
|
|
3 = the source is running
|
|
-->
|
|
<property name='State' type='u' access='read' />
|
|
<!-- PossibleFormats:
|
|
|
|
The all possible formats of this source.
|
|
-->
|
|
<property name='PossibleFormats' type='s' access='read' />
|
|
</interface>
|
|
|
|
<!--
|
|
org.pinos.SourceOutput1:
|
|
@short_description: Interface for source output
|
|
|
|
This interface is used to control the output of a source and
|
|
start/stop the media transport.
|
|
-->
|
|
<interface name='org.pinos.SourceOutput1'>
|
|
<!-- Client: the owner client of this source output -->
|
|
<property name='Client' type='o' access='read' />
|
|
<!-- Source: the source of this source output -->
|
|
<property name='Source' type='o' access='read' />
|
|
<!-- PossibleFormats:
|
|
all possible formats of the source output. This is filtered
|
|
against the accepted_formats when creating the source output.
|
|
-->
|
|
<property name='PossibleFormats' type='s' access='read' />
|
|
|
|
<!-- Properties: extra source output properties -->
|
|
<property name='Properties' type='a{sv}' access='read' />
|
|
|
|
<!-- state: state of the source output
|
|
-1 = the source output is in error
|
|
0 = the source output is idle
|
|
1 = the source output is starting
|
|
2 = the source output is streaming
|
|
-->
|
|
<property name='State' type='u' access='read' />
|
|
<!-- Format: the current streaming format -->
|
|
<property name='Format' type='s' access='read' />
|
|
|
|
<!-- Start:
|
|
@requested_format: requested formats
|
|
@fd: output file descriptor
|
|
@format: output format
|
|
|
|
Start the datatransfer of the source with @requested_format.
|
|
|
|
The result is a file descriptor that can be used to get metadata
|
|
and media. @format contains the final media format.
|
|
-->
|
|
<method name='Start'>
|
|
<arg type='s' name='requested_format' direction='in'/>
|
|
<arg type='h' name='fd' direction='out'/>
|
|
<arg type='s' name='format' direction='out'/>
|
|
</method>
|
|
<!-- Stop:
|
|
|
|
Stop data transport
|
|
-->
|
|
<method name='Stop'/>
|
|
<!-- Remove:
|
|
|
|
Remove the source output
|
|
-->
|
|
<method name='Remove'/>
|
|
|
|
<!-- This is a possible push based API. It would require a dbus call
|
|
for each media packet, which is probably not a good idea right now.
|
|
We would probably also want something more lightweight for sending
|
|
the properties with each fd.
|
|
|
|
<method name='Start'>
|
|
<arg type='a{sv}' name='props' direction='in'/>
|
|
<arg type='a{sv}' name='props' direction='out'/>
|
|
</method>
|
|
<method name='Stop'>
|
|
</method>
|
|
<signal name='NewData'>
|
|
<arg type='h' name='data' direction='out'/>
|
|
<arg type='a{sv}' name='props' direction='out'/>
|
|
</signal>
|
|
<method name='FreeData'>
|
|
<arg type='h' name='data' direction='in'/>
|
|
</method>
|
|
-->
|
|
</interface>
|
|
</node>
|