~ubuntu-branches/ubuntu/precise/telepathy-glib/precise-201111172307

« back to all changes in this revision

Viewing changes to spec/Call_Content.xml

  • Committer: Ken VanDine
  • Date: 2011-11-17 20:53:21 UTC
  • mfrom: (1.6.34 upstream)
  • Revision ID: ken.vandine@canonical.com-20111117205321-l704j7kr1zgw5v9h
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
23
23
  <interface name="org.freedesktop.Telepathy.Call1.Content"
24
24
      tp:causes-havoc="experimental">
25
25
    <tp:added version="0.19.0">(draft 1)</tp:added>
26
 
    <tp:requires
27
 
      interface="org.freedesktop.Telepathy.Call1.Interface.Mute"/>
28
26
 
29
27
    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
30
 
      This object represents one Content inside a <tp:dbus-ref
 
28
      <p>This object represents one Content inside a <tp:dbus-ref
31
29
      namespace="ofdT.Channel.Type">Call1</tp:dbus-ref>. For
32
30
      example, in an audio/video call there would be one audio content
33
31
      and one video content. Each content has one or more <tp:dbus-ref
34
32
      namespace="ofdT.Call1">Stream</tp:dbus-ref> objects which
35
 
      represent the actual transport to one or more remote contacts.
 
33
      represent the actual transport to one or more remote contacts.</p>
 
34
      <tp:rationale>
 
35
        There are two cases where multiple streams may happen:
 
36
        <ul>
 
37
          <li>Calls with more than two participants, if the protocol does not
 
38
          support multicast, and does not have mixer proxy.</li>
 
39
          <li>With jingle, when calling a contact connected from multiple
 
40
          resources, a stream is created for each resource. Once the remote
 
41
          contact answered from one of its resources, all other streams get
 
42
          removed.</li>
 
43
        </ul>
 
44
      </tp:rationale>
 
45
      <p>For protocols that support muting all streams of a given content
 
46
      separately, this object MAY also implement the <tp:dbus-ref
 
47
      namespace="ofdT.Call1.Interface">Mute</tp:dbus-ref> interface</p>
36
48
    </tp:docstring>
37
49
 
38
50
    <method name="Remove" tp:name-for-bindings="Remove">