blob: 497864e875b83eb193ececce9cb093718b0ad3bc [file] [log] [blame]
Yorke Leeb4ce1432014-06-09 13:53:23 -07001/*
2 * Copyright (C) 2014 The Android Open Source Project
3 *
Santos Cordon9eb45932014-06-27 12:28:43 -07004 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
5 * in compliance with the License. You may obtain a copy of the License at
Yorke Leeb4ce1432014-06-09 13:53:23 -07006 *
Santos Cordon9eb45932014-06-27 12:28:43 -07007 * http://www.apache.org/licenses/LICENSE-2.0
Yorke Leeb4ce1432014-06-09 13:53:23 -07008 *
Santos Cordon9eb45932014-06-27 12:28:43 -07009 * Unless required by applicable law or agreed to in writing, software distributed under the License
10 * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
11 * or implied. See the License for the specific language governing permissions and limitations under
12 * the License.
Yorke Leeb4ce1432014-06-09 13:53:23 -070013 */
14
Tyler Gunnef9f6f92014-09-12 22:16:17 -070015package android.telecom;
Yorke Leeb4ce1432014-06-09 13:53:23 -070016
Hall Liu0464b9b2016-01-12 15:32:58 -080017import android.Manifest;
Yorke Leec61d13662015-09-21 17:25:25 -070018import android.annotation.RequiresPermission;
Santos Cordon6c7a3882014-06-25 15:30:08 -070019import android.annotation.SystemApi;
20import android.content.ComponentName;
Yorke Leeb4ce1432014-06-09 13:53:23 -070021import android.content.Context;
Yorke Lee3e56ba12015-04-23 12:32:36 -070022import android.content.Intent;
Nancy Chenb2299c12014-10-29 18:22:11 -070023import android.net.Uri;
Santos Cordon96efb482014-07-19 14:57:05 -070024import android.os.Bundle;
Santos Cordon6c7a3882014-06-25 15:30:08 -070025import android.os.RemoteException;
26import android.os.ServiceManager;
Yorke Lee2ae312e2014-09-12 17:58:48 -070027import android.telephony.TelephonyManager;
Anthony Lee67279262014-10-27 11:28:40 -070028import android.text.TextUtils;
Santos Cordon6c7a3882014-06-25 15:30:08 -070029import android.util.Log;
Yorke Leeb4ce1432014-06-09 13:53:23 -070030
Tyler Gunnef9f6f92014-09-12 22:16:17 -070031import com.android.internal.telecom.ITelecomService;
Yorke Leeb4ce1432014-06-09 13:53:23 -070032
Jay Shrauner7746a942014-08-26 12:15:15 -070033import java.util.ArrayList;
Tyler Gunna1ed7d12014-09-08 09:52:22 -070034import java.util.Collections;
Ihab Awad807fe0a2014-07-09 12:30:52 -070035import java.util.List;
36
Yorke Leeb4ce1432014-06-09 13:53:23 -070037/**
Santos Cordond9e614f2014-10-28 13:10:36 -070038 * Provides access to information about active calls and registration/call-management functionality.
Evan Charlton0e094d92014-11-08 15:49:16 -080039 * Apps can use methods in this class to determine the current call state.
Santos Cordond9e614f2014-10-28 13:10:36 -070040 * <p>
41 * Apps do not instantiate this class directly; instead, they retrieve a reference to an instance
42 * through {@link Context#getSystemService Context.getSystemService(Context.TELECOM_SERVICE)}.
43 * <p>
44 * Note that access to some telecom information is permission-protected. Your app cannot access the
45 * protected information or gain access to protected functionality unless it has the appropriate
46 * permissions declared in its manifest file. Where permissions apply, they are noted in the method
47 * descriptions.
Yorke Leeb4ce1432014-06-09 13:53:23 -070048 */
Tyler Gunnef9f6f92014-09-12 22:16:17 -070049public class TelecomManager {
Ihab Awad807fe0a2014-07-09 12:30:52 -070050
Evan Charlton10197192014-07-19 15:00:29 -070051 /**
Santos Cordon96efb482014-07-19 14:57:05 -070052 * Activity action: Starts the UI for handing an incoming call. This intent starts the in-call
Tyler Gunnef9f6f92014-09-12 22:16:17 -070053 * UI by notifying the Telecom system that an incoming call exists for a specific call service
54 * (see {@link android.telecom.ConnectionService}). Telecom reads the Intent extras to find
55 * and bind to the appropriate {@link android.telecom.ConnectionService} which Telecom will
Santos Cordon96efb482014-07-19 14:57:05 -070056 * ultimately use to control and get information about the call.
57 * <p>
58 * Input: get*Extra field {@link #EXTRA_PHONE_ACCOUNT_HANDLE} contains the component name of the
Tyler Gunnef9f6f92014-09-12 22:16:17 -070059 * {@link android.telecom.ConnectionService} that Telecom should bind to. Telecom will then
Evan Charlton10197192014-07-19 15:00:29 -070060 * ask the connection service for more information about the call prior to showing any UI.
Evan Charlton10197192014-07-19 15:00:29 -070061 */
Tyler Gunnef9f6f92014-09-12 22:16:17 -070062 public static final String ACTION_INCOMING_CALL = "android.telecom.action.INCOMING_CALL";
Evan Charlton10197192014-07-19 15:00:29 -070063
64 /**
Yorke Leec3cf9822014-10-02 09:38:39 -070065 * Similar to {@link #ACTION_INCOMING_CALL}, but is used only by Telephony to add a new
66 * sim-initiated MO call for carrier testing.
67 * @hide
68 */
69 public static final String ACTION_NEW_UNKNOWN_CALL = "android.telecom.action.NEW_UNKNOWN_CALL";
70
71 /**
Santos Cordon895d4b82015-06-25 16:41:48 -070072 * An {@link android.content.Intent} action sent by the telecom framework to start a
73 * configuration dialog for a registered {@link PhoneAccount}. There is no default dialog
74 * and each app that registers a {@link PhoneAccount} should provide one if desired.
75 * <p>
76 * A user can access the list of enabled {@link android.telecom.PhoneAccount}s through the Phone
77 * app's settings menu. For each entry, the settings app will add a click action. When
78 * triggered, the click-action will start this intent along with the extra
79 * {@link #EXTRA_PHONE_ACCOUNT_HANDLE} to indicate the {@link PhoneAccount} to configure. If the
80 * {@link PhoneAccount} package does not register an {@link android.app.Activity} for this
81 * intent, then it will not be sent.
Evan Charlton10197192014-07-19 15:00:29 -070082 */
Santos Cordon895d4b82015-06-25 16:41:48 -070083 public static final String ACTION_CONFIGURE_PHONE_ACCOUNT =
84 "android.telecom.action.CONFIGURE_PHONE_ACCOUNT";
Evan Charlton10197192014-07-19 15:00:29 -070085
86 /**
Andrew Lee873cfbf2015-02-26 15:22:00 -080087 * The {@link android.content.Intent} action used to show the call accessibility settings page.
88 */
89 public static final String ACTION_SHOW_CALL_ACCESSIBILITY_SETTINGS =
90 "android.telecom.action.SHOW_CALL_ACCESSIBILITY_SETTINGS";
91
92 /**
Yorke Lee3818a8922014-07-21 15:57:17 -070093 * The {@link android.content.Intent} action used to show the call settings page.
94 */
95 public static final String ACTION_SHOW_CALL_SETTINGS =
Tyler Gunnef9f6f92014-09-12 22:16:17 -070096 "android.telecom.action.SHOW_CALL_SETTINGS";
Yorke Lee3818a8922014-07-21 15:57:17 -070097
98 /**
Andrew Lee866080f2015-02-19 12:05:33 -080099 * The {@link android.content.Intent} action used to show the respond via SMS settings page.
100 */
101 public static final String ACTION_SHOW_RESPOND_VIA_SMS_SETTINGS =
102 "android.telecom.action.SHOW_RESPOND_VIA_SMS_SETTINGS";
103
104 /**
Evan Charlton6d8604f2014-09-04 12:38:17 -0700105 * The {@link android.content.Intent} action used to show the settings page used to configure
106 * {@link PhoneAccount} preferences.
107 */
108 public static final String ACTION_CHANGE_PHONE_ACCOUNTS =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700109 "android.telecom.action.CHANGE_PHONE_ACCOUNTS";
Evan Charlton6d8604f2014-09-04 12:38:17 -0700110
111 /**
Santos Cordonc66f3ba2015-02-27 15:22:07 -0800112 * The {@link android.content.Intent} action used indicate that a new phone account was
113 * just registered.
114 * @hide
115 */
116 @SystemApi
117 public static final String ACTION_PHONE_ACCOUNT_REGISTERED =
118 "android.telecom.action.PHONE_ACCOUNT_REGISTERED";
119
120 /**
Bryce Lee30b0aa02015-09-23 21:53:53 -0700121 * The {@link android.content.Intent} action used indicate that a phone account was
122 * just unregistered.
123 * @hide
124 */
125 @SystemApi
126 public static final String ACTION_PHONE_ACCOUNT_UNREGISTERED =
127 "android.telecom.action.PHONE_ACCOUNT_UNREGISTERED";
128
129 /**
Yorke Lee1011f482015-04-23 15:58:27 -0700130 * Activity action: Shows a dialog asking the user whether or not they want to replace the
131 * current default Dialer with the one specified in
132 * {@link #EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME}.
133 *
134 * Usage example:
135 * <pre>
136 * Intent intent = new Intent(TelecomManager.ACTION_CHANGE_DEFAULT_DIALER);
137 * intent.putExtra(TelecomManager.EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME,
138 * getActivity().getPackageName());
139 * startActivity(intent);
140 * </pre>
141 */
142 public static final String ACTION_CHANGE_DEFAULT_DIALER =
143 "android.telecom.action.CHANGE_DEFAULT_DIALER";
144
145 /**
Yorke Lee107c4ce2015-06-15 12:08:24 -0700146 * Broadcast intent action indicating that the current default dialer has changed.
147 * The string extra {@link #EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME} will contain the
148 * name of the package that the default dialer was changed to.
149 *
150 * @see #EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME
151 */
152 public static final String ACTION_DEFAULT_DIALER_CHANGED =
153 "android.telecom.action.DEFAULT_DIALER_CHANGED";
154
155 /**
Yorke Lee1011f482015-04-23 15:58:27 -0700156 * Extra value used to provide the package name for {@link #ACTION_CHANGE_DEFAULT_DIALER}.
157 */
158 public static final String EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME =
159 "android.telecom.extra.CHANGE_DEFAULT_DIALER_PACKAGE_NAME";
160
161 /**
Evan Charlton6eb262c2014-07-19 18:18:19 -0700162 * Optional extra for {@link android.content.Intent#ACTION_CALL} containing a boolean that
163 * determines whether the speakerphone should be automatically turned on for an outgoing call.
Evan Charlton10197192014-07-19 15:00:29 -0700164 */
165 public static final String EXTRA_START_CALL_WITH_SPEAKERPHONE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700166 "android.telecom.extra.START_CALL_WITH_SPEAKERPHONE";
Evan Charlton10197192014-07-19 15:00:29 -0700167
168 /**
Evan Charlton6eb262c2014-07-19 18:18:19 -0700169 * Optional extra for {@link android.content.Intent#ACTION_CALL} containing an integer that
170 * determines the desired video state for an outgoing call.
Santos Cordon96efb482014-07-19 14:57:05 -0700171 * Valid options:
Yorke Lee32f24732015-05-12 16:18:03 -0700172 * {@link VideoProfile#STATE_AUDIO_ONLY},
173 * {@link VideoProfile#STATE_BIDIRECTIONAL},
174 * {@link VideoProfile#STATE_RX_ENABLED},
175 * {@link VideoProfile#STATE_TX_ENABLED}.
Evan Charlton10197192014-07-19 15:00:29 -0700176 */
177 public static final String EXTRA_START_CALL_WITH_VIDEO_STATE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700178 "android.telecom.extra.START_CALL_WITH_VIDEO_STATE";
Evan Charlton10197192014-07-19 15:00:29 -0700179
180 /**
Santos Cordon96efb482014-07-19 14:57:05 -0700181 * The extra used with an {@link android.content.Intent#ACTION_CALL} and
182 * {@link android.content.Intent#ACTION_DIAL} {@code Intent} to specify a
183 * {@link PhoneAccountHandle} to use when making the call.
Evan Charlton10197192014-07-19 15:00:29 -0700184 * <p class="note">
Santos Cordon96efb482014-07-19 14:57:05 -0700185 * Retrieve with {@link android.content.Intent#getParcelableExtra(String)}.
Evan Charlton10197192014-07-19 15:00:29 -0700186 */
Evan Charlton6eb262c2014-07-19 18:18:19 -0700187 public static final String EXTRA_PHONE_ACCOUNT_HANDLE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700188 "android.telecom.extra.PHONE_ACCOUNT_HANDLE";
Evan Charlton10197192014-07-19 15:00:29 -0700189
190 /**
Tyler Gunn335ff2e2015-07-30 14:18:33 -0700191 * Optional extra for {@link android.content.Intent#ACTION_CALL} containing a string call
192 * subject which will be associated with an outgoing call. Should only be specified if the
193 * {@link PhoneAccount} supports the capability {@link PhoneAccount#CAPABILITY_CALL_SUBJECT}.
194 */
195 public static final String EXTRA_CALL_SUBJECT = "android.telecom.extra.CALL_SUBJECT";
196
197 /**
Yorke Lee04ea7d32015-06-05 15:59:18 -0700198 * The extra used by a {@link ConnectionService} to provide the handle of the caller that
199 * has initiated a new incoming call.
200 */
Yorke Lee02fb5bc2015-06-09 12:27:36 -0700201 public static final String EXTRA_INCOMING_CALL_ADDRESS =
202 "android.telecom.extra.INCOMING_CALL_ADDRESS";
Yorke Lee04ea7d32015-06-05 15:59:18 -0700203
204 /**
Santos Cordon96efb482014-07-19 14:57:05 -0700205 * Optional extra for {@link #ACTION_INCOMING_CALL} containing a {@link Bundle} which contains
206 * metadata about the call. This {@link Bundle} will be returned to the
207 * {@link ConnectionService}.
Evan Charlton10197192014-07-19 15:00:29 -0700208 */
209 public static final String EXTRA_INCOMING_CALL_EXTRAS =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700210 "android.telecom.extra.INCOMING_CALL_EXTRAS";
Evan Charlton10197192014-07-19 15:00:29 -0700211
212 /**
Nancy Chen10798dc2014-08-08 14:00:25 -0700213 * Optional extra for {@link android.content.Intent#ACTION_CALL} and
214 * {@link android.content.Intent#ACTION_DIAL} {@code Intent} containing a {@link Bundle}
215 * which contains metadata about the call. This {@link Bundle} will be saved into
Santos Cordon7a060d52015-06-19 14:52:04 -0700216 * {@code Call.Details} and passed to the {@link ConnectionService} when placing the call.
Nancy Chen10798dc2014-08-08 14:00:25 -0700217 */
218 public static final String EXTRA_OUTGOING_CALL_EXTRAS =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700219 "android.telecom.extra.OUTGOING_CALL_EXTRAS";
Nancy Chen10798dc2014-08-08 14:00:25 -0700220
221 /**
Yorke Leec3cf9822014-10-02 09:38:39 -0700222 * @hide
223 */
224 public static final String EXTRA_UNKNOWN_CALL_HANDLE =
225 "android.telecom.extra.UNKNOWN_CALL_HANDLE";
226
227 /**
Evan Charlton6eb262c2014-07-19 18:18:19 -0700228 * Optional extra for {@link android.telephony.TelephonyManager#ACTION_PHONE_STATE_CHANGED}
229 * containing the disconnect code.
Evan Charlton10197192014-07-19 15:00:29 -0700230 */
231 public static final String EXTRA_CALL_DISCONNECT_CAUSE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700232 "android.telecom.extra.CALL_DISCONNECT_CAUSE";
Evan Charlton10197192014-07-19 15:00:29 -0700233
234 /**
Evan Charlton6eb262c2014-07-19 18:18:19 -0700235 * Optional extra for {@link android.telephony.TelephonyManager#ACTION_PHONE_STATE_CHANGED}
236 * containing the disconnect message.
Evan Charlton10197192014-07-19 15:00:29 -0700237 */
238 public static final String EXTRA_CALL_DISCONNECT_MESSAGE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700239 "android.telecom.extra.CALL_DISCONNECT_MESSAGE";
Evan Charlton10197192014-07-19 15:00:29 -0700240
241 /**
Evan Charlton6eb262c2014-07-19 18:18:19 -0700242 * Optional extra for {@link android.telephony.TelephonyManager#ACTION_PHONE_STATE_CHANGED}
243 * containing the component name of the associated connection service.
Evan Charlton0e094d92014-11-08 15:49:16 -0800244 * @hide
Evan Charlton10197192014-07-19 15:00:29 -0700245 */
Evan Charlton0e094d92014-11-08 15:49:16 -0800246 @SystemApi
Evan Charlton10197192014-07-19 15:00:29 -0700247 public static final String EXTRA_CONNECTION_SERVICE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700248 "android.telecom.extra.CONNECTION_SERVICE";
Evan Charlton10197192014-07-19 15:00:29 -0700249
250 /**
Hall Liu90f62902015-11-19 16:19:24 -0800251 * Optional extra for communicating the call technology used by a
252 * {@link com.android.internal.telephony.Connection} to Telecom
253 * @hide
254 */
255 public static final String EXTRA_CALL_TECHNOLOGY_TYPE =
256 "android.telecom.extra.CALL_TECHNOLOGY_TYPE";
257
258 /**
Nancy Chen7ab1dc42014-09-09 18:18:26 -0700259 * An optional {@link android.content.Intent#ACTION_CALL} intent extra denoting the
260 * package name of the app specifying an alternative gateway for the call.
261 * The value is a string.
262 *
263 * (The following comment corresponds to the all GATEWAY_* extras)
264 * An app which sends the {@link android.content.Intent#ACTION_CALL} intent can specify an
265 * alternative address to dial which is different from the one specified and displayed to
266 * the user. This alternative address is referred to as the gateway address.
267 */
268 public static final String GATEWAY_PROVIDER_PACKAGE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700269 "android.telecom.extra.GATEWAY_PROVIDER_PACKAGE";
Nancy Chen7ab1dc42014-09-09 18:18:26 -0700270
271 /**
272 * An optional {@link android.content.Intent#ACTION_CALL} intent extra corresponding to the
273 * original address to dial for the call. This is used when an alternative gateway address is
274 * provided to recall the original address.
275 * The value is a {@link android.net.Uri}.
276 *
277 * (See {@link #GATEWAY_PROVIDER_PACKAGE} for details)
278 */
279 public static final String GATEWAY_ORIGINAL_ADDRESS =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700280 "android.telecom.extra.GATEWAY_ORIGINAL_ADDRESS";
Nancy Chen7ab1dc42014-09-09 18:18:26 -0700281
282 /**
Evan Charlton10197192014-07-19 15:00:29 -0700283 * The number which the party on the other side of the line will see (and use to return the
284 * call).
285 * <p>
Santos Cordon96efb482014-07-19 14:57:05 -0700286 * {@link ConnectionService}s which interact with {@link RemoteConnection}s should only populate
287 * this if the {@link android.telephony.TelephonyManager#getLine1Number()} value, as that is the
288 * user's expected caller ID.
Evan Charlton10197192014-07-19 15:00:29 -0700289 */
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700290 public static final String EXTRA_CALL_BACK_NUMBER = "android.telecom.extra.CALL_BACK_NUMBER";
Evan Charlton10197192014-07-19 15:00:29 -0700291
292 /**
Santos Cordonf2600eb2015-06-22 15:02:20 -0700293 * A boolean meta-data value indicating whether an {@link InCallService} implements an
294 * in-call user interface. Dialer implementations (see {@link #getDefaultDialerPackage()}) which
295 * would also like to replace the in-call interface should set this meta-data to {@code true} in
296 * the manifest registration of their {@link InCallService}.
297 */
298 public static final String METADATA_IN_CALL_SERVICE_UI = "android.telecom.IN_CALL_SERVICE_UI";
299
300 /**
Santos Cordon88881552015-12-10 17:29:54 -0800301 * A boolean meta-data value indicating whether an {@link InCallService} implements an
302 * in-call user interface to be used while the device is in car-mode (see
303 * {@link android.content.res.Configuration.UI_MODE_TYPE_CAR}).
304 *
305 * @hide
306 */
307 public static final String METADATA_IN_CALL_SERVICE_CAR_MODE_UI =
308 "android.telecom.IN_CALL_SERVICE_CAR_MODE_UI";
309
310 /**
Evan Charlton10197192014-07-19 15:00:29 -0700311 * The dual tone multi-frequency signaling character sent to indicate the dialing system should
312 * pause for a predefined period.
313 */
314 public static final char DTMF_CHARACTER_PAUSE = ',';
315
316 /**
317 * The dual-tone multi-frequency signaling character sent to indicate the dialing system should
318 * wait for user confirmation before proceeding.
319 */
320 public static final char DTMF_CHARACTER_WAIT = ';';
321
322 /**
323 * TTY (teletypewriter) mode is off.
324 *
325 * @hide
326 */
327 public static final int TTY_MODE_OFF = 0;
328
329 /**
330 * TTY (teletypewriter) mode is on. The speaker is off and the microphone is muted. The user
331 * will communicate with the remote party by sending and receiving text messages.
332 *
333 * @hide
334 */
335 public static final int TTY_MODE_FULL = 1;
336
337 /**
338 * TTY (teletypewriter) mode is in hearing carryover mode (HCO). The microphone is muted but the
339 * speaker is on. The user will communicate with the remote party by sending text messages and
340 * hearing an audible reply.
341 *
342 * @hide
343 */
344 public static final int TTY_MODE_HCO = 2;
345
346 /**
347 * TTY (teletypewriter) mode is in voice carryover mode (VCO). The speaker is off but the
348 * microphone is still on. User will communicate with the remote party by speaking and receiving
349 * text message replies.
350 *
351 * @hide
352 */
353 public static final int TTY_MODE_VCO = 3;
354
355 /**
356 * Broadcast intent action indicating that the current TTY mode has changed. An intent extra
357 * provides this state as an int.
Evan Charlton10197192014-07-19 15:00:29 -0700358 *
Santos Cordon96efb482014-07-19 14:57:05 -0700359 * @see #EXTRA_CURRENT_TTY_MODE
Evan Charlton10197192014-07-19 15:00:29 -0700360 * @hide
361 */
362 public static final String ACTION_CURRENT_TTY_MODE_CHANGED =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700363 "android.telecom.action.CURRENT_TTY_MODE_CHANGED";
Evan Charlton10197192014-07-19 15:00:29 -0700364
365 /**
366 * The lookup key for an int that indicates the current TTY mode.
367 * Valid modes are:
368 * - {@link #TTY_MODE_OFF}
369 * - {@link #TTY_MODE_FULL}
370 * - {@link #TTY_MODE_HCO}
371 * - {@link #TTY_MODE_VCO}
372 *
373 * @hide
374 */
375 public static final String EXTRA_CURRENT_TTY_MODE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700376 "android.telecom.intent.extra.CURRENT_TTY_MODE";
Evan Charlton10197192014-07-19 15:00:29 -0700377
378 /**
Santos Cordon96efb482014-07-19 14:57:05 -0700379 * Broadcast intent action indicating that the TTY preferred operating mode has changed. An
380 * intent extra provides the new mode as an int.
Evan Charlton10197192014-07-19 15:00:29 -0700381 *
Santos Cordon96efb482014-07-19 14:57:05 -0700382 * @see #EXTRA_TTY_PREFERRED_MODE
Evan Charlton10197192014-07-19 15:00:29 -0700383 * @hide
384 */
385 public static final String ACTION_TTY_PREFERRED_MODE_CHANGED =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700386 "android.telecom.action.TTY_PREFERRED_MODE_CHANGED";
Evan Charlton10197192014-07-19 15:00:29 -0700387
388 /**
Santos Cordon96efb482014-07-19 14:57:05 -0700389 * The lookup key for an int that indicates preferred TTY mode. Valid modes are: -
390 * {@link #TTY_MODE_OFF} - {@link #TTY_MODE_FULL} - {@link #TTY_MODE_HCO} -
391 * {@link #TTY_MODE_VCO}
Evan Charlton10197192014-07-19 15:00:29 -0700392 *
393 * @hide
394 */
395 public static final String EXTRA_TTY_PREFERRED_MODE =
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700396 "android.telecom.intent.extra.TTY_PREFERRED";
Evan Charlton10197192014-07-19 15:00:29 -0700397
Nancy Chen9d568c02014-09-08 14:17:59 -0700398 /**
Bryce Lee5e4dd3e2015-08-03 16:59:10 -0700399 * Broadcast intent action for letting custom component know to show the missed call
Sailesh Nepalbe15ad92016-01-21 19:26:20 -0800400 * notification. If no custom component exists then this is sent to the default dialer which
401 * should post a missed-call notification.
Bryce Lee5e4dd3e2015-08-03 16:59:10 -0700402 */
Bryce Lee5e4dd3e2015-08-03 16:59:10 -0700403 public static final String ACTION_SHOW_MISSED_CALLS_NOTIFICATION =
404 "android.telecom.action.SHOW_MISSED_CALLS_NOTIFICATION";
405
406 /**
Sailesh Nepalbe15ad92016-01-21 19:26:20 -0800407 * The number of calls associated with the notification. If the number is zero then the missed
408 * call notification should be dismissed.
Bryce Lee5e4dd3e2015-08-03 16:59:10 -0700409 */
Bryce Lee5e4dd3e2015-08-03 16:59:10 -0700410 public static final String EXTRA_NOTIFICATION_COUNT =
411 "android.telecom.extra.NOTIFICATION_COUNT";
412
413 /**
414 * The number associated with the missed calls. This number is only relevant
415 * when EXTRA_NOTIFICATION_COUNT is 1.
Bryce Lee5e4dd3e2015-08-03 16:59:10 -0700416 */
Bryce Lee5e4dd3e2015-08-03 16:59:10 -0700417 public static final String EXTRA_NOTIFICATION_PHONE_NUMBER =
418 "android.telecom.extra.NOTIFICATION_PHONE_NUMBER";
419
420 /**
Bryce Lee8d41d1d2015-08-10 07:40:42 -0700421 * The intent to clear missed calls.
422 * @hide
423 */
424 @SystemApi
425 public static final String EXTRA_CLEAR_MISSED_CALLS_INTENT =
426 "android.telecom.extra.CLEAR_MISSED_CALLS_INTENT";
427
428 /**
429 * The intent to call back a missed call.
430 * @hide
431 */
432 @SystemApi
433 public static final String EXTRA_CALL_BACK_INTENT =
434 "android.telecom.extra.CALL_BACK_INTENT";
435
436 /**
Nancy Chen9d568c02014-09-08 14:17:59 -0700437 * The following 4 constants define how properties such as phone numbers and names are
438 * displayed to the user.
439 */
440
Santos Cordoned769ae2015-05-13 18:47:38 -0700441 /**
442 * Indicates that the address or number of a call is allowed to be displayed for caller ID.
443 */
Nancy Chen9d568c02014-09-08 14:17:59 -0700444 public static final int PRESENTATION_ALLOWED = 1;
445
Santos Cordoned769ae2015-05-13 18:47:38 -0700446 /**
447 * Indicates that the address or number of a call is blocked by the other party.
448 */
Nancy Chen9d568c02014-09-08 14:17:59 -0700449 public static final int PRESENTATION_RESTRICTED = 2;
450
Santos Cordoned769ae2015-05-13 18:47:38 -0700451 /**
452 * Indicates that the address or number of a call is not specified or known by the carrier.
453 */
Nancy Chen9d568c02014-09-08 14:17:59 -0700454 public static final int PRESENTATION_UNKNOWN = 3;
455
Santos Cordoned769ae2015-05-13 18:47:38 -0700456 /**
457 * Indicates that the address or number of a call belongs to a pay phone.
458 */
Nancy Chen9d568c02014-09-08 14:17:59 -0700459 public static final int PRESENTATION_PAYPHONE = 4;
460
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700461 private static final String TAG = "TelecomManager";
Yorke Leeb4ce1432014-06-09 13:53:23 -0700462
463 private final Context mContext;
Yorke Leeb4ce1432014-06-09 13:53:23 -0700464
Hall Liue1bc2ec2015-10-09 15:58:37 -0700465 private final ITelecomService mTelecomServiceOverride;
466
Santos Cordon6c7a3882014-06-25 15:30:08 -0700467 /**
468 * @hide
469 */
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700470 public static TelecomManager from(Context context) {
471 return (TelecomManager) context.getSystemService(Context.TELECOM_SERVICE);
Yorke Leeb4ce1432014-06-09 13:53:23 -0700472 }
Santos Cordon6c7a3882014-06-25 15:30:08 -0700473
474 /**
475 * @hide
476 */
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700477 public TelecomManager(Context context) {
Hall Liue1bc2ec2015-10-09 15:58:37 -0700478 this(context, null);
479 }
480
481 /**
482 * @hide
483 */
484 public TelecomManager(Context context, ITelecomService telecomServiceImpl) {
Ihab Awad807fe0a2014-07-09 12:30:52 -0700485 Context appContext = context.getApplicationContext();
486 if (appContext != null) {
487 mContext = appContext;
488 } else {
489 mContext = context;
490 }
Hall Liue1bc2ec2015-10-09 15:58:37 -0700491 mTelecomServiceOverride = telecomServiceImpl;
Ihab Awad807fe0a2014-07-09 12:30:52 -0700492 }
493
494 /**
Santos Cordon91371dc02015-05-08 13:52:09 -0700495 * Return the {@link PhoneAccount} which will be used to place outgoing calls to addresses with
496 * the specified {@code uriScheme}. This {@link PhoneAccount} will always be a member of the
497 * list which is returned from invoking {@link #getCallCapablePhoneAccounts()}. The specific
498 * account returned depends on the following priorities:
499 * <ul>
500 * <li> If the user-selected default {@link PhoneAccount} supports the specified scheme, it will
501 * be returned.
502 * </li>
503 * <li> If there exists only one {@link PhoneAccount} that supports the specified scheme, it
504 * will be returned.
505 * </li>
506 * </ul>
Ihab Awad94cf4bf2014-07-17 11:21:19 -0700507 * <p>
Santos Cordon91371dc02015-05-08 13:52:09 -0700508 * If no {@link PhoneAccount} fits the criteria above, this method will return {@code null}.
509 *
Yorke Leec61d13662015-09-21 17:25:25 -0700510 * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
511 *
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700512 * @param uriScheme The URI scheme.
Santos Cordon91371dc02015-05-08 13:52:09 -0700513 * @return The {@link PhoneAccountHandle} corresponding to the account to be used.
Ihab Awad94cf4bf2014-07-17 11:21:19 -0700514 */
Yorke Leec61d13662015-09-21 17:25:25 -0700515 @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700516 public PhoneAccountHandle getDefaultOutgoingPhoneAccount(String uriScheme) {
Ihab Awad94cf4bf2014-07-17 11:21:19 -0700517 try {
518 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -0700519 return getTelecomService().getDefaultOutgoingPhoneAccount(uriScheme,
520 mContext.getOpPackageName());
Ihab Awad94cf4bf2014-07-17 11:21:19 -0700521 }
522 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700523 Log.e(TAG, "Error calling ITelecomService#getDefaultOutgoingPhoneAccount", e);
Ihab Awad94cf4bf2014-07-17 11:21:19 -0700524 }
525 return null;
526 }
527
528 /**
Andrew Leed4abbfb2014-09-03 14:58:27 -0700529 * Return the {@link PhoneAccount} which is the user-chosen default for making outgoing phone
530 * calls. This {@code PhoneAccount} will always be a member of the list which is returned from
Nancy Chen210ef032014-09-15 17:58:42 -0700531 * calling {@link #getCallCapablePhoneAccounts()}
Santos Cordon91371dc02015-05-08 13:52:09 -0700532 * <p>
Andrew Leed4abbfb2014-09-03 14:58:27 -0700533 * Apps must be prepared for this method to return {@code null}, indicating that there currently
534 * exists no user-chosen default {@code PhoneAccount}.
535 *
536 * @return The user outgoing phone account selected by the user.
Jay Shrauner225ccad2015-04-15 15:51:15 -0700537 * @hide
Andrew Leed4abbfb2014-09-03 14:58:27 -0700538 */
539 public PhoneAccountHandle getUserSelectedOutgoingPhoneAccount() {
540 try {
541 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700542 return getTelecomService().getUserSelectedOutgoingPhoneAccount();
Andrew Leed4abbfb2014-09-03 14:58:27 -0700543 }
544 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700545 Log.e(TAG, "Error calling ITelecomService#getUserSelectedOutgoingPhoneAccount", e);
Andrew Leed4abbfb2014-09-03 14:58:27 -0700546 }
547 return null;
548 }
549
550 /**
Santos Cordon91371dc02015-05-08 13:52:09 -0700551 * Sets the user-chosen default for making outgoing phone calls.
Andrew Lee59cac3a2014-08-28 16:50:10 -0700552 * @hide
553 */
Andrew Leed4abbfb2014-09-03 14:58:27 -0700554 public void setUserSelectedOutgoingPhoneAccount(PhoneAccountHandle accountHandle) {
Andrew Lee59cac3a2014-08-28 16:50:10 -0700555 try {
556 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700557 getTelecomService().setUserSelectedOutgoingPhoneAccount(accountHandle);
Andrew Lee59cac3a2014-08-28 16:50:10 -0700558 }
559 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700560 Log.e(TAG, "Error calling ITelecomService#setUserSelectedOutgoingPhoneAccount");
Andrew Lee59cac3a2014-08-28 16:50:10 -0700561 }
562 }
563
564 /**
Andrew Lee59cac3a2014-08-28 16:50:10 -0700565 * Returns the current SIM call manager. Apps must be prepared for this method to return
566 * {@code null}, indicating that there currently exists no user-chosen default
567 * {@code PhoneAccount}.
Santos Cordon91371dc02015-05-08 13:52:09 -0700568 *
Andrew Lee59cac3a2014-08-28 16:50:10 -0700569 * @return The phone account handle of the current sim call manager.
Andrew Lee59cac3a2014-08-28 16:50:10 -0700570 */
571 public PhoneAccountHandle getSimCallManager() {
572 try {
573 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700574 return getTelecomService().getSimCallManager();
Andrew Lee59cac3a2014-08-28 16:50:10 -0700575 }
576 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700577 Log.e(TAG, "Error calling ITelecomService#getSimCallManager");
Andrew Lee59cac3a2014-08-28 16:50:10 -0700578 }
579 return null;
580 }
581
582 /**
Sailesh Nepalcf855622015-07-28 19:22:14 -0700583 * Returns the current SIM call manager for the specified user. Apps must be prepared for this
584 * method to return {@code null}, indicating that there currently exists no user-chosen default
585 * {@code PhoneAccount}.
586 *
587 * @return The phone account handle of the current sim call manager.
588 *
589 * @hide
590 */
591 public PhoneAccountHandle getSimCallManager(int userId) {
592 try {
593 if (isServiceConnected()) {
594 return getTelecomService().getSimCallManagerForUser(userId);
595 }
596 } catch (RemoteException e) {
597 Log.e(TAG, "Error calling ITelecomService#getSimCallManagerForUser");
598 }
599 return null;
600 }
601
602 /**
Evan Charltoneb0a8d562014-09-04 12:03:34 -0700603 * Returns the current connection manager. Apps must be prepared for this method to return
604 * {@code null}, indicating that there currently exists no user-chosen default
605 * {@code PhoneAccount}.
606 *
607 * @return The phone account handle of the current connection manager.
Evan Charlton0e094d92014-11-08 15:49:16 -0800608 * @hide
Evan Charltoneb0a8d562014-09-04 12:03:34 -0700609 */
Evan Charlton0e094d92014-11-08 15:49:16 -0800610 @SystemApi
Evan Charltoneb0a8d562014-09-04 12:03:34 -0700611 public PhoneAccountHandle getConnectionManager() {
612 return getSimCallManager();
613 }
614
615 /**
Nancy Chen210ef032014-09-15 17:58:42 -0700616 * Returns a list of the {@link PhoneAccountHandle}s which can be used to make and receive phone
617 * calls which support the specified URI scheme.
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700618 * <P>
619 * For example, invoking with {@code "tel"} will find all {@link PhoneAccountHandle}s which
620 * support telephone calls (e.g. URIs such as {@code tel:555-555-1212}). Invoking with
621 * {@code "sip"} will find all {@link PhoneAccountHandle}s which support SIP calls (e.g. URIs
622 * such as {@code sip:example@sipexample.com}).
623 *
624 * @param uriScheme The URI scheme.
625 * @return A list of {@code PhoneAccountHandle} objects supporting the URI scheme.
Evan Charlton0e094d92014-11-08 15:49:16 -0800626 * @hide
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700627 */
Evan Charlton0e094d92014-11-08 15:49:16 -0800628 @SystemApi
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700629 public List<PhoneAccountHandle> getPhoneAccountsSupportingScheme(String uriScheme) {
630 try {
631 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -0700632 return getTelecomService().getPhoneAccountsSupportingScheme(uriScheme,
633 mContext.getOpPackageName());
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700634 }
635 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700636 Log.e(TAG, "Error calling ITelecomService#getPhoneAccountsSupportingScheme", e);
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700637 }
638 return new ArrayList<>();
639 }
640
Nancy Chen513c8922014-09-17 14:47:20 -0700641
642 /**
Santos Cordon91371dc02015-05-08 13:52:09 -0700643 * Returns a list of {@link PhoneAccountHandle}s which can be used to make and receive phone
644 * calls. The returned list includes only those accounts which have been explicitly enabled
645 * by the user.
Nancy Chen513c8922014-09-17 14:47:20 -0700646 *
Yorke Leec61d13662015-09-21 17:25:25 -0700647 * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
648 *
Nancy Chen513c8922014-09-17 14:47:20 -0700649 * @see #EXTRA_PHONE_ACCOUNT_HANDLE
650 * @return A list of {@code PhoneAccountHandle} objects.
Nancy Chen513c8922014-09-17 14:47:20 -0700651 */
Yorke Leec61d13662015-09-21 17:25:25 -0700652 @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)
Nancy Chen513c8922014-09-17 14:47:20 -0700653 public List<PhoneAccountHandle> getCallCapablePhoneAccounts() {
Santos Cordon91371dc02015-05-08 13:52:09 -0700654 return getCallCapablePhoneAccounts(false);
655 }
656
657 /**
658 * Returns a list of {@link PhoneAccountHandle}s including those which have not been enabled
659 * by the user.
660 *
661 * @return A list of {@code PhoneAccountHandle} objects.
662 * @hide
663 */
664 public List<PhoneAccountHandle> getCallCapablePhoneAccounts(boolean includeDisabledAccounts) {
Nancy Chen513c8922014-09-17 14:47:20 -0700665 try {
666 if (isServiceConnected()) {
Santos Cordon91371dc02015-05-08 13:52:09 -0700667 return getTelecomService().getCallCapablePhoneAccounts(
668 includeDisabledAccounts, mContext.getOpPackageName());
Nancy Chen513c8922014-09-17 14:47:20 -0700669 }
670 } catch (RemoteException e) {
Santos Cordon91371dc02015-05-08 13:52:09 -0700671 Log.e(TAG, "Error calling ITelecomService#getCallCapablePhoneAccounts(" +
672 includeDisabledAccounts + ")", e);
Nancy Chen513c8922014-09-17 14:47:20 -0700673 }
674 return new ArrayList<>();
675 }
676
Tyler Gunnf5b29dc2014-09-03 09:09:12 -0700677 /**
Nancy Chen513c8922014-09-17 14:47:20 -0700678 * Returns a list of all {@link PhoneAccount}s registered for the calling package.
679 *
680 * @return A list of {@code PhoneAccountHandle} objects.
Evan Charlton0e094d92014-11-08 15:49:16 -0800681 * @hide
Nancy Chen513c8922014-09-17 14:47:20 -0700682 */
Evan Charlton0e094d92014-11-08 15:49:16 -0800683 @SystemApi
Nancy Chen513c8922014-09-17 14:47:20 -0700684 public List<PhoneAccountHandle> getPhoneAccountsForPackage() {
685 try {
686 if (isServiceConnected()) {
687 return getTelecomService().getPhoneAccountsForPackage(mContext.getPackageName());
688 }
689 } catch (RemoteException e) {
690 Log.e(TAG, "Error calling ITelecomService#getPhoneAccountsForPackage", e);
691 }
692 return null;
693 }
694
695 /**
Evan Charlton8c8a0622014-07-20 12:31:00 -0700696 * Return the {@link PhoneAccount} for a specified {@link PhoneAccountHandle}. Object includes
697 * resources which can be used in a user interface.
Ihab Awad807fe0a2014-07-09 12:30:52 -0700698 *
Evan Charlton6eb262c2014-07-19 18:18:19 -0700699 * @param account The {@link PhoneAccountHandle}.
Evan Charlton8c8a0622014-07-20 12:31:00 -0700700 * @return The {@link PhoneAccount} object.
Ihab Awad807fe0a2014-07-09 12:30:52 -0700701 */
Evan Charlton8c8a0622014-07-20 12:31:00 -0700702 public PhoneAccount getPhoneAccount(PhoneAccountHandle account) {
Ihab Awad807fe0a2014-07-09 12:30:52 -0700703 try {
704 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700705 return getTelecomService().getPhoneAccount(account);
Ihab Awad807fe0a2014-07-09 12:30:52 -0700706 }
707 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700708 Log.e(TAG, "Error calling ITelecomService#getPhoneAccount", e);
Ihab Awad807fe0a2014-07-09 12:30:52 -0700709 }
710 return null;
711 }
712
713 /**
Nancy Chen210ef032014-09-15 17:58:42 -0700714 * Returns a count of all {@link PhoneAccount}s.
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700715 *
Nancy Chen210ef032014-09-15 17:58:42 -0700716 * @return The count of {@link PhoneAccount}s.
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700717 * @hide
718 */
719 @SystemApi
720 public int getAllPhoneAccountsCount() {
721 try {
722 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700723 return getTelecomService().getAllPhoneAccountsCount();
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700724 }
725 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700726 Log.e(TAG, "Error calling ITelecomService#getAllPhoneAccountsCount", e);
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700727 }
728 return 0;
729 }
730
731 /**
732 * Returns a list of all {@link PhoneAccount}s.
733 *
734 * @return All {@link PhoneAccount}s.
735 * @hide
736 */
737 @SystemApi
738 public List<PhoneAccount> getAllPhoneAccounts() {
739 try {
740 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700741 return getTelecomService().getAllPhoneAccounts();
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700742 }
743 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700744 Log.e(TAG, "Error calling ITelecomService#getAllPhoneAccounts", e);
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700745 }
746 return Collections.EMPTY_LIST;
747 }
748
749 /**
750 * Returns a list of all {@link PhoneAccountHandle}s.
751 *
752 * @return All {@link PhoneAccountHandle}s.
753 * @hide
754 */
755 @SystemApi
756 public List<PhoneAccountHandle> getAllPhoneAccountHandles() {
757 try {
758 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700759 return getTelecomService().getAllPhoneAccountHandles();
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700760 }
761 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700762 Log.e(TAG, "Error calling ITelecomService#getAllPhoneAccountHandles", e);
Tyler Gunna1ed7d12014-09-08 09:52:22 -0700763 }
764 return Collections.EMPTY_LIST;
765 }
766
767 /**
Santos Cordond9e614f2014-10-28 13:10:36 -0700768 * Register a {@link PhoneAccount} for use by the system. When registering
769 * {@link PhoneAccount}s, existing registrations will be overwritten if the
770 * {@link PhoneAccountHandle} matches that of a {@link PhoneAccount} which is already
771 * registered. Once registered, the {@link PhoneAccount} is listed to the user as an option
772 * when placing calls. The user may still need to enable the {@link PhoneAccount} within
773 * the phone app settings before the account is usable.
774 * <p>
775 * A {@link SecurityException} will be thrown if an app tries to register a
776 * {@link PhoneAccountHandle} where the package name specified within
777 * {@link PhoneAccountHandle#getComponentName()} does not match the package name of the app.
Ihab Awad807fe0a2014-07-09 12:30:52 -0700778 *
Evan Charlton8c8a0622014-07-20 12:31:00 -0700779 * @param account The complete {@link PhoneAccount}.
Ihab Awad807fe0a2014-07-09 12:30:52 -0700780 */
Evan Charlton8c8a0622014-07-20 12:31:00 -0700781 public void registerPhoneAccount(PhoneAccount account) {
Ihab Awad807fe0a2014-07-09 12:30:52 -0700782 try {
783 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700784 getTelecomService().registerPhoneAccount(account);
Ihab Awad807fe0a2014-07-09 12:30:52 -0700785 }
786 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700787 Log.e(TAG, "Error calling ITelecomService#registerPhoneAccount", e);
Ihab Awad807fe0a2014-07-09 12:30:52 -0700788 }
789 }
790
791 /**
Evan Charlton8c8a0622014-07-20 12:31:00 -0700792 * Remove a {@link PhoneAccount} registration from the system.
Ihab Awad807fe0a2014-07-09 12:30:52 -0700793 *
Evan Charlton8c8a0622014-07-20 12:31:00 -0700794 * @param accountHandle A {@link PhoneAccountHandle} for the {@link PhoneAccount} to unregister.
Ihab Awad807fe0a2014-07-09 12:30:52 -0700795 */
Evan Charlton8c8a0622014-07-20 12:31:00 -0700796 public void unregisterPhoneAccount(PhoneAccountHandle accountHandle) {
Ihab Awad807fe0a2014-07-09 12:30:52 -0700797 try {
798 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700799 getTelecomService().unregisterPhoneAccount(accountHandle);
Ihab Awad807fe0a2014-07-09 12:30:52 -0700800 }
801 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700802 Log.e(TAG, "Error calling ITelecomService#unregisterPhoneAccount", e);
Ihab Awad807fe0a2014-07-09 12:30:52 -0700803 }
804 }
805
806 /**
Nancy Chen7ab1dc42014-09-09 18:18:26 -0700807 * Remove all Accounts that belong to the calling package from the system.
Evan Charlton0e094d92014-11-08 15:49:16 -0800808 * @hide
Ihab Awad807fe0a2014-07-09 12:30:52 -0700809 */
Evan Charlton0e094d92014-11-08 15:49:16 -0800810 @SystemApi
Yorke Lee06044272015-04-14 15:16:59 -0700811 public void clearPhoneAccounts() {
812 clearAccounts();
813 }
814 /**
815 * Remove all Accounts that belong to the calling package from the system.
816 * @deprecated Use {@link #clearPhoneAccounts()} instead.
817 * @hide
818 */
819 @SystemApi
Nancy Chen7ab1dc42014-09-09 18:18:26 -0700820 public void clearAccounts() {
Ihab Awad807fe0a2014-07-09 12:30:52 -0700821 try {
822 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700823 getTelecomService().clearAccounts(mContext.getPackageName());
Ihab Awad807fe0a2014-07-09 12:30:52 -0700824 }
825 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700826 Log.e(TAG, "Error calling ITelecomService#clearAccounts", e);
Ihab Awad807fe0a2014-07-09 12:30:52 -0700827 }
828 }
829
830 /**
Anthony Lee67279262014-10-27 11:28:40 -0700831 * Remove all Accounts that belong to the specified package from the system.
832 * @hide
833 */
834 public void clearAccountsForPackage(String packageName) {
835 try {
836 if (isServiceConnected() && !TextUtils.isEmpty(packageName)) {
837 getTelecomService().clearAccounts(packageName);
838 }
839 } catch (RemoteException e) {
Nancy Chen5cf27842015-01-24 23:30:27 -0800840 Log.e(TAG, "Error calling ITelecomService#clearAccountsForPackage", e);
Anthony Lee67279262014-10-27 11:28:40 -0700841 }
842 }
843
Yorke Lee1011f482015-04-23 15:58:27 -0700844
Anthony Lee67279262014-10-27 11:28:40 -0700845 /**
Yorke Lee1011f482015-04-23 15:58:27 -0700846 * @deprecated - Use {@link TelecomManager#getDefaultDialerPackage} to directly access
847 * the default dialer's package name instead.
Ihab Awad807fe0a2014-07-09 12:30:52 -0700848 * @hide
849 */
Santos Cordon6c7a3882014-06-25 15:30:08 -0700850 @SystemApi
851 public ComponentName getDefaultPhoneApp() {
852 try {
Santos Cordon9eb45932014-06-27 12:28:43 -0700853 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -0700854 return getTelecomService().getDefaultPhoneApp();
Santos Cordon9eb45932014-06-27 12:28:43 -0700855 }
Santos Cordon6c7a3882014-06-25 15:30:08 -0700856 } catch (RemoteException e) {
857 Log.e(TAG, "RemoteException attempting to get the default phone app.", e);
858 }
859 return null;
860 }
861
Santos Cordon9eb45932014-06-27 12:28:43 -0700862 /**
Yorke Lee1011f482015-04-23 15:58:27 -0700863 * Used to determine the currently selected default dialer package.
864 *
865 * @return package name for the default dialer package or null if no package has been
866 * selected as the default dialer.
867 */
868 public String getDefaultDialerPackage() {
869 try {
870 if (isServiceConnected()) {
871 return getTelecomService().getDefaultDialerPackage();
872 }
873 } catch (RemoteException e) {
874 Log.e(TAG, "RemoteException attempting to get the default dialer package name.", e);
875 }
876 return null;
877 }
878
879 /**
Yorke Lee107c4ce2015-06-15 12:08:24 -0700880 * Used to set the default dialer package.
881 *
882 * @param packageName to set the default dialer to..
883 *
884 * @result {@code true} if the default dialer was successfully changed, {@code false} if
885 * the specified package does not correspond to an installed dialer, or is already
886 * the default dialer.
887 *
888 * Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
889 * Requires permission: {@link android.Manifest.permission#WRITE_SECURE_SETTINGS}
890 *
891 * @hide
892 */
893 public boolean setDefaultDialer(String packageName) {
894 try {
895 if (isServiceConnected()) {
896 return getTelecomService().setDefaultDialer(packageName);
897 }
898 } catch (RemoteException e) {
899 Log.e(TAG, "RemoteException attempting to set the default dialer.", e);
900 }
901 return false;
902 }
903
904 /**
Yorke Lee1011f482015-04-23 15:58:27 -0700905 * Used to determine the dialer package that is preloaded on the system partition.
906 *
907 * @return package name for the system dialer package or null if no system dialer is preloaded.
908 * @hide
909 */
910 public String getSystemDialerPackage() {
911 try {
912 if (isServiceConnected()) {
913 return getTelecomService().getSystemDialerPackage();
914 }
915 } catch (RemoteException e) {
916 Log.e(TAG, "RemoteException attempting to get the system dialer package name.", e);
917 }
918 return null;
919 }
920
921 /**
Nancy Chen443e5012014-10-15 15:48:21 -0700922 * Return whether a given phone number is the configured voicemail number for a
923 * particular phone account.
924 *
Yorke Leec61d13662015-09-21 17:25:25 -0700925 * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
926 *
Nancy Chen443e5012014-10-15 15:48:21 -0700927 * @param accountHandle The handle for the account to check the voicemail number against
928 * @param number The number to look up.
Nancy Chen443e5012014-10-15 15:48:21 -0700929 */
Yorke Leec61d13662015-09-21 17:25:25 -0700930 @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)
Nancy Chen443e5012014-10-15 15:48:21 -0700931 public boolean isVoiceMailNumber(PhoneAccountHandle accountHandle, String number) {
932 try {
933 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -0700934 return getTelecomService().isVoiceMailNumber(accountHandle, number,
935 mContext.getOpPackageName());
Nancy Chen443e5012014-10-15 15:48:21 -0700936 }
937 } catch (RemoteException e) {
Nancy Chen5cf27842015-01-24 23:30:27 -0800938 Log.e(TAG, "RemoteException calling ITelecomService#isVoiceMailNumber.", e);
Nancy Chen443e5012014-10-15 15:48:21 -0700939 }
940 return false;
941 }
942
943 /**
Yorke Lee49e2d462015-04-15 16:14:22 -0700944 * Return the voicemail number for a given phone account.
Nancy Chen8c066f7c2014-12-03 15:18:08 -0800945 *
Yorke Leec61d13662015-09-21 17:25:25 -0700946 * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
947 *
Yorke Lee49e2d462015-04-15 16:14:22 -0700948 * @param accountHandle The handle for the phone account.
949 * @return The voicemail number for the phone account, and {@code null} if one has not been
950 * configured.
Nancy Chen8c066f7c2014-12-03 15:18:08 -0800951 */
Yorke Leec61d13662015-09-21 17:25:25 -0700952 @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)
Yorke Lee49e2d462015-04-15 16:14:22 -0700953 public String getVoiceMailNumber(PhoneAccountHandle accountHandle) {
Nancy Chen8c066f7c2014-12-03 15:18:08 -0800954 try {
955 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -0700956 return getTelecomService().getVoiceMailNumber(accountHandle,
957 mContext.getOpPackageName());
Nancy Chen8c066f7c2014-12-03 15:18:08 -0800958 }
959 } catch (RemoteException e) {
Nancy Chen5cf27842015-01-24 23:30:27 -0800960 Log.e(TAG, "RemoteException calling ITelecomService#hasVoiceMailNumber.", e);
Nancy Chen8c066f7c2014-12-03 15:18:08 -0800961 }
Yorke Lee49e2d462015-04-15 16:14:22 -0700962 return null;
Nancy Chen8c066f7c2014-12-03 15:18:08 -0800963 }
964
965 /**
Nancy Chen5cf27842015-01-24 23:30:27 -0800966 * Return the line 1 phone number for given phone account.
967 *
Yorke Leec61d13662015-09-21 17:25:25 -0700968 * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
969 *
Nancy Chen5cf27842015-01-24 23:30:27 -0800970 * @param accountHandle The handle for the account retrieve a number for.
971 * @return A string representation of the line 1 phone number.
Nancy Chen5cf27842015-01-24 23:30:27 -0800972 */
Yorke Leec61d13662015-09-21 17:25:25 -0700973 @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)
Nancy Chen5cf27842015-01-24 23:30:27 -0800974 public String getLine1Number(PhoneAccountHandle accountHandle) {
975 try {
976 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -0700977 return getTelecomService().getLine1Number(accountHandle,
978 mContext.getOpPackageName());
Nancy Chen5cf27842015-01-24 23:30:27 -0800979 }
980 } catch (RemoteException e) {
981 Log.e(TAG, "RemoteException calling ITelecomService#getLine1Number.", e);
982 }
983 return null;
984 }
985
986 /**
Santos Cordon9eb45932014-06-27 12:28:43 -0700987 * Returns whether there is an ongoing phone call (can be in dialing, ringing, active or holding
988 * states).
Nancy Chen0eb1e402014-08-21 22:52:29 -0700989 * <p>
990 * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
991 * </p>
Santos Cordon9eb45932014-06-27 12:28:43 -0700992 */
Yorke Leec61d13662015-09-21 17:25:25 -0700993 @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)
Nancy Chen0eb1e402014-08-21 22:52:29 -0700994 public boolean isInCall() {
Santos Cordon9eb45932014-06-27 12:28:43 -0700995 try {
996 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -0700997 return getTelecomService().isInCall(mContext.getOpPackageName());
Santos Cordon9eb45932014-06-27 12:28:43 -0700998 }
999 } catch (RemoteException e) {
Yorke Lee2ae312e2014-09-12 17:58:48 -07001000 Log.e(TAG, "RemoteException calling isInCall().", e);
Santos Cordon9eb45932014-06-27 12:28:43 -07001001 }
1002 return false;
1003 }
1004
1005 /**
Yorke Lee2ae312e2014-09-12 17:58:48 -07001006 * Returns one of the following constants that represents the current state of Telecom:
1007 *
1008 * {@link TelephonyManager#CALL_STATE_RINGING}
1009 * {@link TelephonyManager#CALL_STATE_OFFHOOK}
1010 * {@link TelephonyManager#CALL_STATE_IDLE}
Yorke Lee7c72c2d2014-10-28 14:12:02 -07001011 *
1012 * Note that this API does not require the
1013 * {@link android.Manifest.permission#READ_PHONE_STATE} permission. This is intentional, to
1014 * preserve the behavior of {@link TelephonyManager#getCallState()}, which also did not require
1015 * the permission.
Yorke Lee2ae312e2014-09-12 17:58:48 -07001016 * @hide
1017 */
1018 @SystemApi
1019 public int getCallState() {
1020 try {
1021 if (isServiceConnected()) {
1022 return getTelecomService().getCallState();
1023 }
1024 } catch (RemoteException e) {
1025 Log.d(TAG, "RemoteException calling getCallState().", e);
1026 }
1027 return TelephonyManager.CALL_STATE_IDLE;
1028 }
1029
1030 /**
Santos Cordon9eb45932014-06-27 12:28:43 -07001031 * Returns whether there currently exists is a ringing incoming-call.
1032 *
1033 * @hide
1034 */
1035 @SystemApi
1036 public boolean isRinging() {
1037 try {
1038 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -07001039 return getTelecomService().isRinging(mContext.getOpPackageName());
Santos Cordon9eb45932014-06-27 12:28:43 -07001040 }
1041 } catch (RemoteException e) {
1042 Log.e(TAG, "RemoteException attempting to get ringing state of phone app.", e);
1043 }
1044 return false;
1045 }
1046
1047 /**
Santos Cordon96efb482014-07-19 14:57:05 -07001048 * Ends an ongoing call.
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001049 * TODO: L-release - need to convert all invocations of ITelecomService#endCall to use this
Santos Cordon96efb482014-07-19 14:57:05 -07001050 * method (clockwork & gearhead).
Santos Cordon9eb45932014-06-27 12:28:43 -07001051 * @hide
1052 */
1053 @SystemApi
1054 public boolean endCall() {
1055 try {
1056 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001057 return getTelecomService().endCall();
Santos Cordon9eb45932014-06-27 12:28:43 -07001058 }
1059 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001060 Log.e(TAG, "Error calling ITelecomService#endCall", e);
Santos Cordon9eb45932014-06-27 12:28:43 -07001061 }
1062 return false;
1063 }
1064
1065 /**
1066 * If there is a ringing incoming call, this method accepts the call on behalf of the user.
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001067 * TODO: L-release - need to convert all invocation of ITelecmmService#answerRingingCall to use
Santos Cordon96efb482014-07-19 14:57:05 -07001068 * this method (clockwork & gearhead).
Tyler Gunn6676bb52015-10-23 14:39:49 -07001069 * If the incoming call is a video call, the call will be answered with the same video state as
1070 * the incoming call requests. This means, for example, that an incoming call requesting
1071 * {@link VideoProfile#STATE_BIDIRECTIONAL} will be answered, accepting that state.
Santos Cordon9eb45932014-06-27 12:28:43 -07001072 * @hide
1073 */
1074 @SystemApi
1075 public void acceptRingingCall() {
1076 try {
1077 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001078 getTelecomService().acceptRingingCall();
Santos Cordon9eb45932014-06-27 12:28:43 -07001079 }
1080 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001081 Log.e(TAG, "Error calling ITelecomService#acceptRingingCall", e);
Santos Cordon9eb45932014-06-27 12:28:43 -07001082 }
1083 }
1084
1085 /**
Tyler Gunn6676bb52015-10-23 14:39:49 -07001086 * If there is a ringing incoming call, this method accepts the call on behalf of the user,
1087 * with the specified video state.
1088 *
1089 * @param videoState The desired video state to answer the call with.
1090 * @hide
1091 */
1092 @SystemApi
1093 public void acceptRingingCall(int videoState) {
1094 try {
1095 if (isServiceConnected()) {
1096 getTelecomService().acceptRingingCallWithVideoState(videoState);
1097 }
1098 } catch (RemoteException e) {
1099 Log.e(TAG, "Error calling ITelecomService#acceptRingingCallWithVideoState", e);
1100 }
1101 }
1102
1103 /**
Santos Cordon9eb45932014-06-27 12:28:43 -07001104 * Silences the ringer if a ringing call exists.
Yorke Leec61d13662015-09-21 17:25:25 -07001105 *
1106 * Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
Santos Cordon9eb45932014-06-27 12:28:43 -07001107 */
Yorke Leec61d13662015-09-21 17:25:25 -07001108 @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
Santos Cordon9eb45932014-06-27 12:28:43 -07001109 public void silenceRinger() {
1110 try {
1111 if (isServiceConnected()) {
Yorke Leef1a349b2015-04-29 16:16:50 -07001112 getTelecomService().silenceRinger(mContext.getOpPackageName());
Santos Cordon9eb45932014-06-27 12:28:43 -07001113 }
1114 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001115 Log.e(TAG, "Error calling ITelecomService#silenceRinger", e);
Santos Cordon9eb45932014-06-27 12:28:43 -07001116 }
1117 }
1118
Sailesh Nepal001bbbb2014-07-15 14:40:39 -07001119 /**
1120 * Returns whether TTY is supported on this device.
1121 *
1122 * @hide
1123 */
1124 @SystemApi
1125 public boolean isTtySupported() {
1126 try {
1127 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -07001128 return getTelecomService().isTtySupported(mContext.getOpPackageName());
Sailesh Nepal001bbbb2014-07-15 14:40:39 -07001129 }
1130 } catch (RemoteException e) {
1131 Log.e(TAG, "RemoteException attempting to get TTY supported state.", e);
1132 }
1133 return false;
1134 }
1135
1136 /**
1137 * Returns the current TTY mode of the device. For TTY to be on the user must enable it in
Santos Cordon96efb482014-07-19 14:57:05 -07001138 * settings and have a wired headset plugged in.
1139 * Valid modes are:
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001140 * - {@link TelecomManager#TTY_MODE_OFF}
1141 * - {@link TelecomManager#TTY_MODE_FULL}
1142 * - {@link TelecomManager#TTY_MODE_HCO}
1143 * - {@link TelecomManager#TTY_MODE_VCO}
Sailesh Nepal001bbbb2014-07-15 14:40:39 -07001144 * @hide
1145 */
1146 public int getCurrentTtyMode() {
1147 try {
1148 if (isServiceConnected()) {
Svet Ganov16a16892015-04-16 10:32:04 -07001149 return getTelecomService().getCurrentTtyMode(mContext.getOpPackageName());
Sailesh Nepal001bbbb2014-07-15 14:40:39 -07001150 }
1151 } catch (RemoteException e) {
1152 Log.e(TAG, "RemoteException attempting to get the current TTY mode.", e);
1153 }
Evan Charlton10197192014-07-19 15:00:29 -07001154 return TTY_MODE_OFF;
Sailesh Nepal001bbbb2014-07-15 14:40:39 -07001155 }
1156
Santos Cordon96efb482014-07-19 14:57:05 -07001157 /**
1158 * Registers a new incoming call. A {@link ConnectionService} should invoke this method when it
1159 * has an incoming call. The specified {@link PhoneAccountHandle} must have been registered
Nancy Chen210ef032014-09-15 17:58:42 -07001160 * with {@link #registerPhoneAccount}. Once invoked, this method will cause the system to bind
1161 * to the {@link ConnectionService} associated with the {@link PhoneAccountHandle} and request
Santos Cordon96efb482014-07-19 14:57:05 -07001162 * additional information about the call (See
1163 * {@link ConnectionService#onCreateIncomingConnection}) before starting the incoming call UI.
1164 *
1165 * @param phoneAccount A {@link PhoneAccountHandle} registered with
1166 * {@link #registerPhoneAccount}.
1167 * @param extras A bundle that will be passed through to
1168 * {@link ConnectionService#onCreateIncomingConnection}.
1169 */
1170 public void addNewIncomingCall(PhoneAccountHandle phoneAccount, Bundle extras) {
1171 try {
1172 if (isServiceConnected()) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001173 getTelecomService().addNewIncomingCall(
Santos Cordon96efb482014-07-19 14:57:05 -07001174 phoneAccount, extras == null ? new Bundle() : extras);
1175 }
1176 } catch (RemoteException e) {
1177 Log.e(TAG, "RemoteException adding a new incoming call: " + phoneAccount, e);
1178 }
1179 }
1180
Nancy Chen0eb1e402014-08-21 22:52:29 -07001181 /**
Yorke Leec3cf9822014-10-02 09:38:39 -07001182 * Registers a new unknown call with Telecom. This can only be called by the system Telephony
1183 * service. This is invoked when Telephony detects a new unknown connection that was neither
1184 * a new incoming call, nor an user-initiated outgoing call.
1185 *
1186 * @param phoneAccount A {@link PhoneAccountHandle} registered with
1187 * {@link #registerPhoneAccount}.
1188 * @param extras A bundle that will be passed through to
1189 * {@link ConnectionService#onCreateIncomingConnection}.
1190 * @hide
1191 */
1192 @SystemApi
1193 public void addNewUnknownCall(PhoneAccountHandle phoneAccount, Bundle extras) {
1194 try {
1195 if (isServiceConnected()) {
1196 getTelecomService().addNewUnknownCall(
1197 phoneAccount, extras == null ? new Bundle() : extras);
1198 }
1199 } catch (RemoteException e) {
1200 Log.e(TAG, "RemoteException adding a new unknown call: " + phoneAccount, e);
1201 }
1202 }
1203
1204 /**
Nancy Chen0eb1e402014-08-21 22:52:29 -07001205 * Processes the specified dial string as an MMI code.
1206 * MMI codes are any sequence of characters entered into the dialpad that contain a "*" or "#".
1207 * Some of these sequences launch special behavior through handled by Telephony.
Nancy Chen95e8a672014-10-16 18:38:21 -07001208 * This method uses the default subscription.
Nancy Chen0eb1e402014-08-21 22:52:29 -07001209 * <p>
1210 * Requires that the method-caller be set as the system dialer app.
1211 * </p>
1212 *
Yorke Leec61d13662015-09-21 17:25:25 -07001213 * Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
1214 *
Nancy Chen0eb1e402014-08-21 22:52:29 -07001215 * @param dialString The digits to dial.
1216 * @return True if the digits were processed as an MMI code, false otherwise.
1217 */
Yorke Leec61d13662015-09-21 17:25:25 -07001218 @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
Nancy Chen0eb1e402014-08-21 22:52:29 -07001219 public boolean handleMmi(String dialString) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001220 ITelecomService service = getTelecomService();
Nancy Chen0eb1e402014-08-21 22:52:29 -07001221 if (service != null) {
1222 try {
Yorke Leef1a349b2015-04-29 16:16:50 -07001223 return service.handlePinMmi(dialString, mContext.getOpPackageName());
Nancy Chen0eb1e402014-08-21 22:52:29 -07001224 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001225 Log.e(TAG, "Error calling ITelecomService#handlePinMmi", e);
Nancy Chen0eb1e402014-08-21 22:52:29 -07001226 }
1227 }
1228 return false;
1229 }
1230
1231 /**
Nancy Chen95e8a672014-10-16 18:38:21 -07001232 * Processes the specified dial string as an MMI code.
1233 * MMI codes are any sequence of characters entered into the dialpad that contain a "*" or "#".
1234 * Some of these sequences launch special behavior through handled by Telephony.
1235 * <p>
1236 * Requires that the method-caller be set as the system dialer app.
1237 * </p>
1238 *
Yorke Leec61d13662015-09-21 17:25:25 -07001239 * Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
1240 *
Nancy Chen95e8a672014-10-16 18:38:21 -07001241 * @param accountHandle The handle for the account the MMI code should apply to.
1242 * @param dialString The digits to dial.
1243 * @return True if the digits were processed as an MMI code, false otherwise.
Nancy Chen95e8a672014-10-16 18:38:21 -07001244 */
Yorke Leec61d13662015-09-21 17:25:25 -07001245 @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
Yorke Lee06044272015-04-14 15:16:59 -07001246 public boolean handleMmi(String dialString, PhoneAccountHandle accountHandle) {
Nancy Chen95e8a672014-10-16 18:38:21 -07001247 ITelecomService service = getTelecomService();
1248 if (service != null) {
1249 try {
Yorke Leef1a349b2015-04-29 16:16:50 -07001250 return service.handlePinMmiForPhoneAccount(accountHandle, dialString,
1251 mContext.getOpPackageName());
Nancy Chen95e8a672014-10-16 18:38:21 -07001252 } catch (RemoteException e) {
1253 Log.e(TAG, "Error calling ITelecomService#handlePinMmi", e);
1254 }
1255 }
1256 return false;
1257 }
1258
1259 /**
Yorke Leec61d13662015-09-21 17:25:25 -07001260 * Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
1261 *
Nancy Chenb2299c12014-10-29 18:22:11 -07001262 * @param accountHandle The handle for the account to derive an adn query URI for or
1263 * {@code null} to return a URI which will use the default account.
1264 * @return The URI (with the content:// scheme) specific to the specified {@link PhoneAccount}
1265 * for the the content retrieve.
1266 */
Yorke Leec61d13662015-09-21 17:25:25 -07001267 @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
Nancy Chenb2299c12014-10-29 18:22:11 -07001268 public Uri getAdnUriForPhoneAccount(PhoneAccountHandle accountHandle) {
1269 ITelecomService service = getTelecomService();
1270 if (service != null && accountHandle != null) {
1271 try {
Yorke Leef1a349b2015-04-29 16:16:50 -07001272 return service.getAdnUriForPhoneAccount(accountHandle, mContext.getOpPackageName());
Nancy Chenb2299c12014-10-29 18:22:11 -07001273 } catch (RemoteException e) {
1274 Log.e(TAG, "Error calling ITelecomService#getAdnUriForPhoneAccount", e);
1275 }
1276 }
1277 return Uri.parse("content://icc/adn");
1278 }
1279
1280 /**
Nancy Chen0eb1e402014-08-21 22:52:29 -07001281 * Removes the missed-call notification if one is present.
1282 * <p>
1283 * Requires that the method-caller be set as the system dialer app.
1284 * </p>
Yorke Leec61d13662015-09-21 17:25:25 -07001285 *
1286 * Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
Nancy Chen0eb1e402014-08-21 22:52:29 -07001287 */
Yorke Leec61d13662015-09-21 17:25:25 -07001288 @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
Nancy Chen0eb1e402014-08-21 22:52:29 -07001289 public void cancelMissedCallsNotification() {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001290 ITelecomService service = getTelecomService();
Nancy Chen0eb1e402014-08-21 22:52:29 -07001291 if (service != null) {
1292 try {
Yorke Leef1a349b2015-04-29 16:16:50 -07001293 service.cancelMissedCallsNotification(mContext.getOpPackageName());
Nancy Chen0eb1e402014-08-21 22:52:29 -07001294 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001295 Log.e(TAG, "Error calling ITelecomService#cancelMissedCallsNotification", e);
Nancy Chen0eb1e402014-08-21 22:52:29 -07001296 }
1297 }
1298 }
1299
1300 /**
1301 * Brings the in-call screen to the foreground if there is an ongoing call. If there is
1302 * currently no ongoing call, then this method does nothing.
1303 * <p>
1304 * Requires that the method-caller be set as the system dialer app or have the
1305 * {@link android.Manifest.permission#READ_PHONE_STATE} permission.
1306 * </p>
1307 *
1308 * @param showDialpad Brings up the in-call dialpad as part of showing the in-call screen.
1309 */
Yorke Leec61d13662015-09-21 17:25:25 -07001310 @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)
Nancy Chen0eb1e402014-08-21 22:52:29 -07001311 public void showInCallScreen(boolean showDialpad) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001312 ITelecomService service = getTelecomService();
Nancy Chen0eb1e402014-08-21 22:52:29 -07001313 if (service != null) {
1314 try {
Svet Ganov16a16892015-04-16 10:32:04 -07001315 service.showInCallScreen(showDialpad, mContext.getOpPackageName());
Nancy Chen0eb1e402014-08-21 22:52:29 -07001316 } catch (RemoteException e) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001317 Log.e(TAG, "Error calling ITelecomService#showCallScreen", e);
Nancy Chen0eb1e402014-08-21 22:52:29 -07001318 }
1319 }
1320 }
1321
Yorke Lee3e56ba12015-04-23 12:32:36 -07001322 /**
1323 * Places a new outgoing call to the provided address using the system telecom service with
1324 * the specified extras.
1325 *
1326 * This method is equivalent to placing an outgoing call using {@link Intent#ACTION_CALL},
1327 * except that the outgoing call will always be sent via the system telecom service. If
1328 * method-caller is either the user selected default dialer app or preloaded system dialer
1329 * app, then emergency calls will also be allowed.
1330 *
1331 * Requires permission: {@link android.Manifest.permission#CALL_PHONE}
1332 *
1333 * Usage example:
1334 * <pre>
1335 * Uri uri = Uri.fromParts("tel", "12345", null);
1336 * Bundle extras = new Bundle();
1337 * extras.putBoolean(TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, true);
1338 * telecomManager.placeCall(uri, extras);
1339 * </pre>
1340 *
Santos Cordon7a060d52015-06-19 14:52:04 -07001341 * The following keys are supported in the supplied extras.
1342 * <ul>
1343 * <li>{@link #EXTRA_OUTGOING_CALL_EXTRAS}</li>
1344 * <li>{@link #EXTRA_PHONE_ACCOUNT_HANDLE}</li>
1345 * <li>{@link #EXTRA_START_CALL_WITH_SPEAKERPHONE}</li>
1346 * <li>{@link #EXTRA_START_CALL_WITH_VIDEO_STATE}</li>
1347 * </ul>
1348 *
Yorke Lee3e56ba12015-04-23 12:32:36 -07001349 * @param address The address to make the call to.
1350 * @param extras Bundle of extras to use with the call.
1351 */
Yorke Leec61d13662015-09-21 17:25:25 -07001352 @RequiresPermission(android.Manifest.permission.CALL_PHONE)
Yorke Lee3e56ba12015-04-23 12:32:36 -07001353 public void placeCall(Uri address, Bundle extras) {
1354 ITelecomService service = getTelecomService();
1355 if (service != null) {
Yorke Leea5d5c1d2015-05-05 16:25:55 -07001356 if (address == null) {
1357 Log.w(TAG, "Cannot place call to empty address.");
1358 }
Yorke Lee3e56ba12015-04-23 12:32:36 -07001359 try {
Yorke Leea5d5c1d2015-05-05 16:25:55 -07001360 service.placeCall(address, extras == null ? new Bundle() : extras,
1361 mContext.getOpPackageName());
Yorke Lee3e56ba12015-04-23 12:32:36 -07001362 } catch (RemoteException e) {
1363 Log.e(TAG, "Error calling ITelecomService#placeCall", e);
1364 }
1365 }
1366 }
1367
Santos Cordon91371dc02015-05-08 13:52:09 -07001368 /**
1369 * Enables and disables specified phone account.
1370 *
1371 * @param handle Handle to the phone account.
1372 * @param isEnabled Enable state of the phone account.
1373 * @hide
1374 */
1375 @SystemApi
1376 public void enablePhoneAccount(PhoneAccountHandle handle, boolean isEnabled) {
1377 ITelecomService service = getTelecomService();
1378 if (service != null) {
1379 try {
1380 service.enablePhoneAccount(handle, isEnabled);
1381 } catch (RemoteException e) {
1382 Log.e(TAG, "Error enablePhoneAbbount", e);
1383 }
1384 }
1385 }
1386
Hall Liu0464b9b2016-01-12 15:32:58 -08001387 /**
1388 * Dumps telecom analytics for uploading.
1389 *
1390 * @return
1391 * @hide
1392 */
1393 @SystemApi
1394 @RequiresPermission(Manifest.permission.DUMP)
1395 public List<ParcelableCallAnalytics> dumpAnalytics() {
1396 ITelecomService service = getTelecomService();
1397 List<ParcelableCallAnalytics> result = null;
1398 if (service != null) {
1399 try {
1400 result = service.dumpCallAnalytics();
1401 } catch (RemoteException e) {
1402 Log.e(TAG, "Error dumping call analytics", e);
1403 }
1404 }
1405 return result;
1406 }
1407
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001408 private ITelecomService getTelecomService() {
Hall Liue1bc2ec2015-10-09 15:58:37 -07001409 if (mTelecomServiceOverride != null) {
1410 return mTelecomServiceOverride;
1411 }
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001412 return ITelecomService.Stub.asInterface(ServiceManager.getService(Context.TELECOM_SERVICE));
Santos Cordon6c7a3882014-06-25 15:30:08 -07001413 }
Santos Cordon9eb45932014-06-27 12:28:43 -07001414
1415 private boolean isServiceConnected() {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001416 boolean isConnected = getTelecomService() != null;
Santos Cordon9eb45932014-06-27 12:28:43 -07001417 if (!isConnected) {
Tyler Gunnef9f6f92014-09-12 22:16:17 -07001418 Log.w(TAG, "Telecom Service not found.");
Santos Cordon9eb45932014-06-27 12:28:43 -07001419 }
1420 return isConnected;
1421 }
Evan Charlton235c1592014-09-05 15:41:23 +00001422}