2
<node name="/Channel_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.Channel.Interface.ServicePoint">
21
<tp:added version="0.19.7">(as stable API)</tp:added>
23
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
24
<p>An interface for channels
25
that can indicate when/if they are connected to some form
26
of service point. 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>
34
<p>Note that while the majority of examples given in this
35
documentation are for GSM calls, they could just as easily be
36
SIP calls, GSM SMS's, etc.</p>
39
<property name="InitialServicePoint" tp:name-for-bindings="Initial_Service_Point"
40
type="(us)" tp:type="Service_Point" access="read">
41
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
42
<p>This property is used to indicate that the channel target is a
43
well-known service point. Please note that the CM (or lower layers
44
of the stack or network) may forward the connection to other other
45
service points, which the CM SHOULD indicate via
46
<tp:member-ref>ServicePointChanged</tp:member-ref>
49
<p>This property SHOULD be set for channel requests that are
50
specifically targeting service points.</p>
54
<property name="CurrentServicePoint" tp:name-for-bindings="Current_Service_Point"
55
type="(us)" tp:type="Service_Point" access="read">
57
The service point that the channel is connected to. If the channel is
58
not connected to a service point, the CM MUST set the
59
<tp:type>Service_Point_Type</tp:type> field to None; for instance,
60
this will be the case for ordinary calls.
64
<signal name="ServicePointChanged" tp:name-for-bindings="Service_Point_Changed">
66
<p>Emitted when a channel changes the service point that it's connected to. This
67
might be a new call being connected to a service, a call connected to
68
a service being routed to a different service
69
(ie, an emergency call being routed from a generic emergency PSAP to
70
a poison control PSAP), or any number of other things.</p>
72
<p>Note that this should be emitted as soon as the CM has been notified
73
of the switch, and has updated its internal state. The CM MAY still
74
be in the process of connecting to the new service point.</p>
77
<arg name="Service_Point" type="(us)" tp:type="Service_Point">
79
The new service point that is being used.
86
<!-- vim:set sw=2 sts=2 et ft=xml: -->