a2a4067e07
When a stream is destroyed by a consumer, mutter won't be able to recognize that. For mutter, the stream just paused, but did not disconnect, because the connection state of a PipeWire stream only represents, whether the respective PipeWire context is connected to PipeWire. In addition to that, it may be the case, that the stream consumer just recreates the stream. So even if mutter would be able to know, when the stream consumer destroyed a stream, but not the whole screencast or remote-desktop session, then mutter would not know, whether the stream will be resumed eventually or not. So, add an explicit API call to the screencast interface to stop a stream. For virtual streams, this also means, that the respective virtual monitor is destroyed. Closes: https://gitlab.gnome.org/GNOME/mutter/-/issues/2889 Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3307>
240 lines
8 KiB
XML
240 lines
8 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>
|
|
|
|
<!--
|
|
org.gnome.Mutter.ScreenCast:
|
|
@short_description: Screen cast interface
|
|
|
|
This API is private and not intended to be used outside of the integrated
|
|
system that uses libmutter. No compatibility between versions are
|
|
promised.
|
|
-->
|
|
<interface name="org.gnome.Mutter.ScreenCast">
|
|
|
|
<!--
|
|
CreateSession:
|
|
@properties: Properties
|
|
@session_path: Path to the new session object
|
|
|
|
* "remote-desktop-session-id" (s): The ID of a remote desktop session.
|
|
Remote desktop driven screen casts
|
|
are started and stopped by the remote
|
|
desktop session.
|
|
* "disable-animations" (b): Set to "true" if the screen cast application
|
|
would prefer animations to be globally
|
|
disabled, while the session is running.
|
|
Default is "false".
|
|
Available since version 3.
|
|
-->
|
|
<method name="CreateSession">
|
|
<arg name="properties" type="a{sv}" direction="in" />
|
|
<arg name="session_path" type="o" direction="out" />
|
|
</method>
|
|
|
|
<!--
|
|
Version:
|
|
@short_description: API version
|
|
-->
|
|
<property name="Version" type="i" access="read" />
|
|
|
|
</interface>
|
|
|
|
<!--
|
|
org.gnome.Mutter.ScreenCast.Session:
|
|
@short_description: Screen cast session
|
|
-->
|
|
<interface name="org.gnome.Mutter.ScreenCast.Session">
|
|
|
|
<!--
|
|
Start:
|
|
|
|
Start the screen cast session
|
|
-->
|
|
<method name="Start" />
|
|
|
|
<!--
|
|
Stop:
|
|
|
|
Stop the screen cast session
|
|
-->
|
|
<method name="Stop" />
|
|
|
|
<!--
|
|
Closed:
|
|
|
|
The session has closed.
|
|
-->
|
|
<signal name="Closed" />
|
|
|
|
<!--
|
|
RecordMonitor:
|
|
@connector: Connector of the monitor to record
|
|
@properties: Properties
|
|
@stream_path: Path to the new stream object
|
|
|
|
Record a single monitor.
|
|
|
|
Available @properties include:
|
|
|
|
* "cursor-mode" (u): Cursor mode. Default: 'hidden' (see below)
|
|
Available since API version 2.
|
|
* "is-recording" (b): Whether this is a screen recording. May be
|
|
be used for choosing appropriate visual feedback.
|
|
Default: false. Available since API version 4.
|
|
|
|
Available cursor mode values:
|
|
|
|
0: hidden - cursor is not included in the stream
|
|
1: embedded - cursor is included in the framebuffer
|
|
2: metadata - cursor is included as metadata in the PipeWire stream
|
|
-->
|
|
<method name="RecordMonitor">
|
|
<arg name="connector" type="s" direction="in" />
|
|
<arg name="properties" type="a{sv}" direction="in" />
|
|
<arg name="stream_path" type="o" direction="out" />
|
|
</method>
|
|
|
|
<!--
|
|
RecordWindow:
|
|
@properties: Properties used determining what window to select
|
|
@stream_path: Path to the new stream object
|
|
|
|
Supported since API version 2.
|
|
|
|
Record a single window. The cursor will not be included.
|
|
|
|
Available @properties include:
|
|
|
|
* "window-id" (t): Id of the window to record.
|
|
* "cursor-mode" (u): Cursor mode. Default: 'hidden' (see RecordMonitor).
|
|
* "is-recording" (b): Whether this is a screen recording. May be
|
|
be used for choosing panel icon.
|
|
Default: false. Available since API version 4.
|
|
|
|
-->
|
|
<method name="RecordWindow">
|
|
<arg name="properties" type="a{sv}" direction="in" />
|
|
<arg name="stream_path" type="o" direction="out" />
|
|
</method>
|
|
|
|
<!--
|
|
RecordArea:
|
|
@x: X position of the recorded area
|
|
@y: Y position of the recorded area
|
|
@width: width of the recorded area
|
|
@height: height of the recorded area
|
|
@properties: Properties
|
|
@stream_path: Path to the new stream object
|
|
|
|
Record an area of the stage. The coordinates are in stage coordinates.
|
|
The size of the stream does not necessarily match the size of the
|
|
recorded area, and will depend on DPI scale of the affected monitors.
|
|
|
|
Available @properties include:
|
|
|
|
* "cursor-mode" (u): Cursor mode. Default: 'hidden' (see below)
|
|
Available since API version 2.
|
|
* "is-recording" (b): Whether this is a screen recording. May be
|
|
be used for choosing panel icon.
|
|
Default: false. Available since API version 4.
|
|
|
|
Available cursor mode values:
|
|
|
|
0: hidden - cursor is not included in the stream
|
|
1: embedded - cursor is included in the framebuffer
|
|
2: metadata - cursor is included as metadata in the PipeWire stream
|
|
-->
|
|
<method name="RecordArea">
|
|
<arg name="x" type="i" direction="in" />
|
|
<arg name="y" type="i" direction="in" />
|
|
<arg name="width" type="i" direction="in" />
|
|
<arg name="height" type="i" direction="in" />
|
|
<arg name="properties" type="a{sv}" direction="in" />
|
|
<arg name="stream_path" type="o" direction="out" />
|
|
</method>
|
|
|
|
<!--
|
|
RecordVirtual:
|
|
@properties: Properties
|
|
@stream_path: Path to the new stream object
|
|
|
|
Record a virtual area that will be represented as a virtual monitor. The
|
|
width and height corresponds to the non-scaled intended stream size.
|
|
|
|
Available @properties include:
|
|
|
|
* "cursor-mode" (u): Cursor mode. Default: 'hidden' (see below)
|
|
Available since API version 2.
|
|
* "is-platform" (b): Whether this virtual output should be considered
|
|
part of the platform, meaning it will not be
|
|
interpreted as if the screen is shared, but more
|
|
transparently as if it was a real monitor.
|
|
Available since API version 3. Default: FALSE.
|
|
|
|
Available cursor mode values:
|
|
|
|
0: hidden - cursor is not included in the stream
|
|
1: embedded - cursor is included in the framebuffer
|
|
2: metadata - cursor is included as metadata in the PipeWire stream
|
|
-->
|
|
<method name="RecordVirtual">
|
|
<arg name="properties" type="a{sv}" direction="in" />
|
|
<arg name="stream_path" type="o" direction="out" />
|
|
</method>
|
|
</interface>
|
|
|
|
<!--
|
|
org.gnome.Mutter.ScreenCast.Stream:
|
|
@short_description: Screen cast stream
|
|
-->
|
|
<interface name="org.gnome.Mutter.ScreenCast.Stream">
|
|
|
|
<!--
|
|
Start:
|
|
@short_description: Start new stream
|
|
|
|
Start a stream of an already started session.
|
|
-->
|
|
<method name="Start"/>
|
|
|
|
<!--
|
|
Stop:
|
|
@short_description: Stop the stream
|
|
|
|
Stop the started stream.
|
|
-->
|
|
<method name="Stop"/>
|
|
|
|
<!--
|
|
PipeWireStreamAdded:
|
|
@short_description: Pipewire stream added
|
|
|
|
A signal emitted when PipeWire stream for the screen cast stream has
|
|
been created. The @node_id corresponds to the PipeWire stream node.
|
|
-->
|
|
<signal name="PipeWireStreamAdded">
|
|
<annotation name="org.gtk.GDBus.C.Name" value="pipewire-stream-added"/>
|
|
<arg name="node_id" type="u" direction="out" />
|
|
</signal>
|
|
|
|
<!--
|
|
Parameters:
|
|
@short_description: Optional stream parameters
|
|
|
|
Available parameters include:
|
|
|
|
* "position" (ii): Position of the source of the stream in the
|
|
compositor coordinate space.
|
|
* "size" (ii): Size of the source of the stream in the compositor
|
|
coordinate space.
|
|
* "output-name" s: Xrandr name of the output in case of X11 and
|
|
wl_output.name in case of Wayland. Available only
|
|
for monitor streams.
|
|
-->
|
|
<property name="Parameters" type="a{sv}" access="read" />
|
|
|
|
</interface>
|
|
|
|
</node>
|