1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
|
VoiceCallManager hierarchy
==========================
Service org.ofono
Interface org.ofono.VoiceCallManager
Object path [variable prefix]/{modem0,modem1,...}
Methods dict GetProperties()
Returns properties for the VoiceCallManager Interface.
See the properties section for available properties.
array{object,dict} GetCalls()
Get an array of call object paths and properties
that represents the currently present calls.
This method call should only be used once when an
application starts up. Further call additions and
removal shall be monitored via CallAdded and
CallRemoved signals.
object Dial(string number, string hide_callerid)
Initiates a new outgoing call. Returns the object path
to the newly created call. The hide_callerid variable
holds the CLIR override for this call.
The defines values are:
"" or "default" - Default (Network) CLIR mode
is used
"enabled" - Hides callerid, CLIR Invocation
is used
"disabled" - Shows callerid, CLIR Suppression
is used
The number must be a string in the following format:
[+][0-9*#]{1,80}
In other words, it must be a non-empty string
optionally prefixed with a '+' followed by 1 to 80
characters. The character set can contain numbers,
'*' and '#'. Besides this sanity checking no further
number validation is performed. It is assumed the
network will perform further validation. The optional
'+' denotes an international number format. For
example:
+15551234567 - International format
5551234567 - National / Uknown format
This method is usually implemented using the ATD AT
command.
NOTE: If an active call (single or multiparty) exists,
then it is automatically put on hold if the dial
procedure is successful.
Possible Errors: [service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.NotImplemented
[service].Error.Failed
void Transfer()
Joins the currently Active (or Outgoing, depending
on network support) and Held calls together and
disconnects both calls. In effect transferring
one party to the other. This procedure requires
an Active and Held call and the Explicit Call Transfer
(ECT) supplementary service to be active.
This functionality is generally implemented by using
the +CHLD=4 AT command.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void SwapCalls()
Swaps Active and Held calls. The effect of this
is that all calls (0 or more including calls in a
multi-party conversation) that were Active are now Held,
and all calls (0 or more) that were Held are now Active.
GSM specification does not allow calls to be swapped
in the case where Held, Active and Waiting calls exist.
Some modems implement this anyway, thus it is
manufacturer specific whether this method will succeed
in the case of Held, Active and Waiting calls.
This functionality is generally implemented by using
the +CHLD=2 AT command.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void ReleaseAndAnswer()
Releases currently active call (0 or more) and
answers the currently waiting call. Please note that
if the current call is a multiparty call, then all
parties in the multi-party call will be released.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void ReleaseAndSwap()
Releases currently active call (0 or more) and
activates any currently held calls. Please note that
if the current call is a multiparty call, then all
parties in the multi-party call will be released.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void HoldAndAnswer()
Puts the current call (including multi-party calls) on
hold and answers the currently waiting call. Calling
this function when a user already has a both Active and
Held calls is invalid, since in GSM a user can have
only a single Held call at a time.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void HangupAll()
Releases all calls except waiting calls. This includes
multiparty calls.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
array{object} PrivateChat(object call)
Places the multi-party call on hold and makes desired
call active. This is used to accomplish private chat
functionality. Note that if there are only two calls
(three parties) in the multi-party call the result will
be two regular calls, one held and one active. The
Multiparty call will need to be setup again by using the
CreateMultiparty method. Returns the new list of calls
participating in the multiparty call.
This is usually implemented using the +CHLD=2X command.
Possible Errors: [service].Error.InProgress
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.NotFound
[service].Error.NotImplemented
[service].Error.Failed
array{object} CreateMultiparty()
Joins active and held calls together into a multi-party
call. If one of the calls is already a multi-party
call, then the other call is added to the multiparty
conversation. Returns the new list of calls
participating in the multiparty call.
There can only be one subscriber controlled multi-party
call according to the GSM specification.
This is usually implemented using the +CHLD=3 AT
command.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void HangupMultiparty()
Hangs up the multi-party call. All participating
calls are released.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.Failed
void SendTones(string tones)
Sends the DTMF tones to the network. The tones have
a fixed duration. Tones can be one of: '0' - '9',
'*', '#', 'A', 'B', 'C', 'D'. The last four are
typically not used in normal circumstances.
Possible Errors: [service].Error.InProgress
[service].Error.NotImplemented
[service].Error.InvalidArguments
[service].Error.InvalidFormat
[service].Error.Failed
Signals CallAdded(object path, dict properties)
Signal that is sent when a new call is added. It
contains the object path of the new voice call and
also its properties.
Applications get the whole properties via this
signal and don't need to call GetProperties on
the voice call object.
CallRemoved(object path)
Signal that is sent when a voice call has been
released. The object path is no longer accessible
after this signal and only emitted for reference.
NOTE: If the VoiceCallManager interface becomes
unavailable, this signal is not guaranteed to be
emitted for remaining calls. The applications are
expected to monitor changes in Modem.Interfaces
property.
PropertyChanged(string property, variant value)
Signal is emitted whenever a property has changed.
The new value is passed as the signal argument.
BarringActive(string type) [experimental]
Signal emitted when an outgoing voice call is made and
the call has been barred by the network due to the
remote party's "Call Barring" Supplementary Services
settings for incoming calls. In this case the type
parameter in the signal set to "remote".
The signal is also emitted when an outgoing voice call
is made and the call has been barred by the network due
to the local "Call Barring" Supplementary Services
settings for outgoing calls. In this case the type
parameter in the signal is set to "local".
Forwarded(string type) [experimental]
Signal emitted when an outgoing voice call is made and
the call has been redirected to another number due to
the remote party's "Call Forwarding" Supplementary
Services settings. In this case the type parameter in
the signal is set to "outgoing".
The signal is also emitted when the incoming voice call
is a redirected call due to a call forwarding operation.
In this case the type parameter in the signal is set to
"incoming".
Properties array{string} EmergencyNumbers [readonly]
Contains the list of emergency numbers recognized
by oFono. This list is based on the default set
of numbers provided by the specification and any
extra numbers provisioned by the carrier on the
SIM.
|
