Implement v2 notification spec

.github/workflows/Containerfile

@@ -24,6 +24,9 @@ RUN apt install -y --no-install-recommends \
     libgdk-pixbuf-2.0-dev \
     librsvg2-2 \
     librsvg2-common \
+    libgstreamer-plugins-base1.0-dev \
+    gstreamer1.0-plugins-good \
+    libgstreamer-plugins-good1.0-dev \
     libgeoclue-2-dev \
     libglib2.0-dev \
     libjson-glib-dev \
@@ -50,4 +53,4 @@ RUN apt install -y --no-install-recommends \
     python3-sphinx-copybutton \
     python3-sphinxext-opengraph \
     furo \
-    python3-sphinx
+    python3-sphinx

.github/workflows/container.yml

@@ -1,5 +1,5 @@
 env:
-  IMAGE_TAG: 20241015-2
+  IMAGE_TAG: 20241016-2
 
 on:
   workflow_call:

data/org.freedesktop.impl.portal.Notification.xml

@@ -27,6 +27,8 @@
 
       This notification interface lets sandboxed applications
       send and withdraw notifications.
+
+      This documentation describes version 2 of this interface.
   -->
   <interface name="org.freedesktop.impl.portal.Notification">
     <!--
@@ -39,12 +41,17 @@
 
         The ID can be used to later withdraw the notification.
         If the application reuses the same ID without withdrawing,
-        the notification is replaced by the new one.
+        the notification is updated with the new one. It's possible
+        to set ``show-as-new`` hint in the ``display-hint`` property
+        to animate replacing the notification instead of updating it.
 
         The format of the @notification is the same as for
         :ref:`org.freedesktop.portal.Notification.AddNotification`.
+
+        Since version 2, the icon property never uses the ``bytes`` option.
     -->
     <method name="AddNotification">
+      <annotation name="org.gtk.GDBus.C.UnixFD" value="true"/>
       <arg type="s" name="app_id" direction="in"/>
       <arg type="s" name="id" direction="in"/>
       <annotation name="org.qtproject.QtDBus.QtTypeName.In2" value="QVariantMap"/>
@@ -62,21 +69,42 @@
       <arg type="s" name="id" direction="in"/>
     </method>
 
+    <!--
+        SupportedOptions:
+
+        Some properties in :ref:`org.freedesktop.impl.portal.Notification.AddNotification`
+        may have options advertised by the notification server.
+
+        The format is the same as for ``SupportedOptions`` property of
+        :ref:`org.freedesktop.portal.Notification`.
+    -->
+    <property name="SupportedOptions" type="a{sv}" access="read"/>
+
     <!--
         ActionInvoked:
         @app_id: App id of the application
         @id: the application-provided ID for the notification
         @action: the name of the action
-        @parameter: array which will contain the target parameter for the action, if one was specified
+        @parameter: an array containing additional information
 
         Send to the application when a non-exported action is
         activated.
+
+        The @parameter contains the following values in order:
+
+        #. The `target` for the action, if one was specified.
+
+        #. The `platform-data` as vardict containing an ``activation-token`` (``s``) for
+           `XDG Activation
+           <https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/staging/xdg-activation/xdg-activation-v1.xml>`_
     -->
     <signal name="ActionInvoked">
       <arg type="s" name="app_id"/>
       <arg type="s" name="id"/>
       <arg type="s" name="action"/>
       <arg type="av" name="parameter"/>
     </signal>
+
+    <property name="version" type="u" access="read"/>
   </interface>
 </node>