From 46bdd911fafe82a0c5da418da318707ef8cae9f6 Mon Sep 17 00:00:00 2001 From: Jonny Lamb Date: Thu, 28 Oct 2010 17:59:26 +0100 Subject: add Mute Content interface spec Signed-off-by: Jonny Lamb --- telepathy-yell/Call_Content_Interface_Mute.xml | 85 ++++++++++++++++++++++++++ telepathy-yell/Makefile.am | 1 + telepathy-yell/call.xml | 1 + 3 files changed, 87 insertions(+) create mode 100644 telepathy-yell/Call_Content_Interface_Mute.xml diff --git a/telepathy-yell/Call_Content_Interface_Mute.xml b/telepathy-yell/Call_Content_Interface_Mute.xml new file mode 100644 index 0000000..f926e03 --- /dev/null +++ b/telepathy-yell/Call_Content_Interface_Mute.xml @@ -0,0 +1,85 @@ + + + Copyright © 2005-2010 Nokia Corporation + Copyright © 2005-2010 Collabora Ltd + +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. + +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, write to the Free Software +Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + + + + (draft version, not API-stable) + + + +

Interface for calls which may be muted. This only makes sense + for channels where audio or video is streaming between members.

+ +

Muting a call content indicates that the user does not wish to send + outgoing audio or video.

+ +

Although it's client's responsibility to actually mute the microphone + or turn off the camera, using this interface the client can also + inform the CM and other clients of that fact.

+ + + For some protocols, the fact that the content is muted needs + to be transmitted to the peer; for others, the notification + to the peer is only informational (eg. XMPP), and some + protocols may have no notion of muting at all. + + + + + + Emitted to indicate that the mute state has changed for this call content. + This may occur as a consequence of the client calling + SetMuted, or as an indication that another + client has (un)muted the content. + + + + True if the content is now muted. + + + + + + + True if the content is muted. + + + + + renamed from SetMuted to Mute + renamed back from Mute to SetMuted + + + True if the client has muted the content. + + + +

Inform the CM that the call content has been muted or unmuted by + the client.

+ +

It is the client's responsibility to actually mute or unmute the + microphone or camera used for the content. However, the client + MUST call this whenever it mutes or unmutes the content.

+ + + + + + diff --git a/telepathy-yell/Makefile.am b/telepathy-yell/Makefile.am index 7b3a15f..53c1c3f 100644 --- a/telepathy-yell/Makefile.am +++ b/telepathy-yell/Makefile.am @@ -1,6 +1,7 @@ EXTRA_DIST = \ Call_Content_Codec_Offer.xml \ Call_Content_Interface_Media.xml \ + Call_Content_Interface_Mute.xml \ Call_Content.xml \ Call_Stream_Endpoint.xml \ Call_Stream_Interface_Media.xml \ diff --git a/telepathy-yell/call.xml b/telepathy-yell/call.xml index ee04dbd..7e016b5 100644 --- a/telepathy-yell/call.xml +++ b/telepathy-yell/call.xml @@ -7,6 +7,7 @@ + -- cgit v1.2.3