Add Call_Content_Interface_Audio_Control extension

3 files changed, 115 insertions, 0 deletions

diff --git a/extensions/Call_Content_Interface_Audio_Control.xml b/extensions/Call_Content_Interface_Audio_Control.xml
new file mode 100644
index 0000000..9f588a8
--- /dev/null
+++ b/extensions/Call_Content_Interface_Audio_Control.xml
@@ -0,0 +1,113 @@
+<!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
+<node name="/Call_Content_Interface_Audio_Control"
+  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
+  <tp:copyright>Copyright © 2009-2010 Collabora Ltd.</tp:copyright>
+  <tp:copyright>Copyright © 2009-2010 Nokia Corporation</tp:copyright>
+  <tp:license xmlns="http://www.w3.org/1999/xhtml">
+    <p>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.1 of the License, or (at your option) any later version.</p>
+
+    <p>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.</p>
+
+    <p>You should have received a copy of the GNU Lesser General Public
+      License along with this library; if not, write to the Free Software
+      Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+      02110-1301, USA.</p>
+  </tp:license>
+
+  <interface name="org.freedesktop.Telepathy.Call.Content.Interface.AudioControl.DRAFT"
+    tp:causes-havoc="experimental">
+    <tp:added version="0.24.UNRELEASED">(draft 1)</tp:added>
+    <tp:requires interface="org.freedesktop.Telepathy.Call.Content.Interface.Media.DRAFT"/>
+
+    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+      <p>An interface that allows the connection manager to control the audio
+          stream.</p>
+      <p>This interface is generally not needed. In cases where the connection
+          manager handles the network communication and the media is transferred
+          from the client to the connection manager via shared memory, it can
+          sometimes be beneficial for the connection manager to be able to
+          control certain aspects of the audio stream.</p>
+    </tp:docstring>
+
+    <property name="InputVolume" type="u" access="read"
+      tp:name-for-bindings="Input_Volume">
+      <tp:docstring>
+        The volume the streaming engine should be sending at.
+
+        <p>Change notification is via the
+          <tp:member-ref>InputVolumeChanged</tp:member-ref> signal.</p>
+      </tp:docstring>
+    </property>
+
+    <signal name="InputVolumeChanged"
+      tp:name-for-bindings="Input_Volume_Changed">
+      <tp:docstring>
+        Emitted to indicate that the input volume has changed for this
+        call content.
+
+        This may occur as a consequence of the client calling
+        <tp:member-ref>SetInputVolume</tp:member-ref>, or as an indication
+        that another client has (un)muted the content.
+      </tp:docstring>
+      <arg type="u" name="NewVolume" />
+    </signal>
+
+    <method name="SetInputVolume" tp:name-for-bindings="Set_Input_Volume">
+      <arg direction="in" name="NewVolume" type="u">
+        <tp:docstring>
+          The new input volume level to use.
+        </tp:docstring>
+      </arg>
+      <tp:docstring>
+        <p>Inform the CM that the call content's input volume has been
+          changed by the client.</p>
+
+        <p>It is the client's responsibility to actually change the
+          input volume used for the content. However, the client
+          MUST call this whenever it changes input volume for the
+          content.</p>
+      </tp:docstring>
+    </method>
+
+    <property name="OutputVolume" type="u" access="read"
+      tp:name-for-bindings="Output_Volume">
+      <tp:docstring>
+        The volume the streaming engine should be outputting at.
+
+        <p>Change notification is via the
+          <tp:member-ref>OutputVolumeChanged</tp:member-ref> signal.</p>
+      </tp:docstring>
+    </property>
+
+    <signal name="OutputVolumeChanged"
+      tp:name-for-bindings="Output_Volume_Changed">
+      <tp:docstring>
+        The desired output volume has changed
+      </tp:docstring>
+      <arg type="u" name="NewVolume" />
+    </signal>
+
+    <method name="SetOutputVolume" tp:name-for-bindings="Set_Output_Volume">
+      <arg direction="in" name="NewVolume" type="u">
+        <tp:docstring>
+          The new output volume level to use.
+        </tp:docstring>
+      </arg>
+      <tp:docstring>
+        <p>Inform the CM that the call content's output volume has been
+          changed by the client.</p>
+
+        <p>It is the client's responsibility to actually change the
+          output volume used for the content. However, the client
+          MUST call this whenever it changes output volume for the
+          content.</p>
+      </tp:docstring>
+    </method>
+  </interface>
+</node>
diff --git a/extensions/Makefile.am b/extensions/Makefile.am
index 24f71c8..6fdc6b6 100644
--- a/extensions/Makefile.am
+++ b/extensions/Makefile.am
@@ -14,6 +14,7 @@ AM_CFLAGS = \
 EXTRA_DIST = \
     all.xml \
     Call_Content_Codec_Offer.xml \
+    Call_Content_Interface_Audio_Control.xml \
     Call_Content_Interface_Media.xml \
     Call_Content_Interface_Mute.xml \
     Call_Content_Interface_Video_Control.xml \
diff --git a/extensions/call-content.xml b/extensions/call-content.xml
index a543bec..ead2fe5 100644
--- a/extensions/call-content.xml
+++ b/extensions/call-content.xml
@@ -5,6 +5,7 @@
 <tp:title>Call Content</tp:title>
 
 <xi:include href="Call_Content.xml"/>
+<xi:include href="Call_Content_Interface_Audio_Control.xml"/>
 <xi:include href="Call_Content_Interface_Media.xml"/>
 <xi:include href="Call_Content_Interface_Video_Control.xml"/>