~ubuntu-branches/ubuntu/wily/telepathy-glib/wily

« back to all changes in this revision

Viewing changes to spec/Channel_Interface_Call_State.xml

  • Committer: Bazaar Package Importer
  • Author(s): Simon McVittie
  • Date: 2009-03-24 22:06:52 UTC
  • mfrom: (1.3.1 upstream) (17.1.10 sid)
  • Revision ID: james.westby@ubuntu.com-20090324220652-c8dvom0nsqomp23d
Tags: 0.7.28-1
* New upstream version (ABI, API added)
* Put the -dbg package in section debug, as per recent archive changes
* Remove obsolete Conflicts/Replaces with libtelepathy-glib-static-dev, which
  was never in a stable release (and probably never in Debian at all)

Show diffs side-by-side

added added

removed removed

Lines of Context:
20
20
  <interface name="org.freedesktop.Telepathy.Channel.Interface.CallState">
21
21
    <tp:requires interface="org.freedesktop.Telepathy.Channel.Type.StreamedMedia"/>
22
22
 
23
 
    <tp:docstring>
24
 
      An interface for streamed media channels that can indicate call
25
 
      progress or call states. The presence of this interface is no guarantee
26
 
      that call states will actually be signalled (for instance, SIP
27
 
      implementations are not guaranteed to generate status 180 Ringing,
28
 
      so a call can be accepted without the Ringing flag ever having been set).
 
23
    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
 
24
      <p>An interface for streamed media channels that can indicate call
 
25
        progress or call states. The presence of this interface is no guarantee
 
26
        that call states will actually be signalled (for instance, SIP
 
27
        implementations are not guaranteed to generate status 180 Ringing, so a
 
28
        call can be accepted without the Ringing flag ever having been set).</p>
 
29
 
 
30
      <p>To notify the other participant in the call that they are on hold,
 
31
        see <tp:dbus-ref
 
32
          namespace="org.freedesktop.Telepathy.Channel.Interface"
 
33
          >Hold</tp:dbus-ref>.</p>
29
34
    </tp:docstring>
30
35
    <tp:added version="0.17.2"/>
31
36
 
32
 
    <method name="GetCallStates">
 
37
    <method name="GetCallStates" tp:name-for-bindings="Get_Call_States">
33
38
      <tp:docstring>
34
39
        Get the current call states for all contacts involved in this call.
35
40
      </tp:docstring>
43
48
      </arg>
44
49
    </method>
45
50
 
46
 
    <signal name="CallStateChanged">
 
51
    <signal name="CallStateChanged" tp:name-for-bindings="Call_State_Changed">
47
52
      <tp:docstring>
48
53
        Emitted when the state of a member of the channel has changed.
49
54
      </tp:docstring>
50
55
 
51
 
      <arg name="contact" type="u" tp:type="Contact_Handle">
 
56
      <arg name="Contact" type="u" tp:type="Contact_Handle">
52
57
        <tp:docstring>
53
58
          An integer handle for the contact.
54
59
        </tp:docstring>
55
60
      </arg>
56
61
 
57
 
      <arg name="state" type="u" tp:type="Channel_Call_State_Flags">
 
62
      <arg name="State" type="u" tp:type="Channel_Call_State_Flags">
58
63
        <tp:docstring>
59
64
          The new state for this contact.
60
65
        </tp:docstring>
101
106
          unhold the call again.
102
107
        </tp:docstring>
103
108
      </tp:flag>
 
109
 
 
110
      <tp:flag suffix="Forwarded" value="8">
 
111
        <tp:docstring>
 
112
          The initiator of the call originally called a contact other than the
 
113
          current recipient of the call, but the call was then forwarded or
 
114
          diverted.
 
115
        </tp:docstring>
 
116
      </tp:flag>
104
117
    </tp:flags>
105
118
 
106
119
  </interface>