~ubuntu-branches/ubuntu/wily/sflphone/wily

« back to all changes in this revision

Viewing changes to kde/src/lib/dbus/presencemanager-introspec.xml

  • Committer: Package Import Robot
  • Author(s): Mark Purcell
  • Date: 2014-01-28 18:23:36 UTC
  • mfrom: (1.1.11)
  • mto: This revision was merged to the branch mainline in revision 24.
  • Revision ID: package-import@ubuntu.com-20140128182336-3xenud1kbnwmf3mz
* New upstream release 
  - Fixes "New Upstream Release" (Closes: #735846)
  - Fixes "Ringtone does not stop" (Closes: #727164)
  - Fixes "[sflphone-kde] crash on startup" (Closes: #718178)
  - Fixes "sflphone GUI crashes when call is hung up" (Closes: #736583)
* Build-Depends: ensure GnuTLS 2.6
  - libucommon-dev (>= 6.0.7-1.1), libccrtp-dev (>= 2.0.6-3)
  - Fixes "FTBFS Build-Depends libgnutls{26,28}-dev" (Closes: #722040)
* Fix "boost 1.49 is going away" unversioned Build-Depends: (Closes: #736746)
* Add Build-Depends: libsndfile-dev, nepomuk-core-dev

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8" ?>
 
2
 
 
3
<node name="/presencemanager-introspec" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
 
4
    <interface name="org.sflphone.SFLphone.PresenceManager">
 
5
        <!-- METHODS !-->
 
6
        <method name="publish" tp:name-for-bindings="publish">
 
7
            <tp:added version="1.3.0"/>
 
8
            <arg type="s" name="accountID" direction="in">
 
9
                <tp:docstring>
 
10
                    The account from which the presence will be emitted
 
11
                </tp:docstring>
 
12
            </arg>
 
13
            <arg type="b" name="status" direction="in">
 
14
                <tp:docstring>
 
15
                    Is this account present or not
 
16
                </tp:docstring>
 
17
            </arg>
 
18
            <arg type="s" name="note" direction="in">
 
19
                <tp:docstring>
 
20
                    A message transmitted by the server to other users
 
21
                </tp:docstring>
 
22
            </arg>
 
23
        </method>
 
24
 
 
25
        <method name="answerServerRequest" tp:name-for-bindings="answerServerRequest">
 
26
            <tp:docstring>
 
27
                Answer a presence request from the server
 
28
            </tp:docstring>
 
29
            <tp:added version="1.3.0"/>
 
30
            <arg type="s" name="uri" direction="in">
 
31
                <tp:docstring>
 
32
                </tp:docstring>
 
33
            </arg>
 
34
            <arg type="b" name="flag" direction="in">
 
35
                <tp:docstring>
 
36
                    Is the request granted or denied
 
37
                </tp:docstring>
 
38
            </arg>
 
39
        </method>
 
40
 
 
41
        <method name="subscribeBuddy" tp:name-for-bindings="subscribeBuddy">
 
42
            <tp:docstring>
 
43
                Ask be be notified when 'uri' presence change
 
44
            </tp:docstring>
 
45
            <tp:added version="1.3.0"/>
 
46
            <arg type="s" name="accountID" direction="in">
 
47
                <tp:docstring>
 
48
                    An account from which get request presence informations
 
49
                </tp:docstring>
 
50
            </arg>
 
51
            <arg type="s" name="uri" direction="in">
 
52
                <tp:docstring>
 
53
                    A SIP uri to watch
 
54
                </tp:docstring>
 
55
            </arg>
 
56
            <arg type="b" name="flag" direction="in">
 
57
                <tp:docstring>
 
58
                </tp:docstring>
 
59
            </arg>
 
60
        </method>
 
61
 
 
62
        <method name="getSubscriptions" tp:name-for-bindings="getSubscriptions">
 
63
            <tp:added version="1.3.0"/>
 
64
            <tp:rationale>
 
65
                New clients connecting to existing daemon need to be aware of active
 
66
                subscriptions.
 
67
            </tp:rationale>
 
68
            <annotation name="com.trolltech.QtDBus.QtTypeName.In0" value="VectorMapStringString">
 
69
                While there is more status than "Online" or "Offline", only those
 
70
            </annotation>
 
71
            <arg type="s" name="accountID" direction="in">
 
72
            </arg>
 
73
            <annotation name="com.trolltech.QtDBus.QtTypeName.Out0" value="VectorMapStringString"/>
 
74
            <arg type="aa{ss}" name="credentialInformation" direction="out" tp:type="String_String_Map">
 
75
                <tp:docstring>
 
76
                   List of hashes map with the following key-value pairs:
 
77
                    * Status:     "Online" or "Offline"
 
78
                    * LineStatus: String
 
79
               </tp:docstring>
 
80
            </arg>
 
81
        </method>
 
82
 
 
83
        <method name="setSubscriptions" tp:name-for-bindings="setSubscriptions">
 
84
            <tp:added version="1.3.0"/>
 
85
            <tp:rationale>Calling "subscribeClient" in a loop is too slow</tp:rationale>
 
86
            <arg type="s" name="accountID" direction="in">
 
87
            </arg>
 
88
            <annotation name="com.trolltech.QtDBus.QtTypeName.In1" value="VectorString"/>
 
89
            <arg type="as" name="uriList" direction="in">
 
90
                <tp:docstring>
 
91
                   A list of SIP URIs
 
92
               </tp:docstring>
 
93
           </arg>
 
94
            <!--TODO<annotation name="com.trolltech.QtDBus.QtTypeName.Out0" value="VectorString"/>
 
95
            <arg type="as" name="invalidUris" direction="out">
 
96
                <tp:docstring>
 
97
                   List of invalid URIs. An URI must be a valid SIP URI. Clients should purge
 
98
                   the list from all invalid URIs
 
99
               </tp:docstring>
 
100
            </arg>-->
 
101
        </method>
 
102
 
 
103
        <!-- SIGNALS !-->
 
104
 
 
105
        <signal name="newBuddyNotification" tp:name-for-bindings="newBuddyNotification">
 
106
            <tp:added version="1.3.0"/>
 
107
            <tp:docstring>
 
108
                Notify when a registered presence uri presence informations changes
 
109
            </tp:docstring>
 
110
            <arg type="s" name="accountID">
 
111
                <tp:docstring>
 
112
                    The associated account
 
113
                </tp:docstring>
 
114
            </arg>
 
115
            <arg type="s" name="buddyUri">
 
116
                <tp:docstring>
 
117
                    The registered URI
 
118
                </tp:docstring>
 
119
            </arg>
 
120
            <arg type="b" name="status">
 
121
                <tp:docstring>
 
122
                    Is the URI present or not
 
123
                </tp:docstring>
 
124
            </arg>
 
125
            <arg type="s" name="lineStatus">
 
126
                <tp:docstring>
 
127
                    A string containing informations from the user (human readable)
 
128
                </tp:docstring>
 
129
            </arg>
 
130
        </signal>
 
131
 
 
132
        <signal name="subscriptionStateChanged" tp:name-for-bindings="subscriptionStateChanged">
 
133
            <tp:added version="1.3.0"/>
 
134
            <tp:docstring>
 
135
                Notify when a the server changes the state of a subscription.
 
136
            </tp:docstring>
 
137
            <arg type="s" name="accountID">
 
138
                <tp:docstring>
 
139
                    The associated account
 
140
                </tp:docstring>
 
141
            </arg>
 
142
            <arg type="s" name="buddyUri">
 
143
                <tp:docstring>
 
144
                    The registered URI
 
145
                </tp:docstring>
 
146
            </arg>
 
147
            <arg type="b" name="state">
 
148
                <tp:docstring>
 
149
                    True/ false when the subscription is active/termintated.
 
150
                </tp:docstring>
 
151
            </arg>
 
152
        </signal>
 
153
 
 
154
        <signal name="newServerSubscriptionRequest" tp:name-for-bindings="newServerSubscriptionRequest">
 
155
            <tp:added version="1.3.0"/>
 
156
            <arg type="s" name="buddyUri">
 
157
                <tp:docstring>
 
158
                    Notify when an other user (or the server) request your presence informations
 
159
                </tp:docstring>
 
160
            </arg>
 
161
        </signal>
 
162
 
 
163
      <signal name="serverError" tp:name-for-bindings="serverError">
 
164
            <tp:added version="1.3.0"/>
 
165
            <arg type="s" name="accountID">
 
166
                <tp:docstring>
 
167
                    Associated account
 
168
                </tp:docstring>
 
169
            </arg>
 
170
             <arg type="s" name="error">
 
171
                <tp:docstring>
 
172
                    Code returned by the server
 
173
                </tp:docstring>
 
174
            </arg>
 
175
            <arg type="s" name="msg">
 
176
                <tp:docstring>
 
177
                    Error explain
 
178
                </tp:docstring>
 
179
            </arg>
 
180
      </signal>
 
181
 
 
182
    </interface>
 
183
</node>