5 Interface org.ofono.VoiceCall
6 Object path [variable prefix]/{modem0,modem1,...}/{voicecall01,voicecall02,...}
8 Methods dict GetProperties()
10 Returns all properties for this object. See the
11 properties section for available properties.
13 void Deflect(string number)
15 Deflects the incoming or waiting call to number given
16 in the argument. This method is only valid if the
17 call is in "incoming" or "waiting" state and the
18 Call Deflection supplementary service is subscribed to.
20 This functionality is generally implemented by using
21 the +CHLD=4 * NUMBER command.
23 This method should not be confused with the Transfer()
26 Possible Errors: [service].Error.InProgress
27 [service].Error.NotImplemented
28 [service].Error.InvalidArguments
29 [service].Error.InvalidFormat
30 [service].Error.Failed
34 Hangs up the voice call.
36 For an incoming call, the call is hung up using ATH or
37 equivalent. For a waiting call, the remote party is
38 notified by using the User Determined User Busy (UDUB)
39 condition. This is generally implemented using CHLD=0.
41 Please note that the GSM specification does not allow
42 the release of a held call when a waiting call exists,
43 or the release of a particular party in a held
46 Note that releasing a held call or a particular party
47 of a held multiparty call might not be possible on some
50 NOTE: Releasing active calls does not produce
51 side-effects. That is the state of held or waiting
52 calls is not affected.
54 Possible Errors: [service].Error.InProgress
55 [service].Error.Failed
56 [service].Error.NotImplemented
60 Answers the incoming call. Only valid if the state
61 of the call is "incoming."
63 This functionality is generally implemented by ATA
66 Possible Errors: [service].Error.InProgress
67 [service].Error.Failed
68 [service].Error.NotImplemented
69 [service].Error.Failed
71 Signals PropertyChanged(string property, variant value)
73 Signal is emitted whenever a property has changed.
74 The new value is passed as the signal argument.
76 DisconnectReason(string reason)
78 This signal is emitted when the modem manager can
79 provide extra information about why this call was
80 released. The possible reason values are:
81 "local" - The call was release due to local
83 "remote" - Remote party released the call
84 "network" - Network released the call, most
85 likely due to low signal or
88 Not all implementations are able to provide this
89 information, so applications should treat the emission
90 of this signal as optional. This signal will be
91 emitted before the PropertyChanged signal.
93 Properties string LineIdentification [readonly]
95 Contains the Line Identification information returned
96 by the network, if present. For incoming calls this is
97 effectively the CLIP. For outgoing calls this attribute
98 will hold the dialed number, or the COLP if received by
99 the underlying implementation.
101 Please note that COLP may be different from the
102 dialed number. A special "withheld" value means the
103 remote party refused to provide caller ID and the
104 "override category" option was not provisioned for
105 the current subscriber.
107 string IncomingLine [readonly, optional]
109 Contains the Called Line Identification information
110 returned by the network. This is only available for
111 incoming calls and indicates the local subscriber
112 number which was dialed by the remote party. This is
113 useful for subscribers which have a multiple line
114 service with their network provider and would like
115 to know what line the call is coming in on.
117 string Name [readonly]
119 Contains the Name Identification information returned
120 by the network, if present.
122 boolean Multiparty [readonly]
124 Contains the indication if the voice call is part
125 of a multiparty call or not.
127 Notifications if a call becomes part or leaves a
128 multipart call are sent.
130 string State [readonly]
132 Contains the state of the current call. The state
134 - "active" - The call is active
135 - "held" - The call is on hold
136 - "dialing" - The call is being dialed
137 - "alerting" - The remote party is being alerted
138 - "incoming" - Incoming call in progress
139 - "waiting" - Call is waiting
140 - "disconnected" - No further use of this object
141 is allowed, it will be destroyed shortly
143 string StartTime [readonly, optional]
145 Contains the starting time of the call. The time is
146 stamped when the call enters the "active" state.
147 Client applications can use this to infer somewhat
148 reliable call duration information.
150 string Information [readonly, optional]
152 Contains information related to the call for the
153 user. Currently this property is set for calls
154 initiated by SIM Toolkit applications.
156 byte Icon [readonly, optional]
158 Icon identifier to be used instead of or together
159 with the text information.
161 boolean Emergency [readonly]
163 Contains the indication if the voice call is an
164 emergency call or not.
166 boolean RemoteHeld [experimental]
168 Contains the indication whether the voice call is put
169 on hold by the remote party or not.
171 boolean RemoteMultiparty [experimental]
173 Contains the indication whether the voice call is
174 joined in a multiparty call by the remote party or not.