FM / interfaces

/usr/share/dbus-1/interfaces

Name	Size	Mode	Actions
org.freedesktop.Flatpak.Authenticator.xml	13027	0644	edit dl rm
org.freedesktop.Flatpak.xml	12812	0644	edit dl rm
org.freedesktop.fwupd.xml	6168	0644	edit dl rm
org.freedesktop.hostname1.xml	4845	0644	edit dl rm
org.freedesktop.impl.portal.Access.xml	3816	0644	edit dl rm
org.freedesktop.impl.portal.Account.xml	3425	0644	edit dl rm
org.freedesktop.impl.portal.AppChooser.xml	5203	0644	edit dl rm
org.freedesktop.impl.portal.Background.xml	4082	0644	edit dl rm
org.freedesktop.impl.portal.Email.xml	3546	0644	edit dl rm
org.freedesktop.impl.portal.FileChooser.xml	13768	0644	edit dl rm
org.freedesktop.impl.portal.Inhibit.xml	5443	0644	edit dl rm
org.freedesktop.impl.portal.Lockdown.xml	1739	0644	edit dl rm
org.freedesktop.impl.portal.Notification.xml	2884	0644	edit dl rm
org.freedesktop.impl.portal.PermissionStore.xml	7079	0644	edit dl rm
org.freedesktop.impl.portal.Print.xml	6106	0644	edit dl rm
org.freedesktop.impl.portal.RemoteDesktop.xml	13848	0644	edit dl rm
org.freedesktop.impl.portal.Request.xml	1713	0644	edit dl rm
org.freedesktop.impl.portal.ScreenCast.xml	12507	0644	edit dl rm
org.freedesktop.impl.portal.Screenshot.xml	4347	0644	edit dl rm
org.freedesktop.impl.portal.Secret.xml	2626	0644	edit dl rm
org.freedesktop.impl.portal.Session.xml	1732	0644	edit dl rm
org.freedesktop.impl.portal.Settings.xml	3439	0644	edit dl rm
org.freedesktop.impl.portal.Wallpaper.xml	2281	0644	edit dl rm
org.freedesktop.locale1.xml	2566	0644	edit dl rm
org.freedesktop.LogControl1.xml	1973	0644	edit dl rm
org.freedesktop.login1.Manager.xml	16996	0644	edit dl rm
org.freedesktop.login1.Seat.xml	2478	0644	edit dl rm
org.freedesktop.login1.Session.xml	6383	0644	edit dl rm
org.freedesktop.login1.User.xml	3442	0644	edit dl rm
org.freedesktop.portal.Account.xml	3539	0644	edit dl rm
org.freedesktop.portal.Background.xml	4034	0644	edit dl rm
org.freedesktop.portal.Camera.xml	3127	0644	edit dl rm
org.freedesktop.portal.Device.xml	2631	0644	edit dl rm
org.freedesktop.portal.Documents.xml	11423	0644	edit dl rm
org.freedesktop.portal.Email.xml	4894	0644	edit dl rm
org.freedesktop.portal.FileChooser.xml	15156	0644	edit dl rm
org.freedesktop.portal.FileTransfer.xml	5658	0644	edit dl rm
org.freedesktop.portal.Flatpak.xml	22707	0644	edit dl rm
org.freedesktop.portal.GameMode.xml	9089	0644	edit dl rm
org.freedesktop.portal.Inhibit.xml	7285	0644	edit dl rm
org.freedesktop.portal.Location.xml	6387	0644	edit dl rm
org.freedesktop.portal.MemoryMonitor.xml	2069	0644	edit dl rm
org.freedesktop.portal.NetworkMonitor.xml	4896	0644	edit dl rm
org.freedesktop.portal.Notification.xml	6685	0644	edit dl rm
org.freedesktop.portal.OpenURI.xml	7932	0644	edit dl rm
org.freedesktop.portal.PowerProfileMonitor.xml	1709	0644	edit dl rm
org.freedesktop.portal.Print.xml	14446	0644	edit dl rm
org.freedesktop.portal.ProxyResolver.xml	1975	0644	edit dl rm
org.freedesktop.portal.Realtime.xml	2532	0644	edit dl rm
org.freedesktop.portal.RemoteDesktop.xml	16139	0644	edit dl rm
org.freedesktop.portal.Request.xml	3538	0644	edit dl rm
org.freedesktop.portal.ScreenCast.xml	13695	0644	edit dl rm
org.freedesktop.portal.Screenshot.xml	4730	0644	edit dl rm
org.freedesktop.portal.Secret.xml	3285	0644	edit dl rm
org.freedesktop.portal.Session.xml	2950	0644	edit dl rm
org.freedesktop.portal.Settings.xml	3375	0644	edit dl rm
org.freedesktop.portal.Trash.xml	1746	0644	edit dl rm
org.freedesktop.portal.Wallpaper.xml	3538	0644	edit dl rm
org.freedesktop.RealtimeKit1.xml	2181	0644	edit dl rm
org.freedesktop.systemd1.Automount.xml	17730	0644	edit dl rm
org.freedesktop.systemd1.Device.xml	17105	0644	edit dl rm
org.freedesktop.systemd1.Job.xml	2256	0644	edit dl rm
org.freedesktop.systemd1.Manager.xml	36177	0644	edit dl rm
org.freedesktop.systemd1.Mount.xml	58653	0644	edit dl rm
org.freedesktop.systemd1.Path.xml	18050	0644	edit dl rm
org.freedesktop.systemd1.Scope.xml	30990	0644	edit dl rm
org.freedesktop.systemd1.Service.xml	65486	0644	edit dl rm
org.freedesktop.systemd1.Slice.xml	29034	0644	edit dl rm
org.freedesktop.systemd1.Socket.xml	65410	0644	edit dl rm
org.freedesktop.systemd1.Swap.xml	57550	0644	edit dl rm
org.freedesktop.systemd1.Target.xml	17038	0644	edit dl rm
org.freedesktop.systemd1.Timer.xml	19180	0644	edit dl rm
org.freedesktop.systemd1.Unit.xml	16972	0644	edit dl rm
org.freedesktop.timedate1.xml	2930	0644	edit dl rm
org.freedesktop.Tracker3.Miner.Files.Index.xml	416	0644	edit dl rm
org.freedesktop.Tracker3.Miner.xml	2190	0644	edit dl rm

Edit: /usr/share/dbus-1/interfaces/org.freedesktop.portal.ScreenCast.xml (13695B)

<?xml version="1.0"?>
<!--
 Copyright (C) 2017-2018 Red Hat, Inc.

This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
 License as published by the Free Software Foundation; either
 version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
 License along with this library. If not, see <http://www.gnu.org/licenses/>.
-->

<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
  <!--
      org.freedesktop.portal.ScreenCast:
      @short_description: Screen cast portal

The Screen cast portal allows to create screen cast sessions.

This documentation describes version 4 of this interface.
  -->
  <interface name="org.freedesktop.portal.ScreenCast">
    <!--
        CreateSession:
        @options: Vardict with optional further information
        @handle: Object path for the #org.freedesktop.portal.Request object representing this call

Create a screen cast session. A successfully created session can at
        any time be closed using org.freedesktop.portal.Session::Close, or may
        at any time be closed by the portal implementation, which will be
        signalled via org.freedesktop.portal.Session::Closed.

The following results get returned via the #org.freedesktop.portal.Request::Response signal:
        <variablelist>
          <varlistentry>
            <term>session_handle o</term>
            <listitem><para>
              The session handle. An object path for the
              #org.freedesktop.portal.Session object representing the created
              session.
            </para></listitem>
          </varlistentry>
        </variablelist>
    -->
    <method name="CreateSession">
      <arg type="a{sv}" name="options" direction="in"/>
      <arg type="o" name="handle" direction="out"/>
    </method>
    <!--
        SelectSources:
        @session_handle: Object path for the #org.freedesktop.portal.Session object
        @options: Vardict with optional further information
        @handle: Object path for the #org.freedesktop.portal.Request object representing this call

Configure what the screen cast session should record. This method must
        be called before starting the session.

Passing invalid input to this method will cause the session to be
        closed. An application may only attempt to select sources once per
        session.

Supported keys in the @options vardict include:
        <variablelist>
          <varlistentry>
            <term>handle_token s</term>
            <listitem><para>
              A string that will be used as the last element of the @handle. Must be a valid
              object path element. See the #org.freedesktop.portal.Request documentation for
              more information about the @handle.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>types u</term>
            <listitem><para>
              Bitmask of what types of content to record. Default is MONITOR.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>multiple b</term>
            <listitem><para>
              Whether to allow selecting multiple sources. Default is no.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>cursor_mode u</term>
            <listitem><para>
              Determines how the cursor will be drawn in the screen cast stream. It must be
              one of the curosr modes advertised in
              #org.freedesktop.portal.ScreenCast.AvailableCursorModes. Setting a cursor mode
              not advertised will cause the screen cast session to be closed. The default
              cursor mode is 'Hidden'.

This option was added in version 2 of this interface.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>restore_token s</term>
            <listitem><para>
              The token to restore a previous session.

If the stored session cannot be restored, this value is ignored
              and the user will be prompted normally. This may happen when, for
              example, the session contains a monitor or a window that is not
              available anymore, or when the stored permissions are withdrawn.

The restore token is invalidated after using it once. To restore
              the same session again, use the new restore token sent in response
              to starting this session.

This option was added in version 4 of this interface.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>persist_mode u</term>
            <listitem><para>
              How this session should persist. Default is 0. Accepted values are:

<simplelist>
                <member>0: Do not persist (default)</member>
                <member>1: Permissions persist as long as the application is running</member>
                <member>2: Permissions persist until explicitly revoked</member>
              </simplelist>

Remote desktop screen cast sessions cannot persist. The only allowed
              persist_mode for remote desktop sessions is 0.

If the permission for the session to persist is granted, a restore token will
              be returned via the #org.freedesktop.portal.Request::Response signal of the
              #org.freedesktop.portal.ScreenCast.Start method.

This option was added in version 4 of this interface.
            </para></listitem>
          </varlistentry>
        </variablelist>

For available source types, see the AvailableSourceTypes property.
    -->
    <method name="SelectSources">
      <arg type="o" name="session_handle" direction="in"/>
      <arg type="a{sv}" name="options" direction="in"/>
      <arg type="o" name="handle" direction="out"/>
    </method>
    <!--
        Start:
        @session_handle: Object path for the #org.freedesktop.portal.Session object
        @parent_window: Identifier for the application window, see <link linkend="parent_window">Common Conventions</link>
        @options: Vardict with optional further information
        @handle: Object path for the #org.freedesktop.portal.Request object representing this call

Start the screen cast session. This will typically result the portal
        presenting a dialog letting the user do the selection set up by
        SelectSources. An application can only attempt start a session once.

A screen cast session may only be started after having selected sources
        using org.freedesktop.portal.ScreenCast::SelectSources.

The following results get returned via the
        #org.freedesktop.portal.Request::Response signal:
        <variablelist>
          <varlistentry>
            <term>streams a(ua{sv})</term>
            <listitem><para>
              An array of PipeWire streams. Each stream consists of a PipeWire
              node ID (the first element in the tuple, and a Vardict of
              properties.

The array will contain a single stream if 'multiple' (see
              SelectSources) was set to 'false', or at least one stream if
              'multiple' was set to 'true' as part of the SelectSources method.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>restore_token s</term>
            <listitem><para>
              The restore token. This token is a single use token that can later
              be used to restore a session. See
              #org.freedesktop.portal.ScreenCast.SelectSources for details.

This response option was added in version 4 of this interface.
            </para></listitem>
          </varlistentry>
        </variablelist>

Stream properties include:
        <variablelist>
          <varlistentry>
            <term>id s</term>
            <listitem><para>
              Opaque identifier. Will be unique for this stream and local to this
              session. Will persist with future sessions, if they are restored
              using a restore token. This property was added in version 4 of this
              interface. Optional.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>position (ii)</term>
            <listitem><para>
              A tuple consisting of the position (x, y) in the compositor
              coordinate space. Note that the position may not be equivalent to a
              position in a pixel coordinate space. Only available for monitor
              streams. Optional.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>size (ii)</term>
            <listitem><para>
              A tuple consisting of (width, height). The size represents the size
              of the stream as it is displayed in the compositor coordinate
              space. Note that this size may not be equivalent to a size in a
              pixel coordinate space. The size may differ from the size of the
              stream. Optional.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>source_type u</term>
            <listitem><para>
              The type of the content which is being screen casted.
              For available source types, see the AvailableSourceTypes property.
              This property was added in version 3 of this interface.
            </para></listitem>
          </varlistentry>
        </variablelist>
    -->
    <method name="Start">
      <arg type="o" name="session_handle" direction="in"/>
      <arg type="s" name="parent_window" direction="in"/>
      <arg type="a{sv}" name="options" direction="in"/>
      <arg type="o" name="handle" direction="out"/>
    </method>
    <!--
        OpenPipeWireRemote:
        @session_handle: Object path for the #org.freedesktop.portal.Session object
        @options: Vardict with optional further information
        @fd: File descriptor of an open PipeWire remote.

Open a file descriptor to the PipeWire remote where the screen cast
        streams are available. The file descriptor should be used to create a
        <classname>pw_core</classname> object, by using
        <function>pw_context_connect_fd</function>. Only the screen cast stream
        nodes will be available from this PipeWire node.
    -->
    <method name="OpenPipeWireRemote">
      <annotation name="org.gtk.GDBus.C.Name" value="open_pipewire_remote"/>
      <annotation name="org.gtk.GDBus.C.UnixFD" value="true"/>
      <arg type="o" name="session_handle" direction="in"/>
      <arg type="a{sv}" name="options" direction="in"/>
      <arg type="h" name="fd" direction="out"/>
    </method>
    <!--
        AvailableSourceTypes:

A bitmask of available source types. Currently defined types are:

<simplelist>
          <member>1: MONITOR</member>
          <member>2: WINDOW</member>
          <member>4: VIRTUAL</member>
        </simplelist>
    -->
    <property name="AvailableSourceTypes" type="u" access="read"/>
    <!--
        AvailableCursorModes:

A bitmask of available cursor modes.

Available cursor mode values:
        <simplelist>
          <member>1: Hidden. The cursor is not part of the screen cast stream.</member>
          <member>2: Embedded: The cursor is embedded as part of the stream buffers.</member>
          <member>4: Metadata: The cursor is not part of the screen cast stream, but sent as PipeWire stream metadata.</member>
        </simplelist>

This property was added in version 2 of this interface.
    -->
    <property name="AvailableCursorModes" type="u" access="read"/>
    <property name="version" type="u" access="read"/>
  </interface>
</node>