2
<node name="/Connection_Interface_Service_Point" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
3
<tp:copyright> Copyright © 2005-2010 Nokia Corporation </tp:copyright>
4
<tp:copyright> Copyright © 2005-2010 Collabora Ltd </tp:copyright>
5
<tp:license xmlns="http://www.w3.org/1999/xhtml">
6
<p>This library is free software; you can redistribute it and/or
7
modify it under the terms of the GNU Lesser General Public
8
License as published by the Free Software Foundation; either
9
version 2.1 of the License, or (at your option) any later version.</p>
11
<p>This library is distributed in the hope that it will be useful,
12
but WITHOUT ANY WARRANTY; without even the implied warranty of
13
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14
Lesser General Public License for more details.</p>
16
<p>You should have received a copy of the GNU Lesser General Public
17
License along with this library; if not, write to the Free Software
18
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
20
<interface name="org.freedesktop.Telepathy.Connection.Interface.ServicePoint.DRAFT" tp:causes-havoc="experimental">
21
<tp:added version="0.19.6">(draft version, not API-stable)</tp:added>
23
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
24
<p>An interface for connections whose channels may be able to indicate
25
specific they are connected to some form
26
of service station. For example, when
27
dialing 9-1-1 in the US, a GSM modem/network will recognize that as
28
an emergency call, and inform higher levels of the stack that the
29
call is being handled by an emergency service. In this example,
30
the call is handled by a Public Safety Answering Point (PSAP) which is labeled
31
as "urn:service:sos". Other networks and protocols may handle this
32
differently while still using this interface.</p>
35
<tp:struct name="Service_Point_Info" array-name="Service_Point_Info_List">
36
<tp:member type="(us)" tp:type="Service_Point" name="ServicePoint">
41
<tp:member type="as" name="ServiceIDs">
43
A list of IDs that are mapped to this service. This is provided as
44
a convenience for the UIs, but the preferred method for
45
requesting channel to a service is by setting <tp:dbus-ref
46
namespace="org.freedesktop.Telepathy.Channel.Interface.ServicePoint.DRAFT">InitialServicePoint</tp:dbus-ref>
47
property in channel request.
51
<p>Description of a service point and IDs which are mapped to id.</p>
53
<p>An example Service Point info for GSM emergency calls (callable through
54
"911" and "112") could look like:</p>
59
ServicePointType: 1 (Emergency),
60
ServicePoint: "urn:service:sos"
62
ServiceIDs: [ "911", "112" ]
68
<property name="KnownServicePoints" tp:name-for-bindings="Known_Service_Points"
69
type="a((us)as)" tp:type="Service_Point_Info[]" access="read">
70
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
71
The list of all (known) service points.
75
<signal name="ServicePointsChanged" tp:name-for-bindings="Service_Points_Changed">
76
<arg name="ServicePoints" type="a((us)as)" tp:type="Service_Point_Info[]">
77
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
78
<p>The new list of service points.</p>
82
Indicate that the list of known service points (or their IDs) have
83
changed, presenting the new list.
87
<tp:struct name="Service_Point">
88
<tp:docstring>A service point.</tp:docstring>
89
<tp:member type="u" name="ServicePointType" tp:type="Service_Point_Type">
94
<tp:member type="s" name="Service">
96
String representation of the service point. The representation is
97
service specific; it may be <tp:type>Uniform_Resource_Name</tp:type>
98
or may be in some other form. Empty, unused or unknown value is
104
<tp:enum name="Service_Point_Type" type="u">
106
The various types of service points the channel might connect to.
109
<tp:enumvalue value="0" suffix="None">
111
The service point is not used/available.
115
<tp:enumvalue value="1" suffix="Emergency">
117
The service point is a generic emergency point.
121
<tp:enumvalue value="2" suffix="Counseling">
123
The service point is some kind of counseling service (ie, mental health
124
or child-services counseling).
129
<tp:simple-type name="Uniform_Resource_Name" type="s">
130
<tp:docstring>Uniform Resource Name as specified by
131
<a href="http://www.rfc-editor.org/rfc/rfc5031.txt">RFC 5031</a>.</tp:docstring>
135
<!-- vim:set sw=2 sts=2 et ft=xml: -->