1 /*
2  * Copyright (C) 2014 The Android Open Source Project
3  *
4  * 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
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * 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.
13  */
14 
15 package android.telecom;
16 
17 import android.annotation.SystemApi;
18 import android.content.ComponentName;
19 import android.content.Context;
20 import android.content.Intent;
21 import android.net.Uri;
22 import android.os.Bundle;
23 import android.os.RemoteException;
24 import android.os.ServiceManager;
25 import android.telephony.TelephonyManager;
26 import android.text.TextUtils;
27 import android.util.Log;
28 
29 import com.android.internal.telecom.ITelecomService;
30 
31 import java.util.ArrayList;
32 import java.util.Collections;
33 import java.util.List;
34 
35 /**
36  * Provides access to information about active calls and registration/call-management functionality.
37  * Apps can use methods in this class to determine the current call state.
38  * <p>
39  * Apps do not instantiate this class directly; instead, they retrieve a reference to an instance
40  * through {@link Context#getSystemService Context.getSystemService(Context.TELECOM_SERVICE)}.
41  * <p>
42  * Note that access to some telecom information is permission-protected. Your app cannot access the
43  * protected information or gain access to protected functionality unless it has the appropriate
44  * permissions declared in its manifest file. Where permissions apply, they are noted in the method
45  * descriptions.
46  */
47 public class TelecomManager {
48 
49     /**
50      * Activity action: Starts the UI for handing an incoming call. This intent starts the in-call
51      * UI by notifying the Telecom system that an incoming call exists for a specific call service
52      * (see {@link android.telecom.ConnectionService}). Telecom reads the Intent extras to find
53      * and bind to the appropriate {@link android.telecom.ConnectionService} which Telecom will
54      * ultimately use to control and get information about the call.
55      * <p>
56      * Input: get*Extra field {@link #EXTRA_PHONE_ACCOUNT_HANDLE} contains the component name of the
57      * {@link android.telecom.ConnectionService} that Telecom should bind to. Telecom will then
58      * ask the connection service for more information about the call prior to showing any UI.
59      */
60     public static final String ACTION_INCOMING_CALL = "android.telecom.action.INCOMING_CALL";
61 
62     /**
63      * Similar to {@link #ACTION_INCOMING_CALL}, but is used only by Telephony to add a new
64      * sim-initiated MO call for carrier testing.
65      * @hide
66      */
67     public static final String ACTION_NEW_UNKNOWN_CALL = "android.telecom.action.NEW_UNKNOWN_CALL";
68 
69     /**
70      * An {@link android.content.Intent} action sent by the telecom framework to start a
71      * configuration dialog for a registered {@link PhoneAccount}. There is no default dialog
72      * and each app that registers a {@link PhoneAccount} should provide one if desired.
73      * <p>
74      * A user can access the list of enabled {@link android.telecom.PhoneAccount}s through the Phone
75      * app's settings menu. For each entry, the settings app will add a click action. When
76      * triggered, the click-action will start this intent along with the extra
77      * {@link #EXTRA_PHONE_ACCOUNT_HANDLE} to indicate the {@link PhoneAccount} to configure. If the
78      * {@link PhoneAccount} package does not register an {@link android.app.Activity} for this
79      * intent, then it will not be sent.
80      */
81     public static final String ACTION_CONFIGURE_PHONE_ACCOUNT =
82             "android.telecom.action.CONFIGURE_PHONE_ACCOUNT";
83 
84     /**
85      * The {@link android.content.Intent} action used to show the call accessibility settings page.
86      */
87     public static final String ACTION_SHOW_CALL_ACCESSIBILITY_SETTINGS =
88             "android.telecom.action.SHOW_CALL_ACCESSIBILITY_SETTINGS";
89 
90     /**
91      * The {@link android.content.Intent} action used to show the call settings page.
92      */
93     public static final String ACTION_SHOW_CALL_SETTINGS =
94             "android.telecom.action.SHOW_CALL_SETTINGS";
95 
96     /**
97      * The {@link android.content.Intent} action used to show the respond via SMS settings page.
98      */
99     public static final String ACTION_SHOW_RESPOND_VIA_SMS_SETTINGS =
100             "android.telecom.action.SHOW_RESPOND_VIA_SMS_SETTINGS";
101 
102     /**
103      * The {@link android.content.Intent} action used to show the settings page used to configure
104      * {@link PhoneAccount} preferences.
105      */
106     public static final String ACTION_CHANGE_PHONE_ACCOUNTS =
107             "android.telecom.action.CHANGE_PHONE_ACCOUNTS";
108 
109     /**
110      * The {@link android.content.Intent} action used indicate that a new phone account was
111      * just registered.
112      * @hide
113      */
114     @SystemApi
115     public static final String ACTION_PHONE_ACCOUNT_REGISTERED =
116             "android.telecom.action.PHONE_ACCOUNT_REGISTERED";
117 
118     /**
119      * Activity action: Shows a dialog asking the user whether or not they want to replace the
120      * current default Dialer with the one specified in
121      * {@link #EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME}.
122      *
123      * Usage example:
124      * <pre>
125      * Intent intent = new Intent(TelecomManager.ACTION_CHANGE_DEFAULT_DIALER);
126      * intent.putExtra(TelecomManager.EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME,
127      *         getActivity().getPackageName());
128      * startActivity(intent);
129      * </pre>
130      */
131     public static final String ACTION_CHANGE_DEFAULT_DIALER =
132             "android.telecom.action.CHANGE_DEFAULT_DIALER";
133 
134     /**
135      * Broadcast intent action indicating that the current default dialer has changed.
136      * The string extra {@link #EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME} will contain the
137      * name of the package that the default dialer was changed to.
138      *
139      * @see #EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME
140      */
141     public static final String ACTION_DEFAULT_DIALER_CHANGED =
142             "android.telecom.action.DEFAULT_DIALER_CHANGED";
143 
144     /**
145      * Extra value used to provide the package name for {@link #ACTION_CHANGE_DEFAULT_DIALER}.
146      */
147     public static final String EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME =
148             "android.telecom.extra.CHANGE_DEFAULT_DIALER_PACKAGE_NAME";
149 
150     /**
151      * Optional extra for {@link android.content.Intent#ACTION_CALL} containing a boolean that
152      * determines whether the speakerphone should be automatically turned on for an outgoing call.
153      */
154     public static final String EXTRA_START_CALL_WITH_SPEAKERPHONE =
155             "android.telecom.extra.START_CALL_WITH_SPEAKERPHONE";
156 
157     /**
158      * Optional extra for {@link android.content.Intent#ACTION_CALL} containing an integer that
159      * determines the desired video state for an outgoing call.
160      * Valid options:
161      * {@link VideoProfile#STATE_AUDIO_ONLY},
162      * {@link VideoProfile#STATE_BIDIRECTIONAL},
163      * {@link VideoProfile#STATE_RX_ENABLED},
164      * {@link VideoProfile#STATE_TX_ENABLED}.
165      */
166     public static final String EXTRA_START_CALL_WITH_VIDEO_STATE =
167             "android.telecom.extra.START_CALL_WITH_VIDEO_STATE";
168 
169     /**
170      * The extra used with an {@link android.content.Intent#ACTION_CALL} and
171      * {@link android.content.Intent#ACTION_DIAL} {@code Intent} to specify a
172      * {@link PhoneAccountHandle} to use when making the call.
173      * <p class="note">
174      * Retrieve with {@link android.content.Intent#getParcelableExtra(String)}.
175      */
176     public static final String EXTRA_PHONE_ACCOUNT_HANDLE =
177             "android.telecom.extra.PHONE_ACCOUNT_HANDLE";
178 
179     /**
180      * Optional extra for {@link android.content.Intent#ACTION_CALL} containing a string call
181      * subject which will be associated with an outgoing call.  Should only be specified if the
182      * {@link PhoneAccount} supports the capability {@link PhoneAccount#CAPABILITY_CALL_SUBJECT}.
183      */
184     public static final String EXTRA_CALL_SUBJECT = "android.telecom.extra.CALL_SUBJECT";
185 
186     /**
187      * The extra used by a {@link ConnectionService} to provide the handle of the caller that
188      * has initiated a new incoming call.
189      */
190     public static final String EXTRA_INCOMING_CALL_ADDRESS =
191             "android.telecom.extra.INCOMING_CALL_ADDRESS";
192 
193     /**
194      * Optional extra for {@link #ACTION_INCOMING_CALL} containing a {@link Bundle} which contains
195      * metadata about the call. This {@link Bundle} will be returned to the
196      * {@link ConnectionService}.
197      */
198     public static final String EXTRA_INCOMING_CALL_EXTRAS =
199             "android.telecom.extra.INCOMING_CALL_EXTRAS";
200 
201     /**
202      * Optional extra for {@link android.content.Intent#ACTION_CALL} and
203      * {@link android.content.Intent#ACTION_DIAL} {@code Intent} containing a {@link Bundle}
204      * which contains metadata about the call. This {@link Bundle} will be saved into
205      * {@code Call.Details} and passed to the {@link ConnectionService} when placing the call.
206      */
207     public static final String EXTRA_OUTGOING_CALL_EXTRAS =
208             "android.telecom.extra.OUTGOING_CALL_EXTRAS";
209 
210     /**
211      * @hide
212      */
213     public static final String EXTRA_UNKNOWN_CALL_HANDLE =
214             "android.telecom.extra.UNKNOWN_CALL_HANDLE";
215 
216     /**
217      * Optional extra for {@link android.telephony.TelephonyManager#ACTION_PHONE_STATE_CHANGED}
218      * containing the disconnect code.
219      */
220     public static final String EXTRA_CALL_DISCONNECT_CAUSE =
221             "android.telecom.extra.CALL_DISCONNECT_CAUSE";
222 
223     /**
224      * Optional extra for {@link android.telephony.TelephonyManager#ACTION_PHONE_STATE_CHANGED}
225      * containing the disconnect message.
226      */
227     public static final String EXTRA_CALL_DISCONNECT_MESSAGE =
228             "android.telecom.extra.CALL_DISCONNECT_MESSAGE";
229 
230     /**
231      * Optional extra for {@link android.telephony.TelephonyManager#ACTION_PHONE_STATE_CHANGED}
232      * containing the component name of the associated connection service.
233      * @hide
234      */
235     @SystemApi
236     public static final String EXTRA_CONNECTION_SERVICE =
237             "android.telecom.extra.CONNECTION_SERVICE";
238 
239     /**
240      * An optional {@link android.content.Intent#ACTION_CALL} intent extra denoting the
241      * package name of the app specifying an alternative gateway for the call.
242      * The value is a string.
243      *
244      * (The following comment corresponds to the all GATEWAY_* extras)
245      * An app which sends the {@link android.content.Intent#ACTION_CALL} intent can specify an
246      * alternative address to dial which is different from the one specified and displayed to
247      * the user. This alternative address is referred to as the gateway address.
248      */
249     public static final String GATEWAY_PROVIDER_PACKAGE =
250             "android.telecom.extra.GATEWAY_PROVIDER_PACKAGE";
251 
252     /**
253      * An optional {@link android.content.Intent#ACTION_CALL} intent extra corresponding to the
254      * original address to dial for the call. This is used when an alternative gateway address is
255      * provided to recall the original address.
256      * The value is a {@link android.net.Uri}.
257      *
258      * (See {@link #GATEWAY_PROVIDER_PACKAGE} for details)
259      */
260     public static final String GATEWAY_ORIGINAL_ADDRESS =
261             "android.telecom.extra.GATEWAY_ORIGINAL_ADDRESS";
262 
263     /**
264      * The number which the party on the other side of the line will see (and use to return the
265      * call).
266      * <p>
267      * {@link ConnectionService}s which interact with {@link RemoteConnection}s should only populate
268      * this if the {@link android.telephony.TelephonyManager#getLine1Number()} value, as that is the
269      * user's expected caller ID.
270      */
271     public static final String EXTRA_CALL_BACK_NUMBER = "android.telecom.extra.CALL_BACK_NUMBER";
272 
273     /**
274      * A boolean meta-data value indicating whether an {@link InCallService} implements an
275      * in-call user interface. Dialer implementations (see {@link #getDefaultDialerPackage()}) which
276      * would also like to replace the in-call interface should set this meta-data to {@code true} in
277      * the manifest registration of their {@link InCallService}.
278      */
279     public static final String METADATA_IN_CALL_SERVICE_UI = "android.telecom.IN_CALL_SERVICE_UI";
280 
281     /**
282      * The dual tone multi-frequency signaling character sent to indicate the dialing system should
283      * pause for a predefined period.
284      */
285     public static final char DTMF_CHARACTER_PAUSE = ',';
286 
287     /**
288      * The dual-tone multi-frequency signaling character sent to indicate the dialing system should
289      * wait for user confirmation before proceeding.
290      */
291     public static final char DTMF_CHARACTER_WAIT = ';';
292 
293     /**
294      * TTY (teletypewriter) mode is off.
295      *
296      * @hide
297      */
298     public static final int TTY_MODE_OFF = 0;
299 
300     /**
301      * TTY (teletypewriter) mode is on. The speaker is off and the microphone is muted. The user
302      * will communicate with the remote party by sending and receiving text messages.
303      *
304      * @hide
305      */
306     public static final int TTY_MODE_FULL = 1;
307 
308     /**
309      * TTY (teletypewriter) mode is in hearing carryover mode (HCO). The microphone is muted but the
310      * speaker is on. The user will communicate with the remote party by sending text messages and
311      * hearing an audible reply.
312      *
313      * @hide
314      */
315     public static final int TTY_MODE_HCO = 2;
316 
317     /**
318      * TTY (teletypewriter) mode is in voice carryover mode (VCO). The speaker is off but the
319      * microphone is still on. User will communicate with the remote party by speaking and receiving
320      * text message replies.
321      *
322      * @hide
323      */
324     public static final int TTY_MODE_VCO = 3;
325 
326     /**
327      * Broadcast intent action indicating that the current TTY mode has changed. An intent extra
328      * provides this state as an int.
329      *
330      * @see #EXTRA_CURRENT_TTY_MODE
331      * @hide
332      */
333     public static final String ACTION_CURRENT_TTY_MODE_CHANGED =
334             "android.telecom.action.CURRENT_TTY_MODE_CHANGED";
335 
336     /**
337      * The lookup key for an int that indicates the current TTY mode.
338      * Valid modes are:
339      * - {@link #TTY_MODE_OFF}
340      * - {@link #TTY_MODE_FULL}
341      * - {@link #TTY_MODE_HCO}
342      * - {@link #TTY_MODE_VCO}
343      *
344      * @hide
345      */
346     public static final String EXTRA_CURRENT_TTY_MODE =
347             "android.telecom.intent.extra.CURRENT_TTY_MODE";
348 
349     /**
350      * Broadcast intent action indicating that the TTY preferred operating mode has changed. An
351      * intent extra provides the new mode as an int.
352      *
353      * @see #EXTRA_TTY_PREFERRED_MODE
354      * @hide
355      */
356     public static final String ACTION_TTY_PREFERRED_MODE_CHANGED =
357             "android.telecom.action.TTY_PREFERRED_MODE_CHANGED";
358 
359     /**
360      * The lookup key for an int that indicates preferred TTY mode. Valid modes are: -
361      * {@link #TTY_MODE_OFF} - {@link #TTY_MODE_FULL} - {@link #TTY_MODE_HCO} -
362      * {@link #TTY_MODE_VCO}
363      *
364      * @hide
365      */
366     public static final String EXTRA_TTY_PREFERRED_MODE =
367             "android.telecom.intent.extra.TTY_PREFERRED";
368 
369     /**
370      * The following 4 constants define how properties such as phone numbers and names are
371      * displayed to the user.
372      */
373 
374     /**
375      * Indicates that the address or number of a call is allowed to be displayed for caller ID.
376     */
377     public static final int PRESENTATION_ALLOWED = 1;
378 
379     /**
380      * Indicates that the address or number of a call is blocked by the other party.
381      */
382     public static final int PRESENTATION_RESTRICTED = 2;
383 
384     /**
385      * Indicates that the address or number of a call is not specified or known by the carrier.
386      */
387     public static final int PRESENTATION_UNKNOWN = 3;
388 
389     /**
390      * Indicates that the address or number of a call belongs to a pay phone.
391      */
392     public static final int PRESENTATION_PAYPHONE = 4;
393 
394     private static final String TAG = "TelecomManager";
395 
396     private final Context mContext;
397 
398     /**
399      * @hide
400      */
from(Context context)401     public static TelecomManager from(Context context) {
402         return (TelecomManager) context.getSystemService(Context.TELECOM_SERVICE);
403     }
404 
405     /**
406      * @hide
407      */
TelecomManager(Context context)408     public TelecomManager(Context context) {
409         Context appContext = context.getApplicationContext();
410         if (appContext != null) {
411             mContext = appContext;
412         } else {
413             mContext = context;
414         }
415     }
416 
417     /**
418      * Return the {@link PhoneAccount} which will be used to place outgoing calls to addresses with
419      * the specified {@code uriScheme}. This {@link PhoneAccount} will always be a member of the
420      * list which is returned from invoking {@link #getCallCapablePhoneAccounts()}. The specific
421      * account returned depends on the following priorities:
422      * <ul>
423      * <li> If the user-selected default {@link PhoneAccount} supports the specified scheme, it will
424      * be returned.
425      * </li>
426      * <li> If there exists only one {@link PhoneAccount} that supports the specified scheme, it
427      * will be returned.
428      * </li>
429      * </ul>
430      * <p>
431      * If no {@link PhoneAccount} fits the criteria above, this method will return {@code null}.
432      *
433      * @param uriScheme The URI scheme.
434      * @return The {@link PhoneAccountHandle} corresponding to the account to be used.
435      */
getDefaultOutgoingPhoneAccount(String uriScheme)436     public PhoneAccountHandle getDefaultOutgoingPhoneAccount(String uriScheme) {
437         try {
438             if (isServiceConnected()) {
439                 return getTelecomService().getDefaultOutgoingPhoneAccount(uriScheme,
440                         mContext.getOpPackageName());
441             }
442         } catch (RemoteException e) {
443             Log.e(TAG, "Error calling ITelecomService#getDefaultOutgoingPhoneAccount", e);
444         }
445         return null;
446     }
447 
448     /**
449      * Return the {@link PhoneAccount} which is the user-chosen default for making outgoing phone
450      * calls. This {@code PhoneAccount} will always be a member of the list which is returned from
451      * calling {@link #getCallCapablePhoneAccounts()}
452      * <p>
453      * Apps must be prepared for this method to return {@code null}, indicating that there currently
454      * exists no user-chosen default {@code PhoneAccount}.
455      *
456      * @return The user outgoing phone account selected by the user.
457      * @hide
458      */
getUserSelectedOutgoingPhoneAccount()459     public PhoneAccountHandle getUserSelectedOutgoingPhoneAccount() {
460         try {
461             if (isServiceConnected()) {
462                 return getTelecomService().getUserSelectedOutgoingPhoneAccount();
463             }
464         } catch (RemoteException e) {
465             Log.e(TAG, "Error calling ITelecomService#getUserSelectedOutgoingPhoneAccount", e);
466         }
467         return null;
468     }
469 
470     /**
471      * Sets the user-chosen default for making outgoing phone calls.
472      * @hide
473      */
setUserSelectedOutgoingPhoneAccount(PhoneAccountHandle accountHandle)474     public void setUserSelectedOutgoingPhoneAccount(PhoneAccountHandle accountHandle) {
475         try {
476             if (isServiceConnected()) {
477                 getTelecomService().setUserSelectedOutgoingPhoneAccount(accountHandle);
478             }
479         } catch (RemoteException e) {
480             Log.e(TAG, "Error calling ITelecomService#setUserSelectedOutgoingPhoneAccount");
481         }
482     }
483 
484     /**
485      * Returns the current SIM call manager. Apps must be prepared for this method to return
486      * {@code null}, indicating that there currently exists no user-chosen default
487      * {@code PhoneAccount}.
488      *
489      * @return The phone account handle of the current sim call manager.
490      */
getSimCallManager()491     public PhoneAccountHandle getSimCallManager() {
492         try {
493             if (isServiceConnected()) {
494                 return getTelecomService().getSimCallManager();
495             }
496         } catch (RemoteException e) {
497             Log.e(TAG, "Error calling ITelecomService#getSimCallManager");
498         }
499         return null;
500     }
501 
502     /**
503      * Returns the current SIM call manager for the specified user. Apps must be prepared for this
504      * method to return {@code null}, indicating that there currently exists no user-chosen default
505      * {@code PhoneAccount}.
506      *
507      * @return The phone account handle of the current sim call manager.
508      *
509      * @hide
510      */
getSimCallManager(int userId)511     public PhoneAccountHandle getSimCallManager(int userId) {
512         try {
513             if (isServiceConnected()) {
514                 return getTelecomService().getSimCallManagerForUser(userId);
515             }
516         } catch (RemoteException e) {
517             Log.e(TAG, "Error calling ITelecomService#getSimCallManagerForUser");
518         }
519         return null;
520     }
521 
522     /**
523      * Returns the current connection manager. Apps must be prepared for this method to return
524      * {@code null}, indicating that there currently exists no user-chosen default
525      * {@code PhoneAccount}.
526      *
527      * @return The phone account handle of the current connection manager.
528      * @hide
529      */
530     @SystemApi
getConnectionManager()531     public PhoneAccountHandle getConnectionManager() {
532         return getSimCallManager();
533     }
534 
535     /**
536      * Returns a list of the {@link PhoneAccountHandle}s which can be used to make and receive phone
537      * calls which support the specified URI scheme.
538      * <P>
539      * For example, invoking with {@code "tel"} will find all {@link PhoneAccountHandle}s which
540      * support telephone calls (e.g. URIs such as {@code tel:555-555-1212}).  Invoking with
541      * {@code "sip"} will find all {@link PhoneAccountHandle}s which support SIP calls (e.g. URIs
542      * such as {@code sip:example@sipexample.com}).
543      *
544      * @param uriScheme The URI scheme.
545      * @return A list of {@code PhoneAccountHandle} objects supporting the URI scheme.
546      * @hide
547      */
548     @SystemApi
getPhoneAccountsSupportingScheme(String uriScheme)549     public List<PhoneAccountHandle> getPhoneAccountsSupportingScheme(String uriScheme) {
550         try {
551             if (isServiceConnected()) {
552                 return getTelecomService().getPhoneAccountsSupportingScheme(uriScheme,
553                         mContext.getOpPackageName());
554             }
555         } catch (RemoteException e) {
556             Log.e(TAG, "Error calling ITelecomService#getPhoneAccountsSupportingScheme", e);
557         }
558         return new ArrayList<>();
559     }
560 
561 
562     /**
563      * Returns a list of {@link PhoneAccountHandle}s which can be used to make and receive phone
564      * calls. The returned list includes only those accounts which have been explicitly enabled
565      * by the user.
566      *
567      * @see #EXTRA_PHONE_ACCOUNT_HANDLE
568      * @return A list of {@code PhoneAccountHandle} objects.
569      */
getCallCapablePhoneAccounts()570     public List<PhoneAccountHandle> getCallCapablePhoneAccounts() {
571         return getCallCapablePhoneAccounts(false);
572     }
573 
574     /**
575      * Returns a list of {@link PhoneAccountHandle}s including those which have not been enabled
576      * by the user.
577      *
578      * @return A list of {@code PhoneAccountHandle} objects.
579      * @hide
580      */
getCallCapablePhoneAccounts(boolean includeDisabledAccounts)581     public List<PhoneAccountHandle> getCallCapablePhoneAccounts(boolean includeDisabledAccounts) {
582         try {
583             if (isServiceConnected()) {
584                 return getTelecomService().getCallCapablePhoneAccounts(
585                         includeDisabledAccounts, mContext.getOpPackageName());
586             }
587         } catch (RemoteException e) {
588             Log.e(TAG, "Error calling ITelecomService#getCallCapablePhoneAccounts(" +
589                     includeDisabledAccounts + ")", e);
590         }
591         return new ArrayList<>();
592     }
593 
594     /**
595      *  Returns a list of all {@link PhoneAccount}s registered for the calling package.
596      *
597      * @return A list of {@code PhoneAccountHandle} objects.
598      * @hide
599      */
600     @SystemApi
getPhoneAccountsForPackage()601     public List<PhoneAccountHandle> getPhoneAccountsForPackage() {
602         try {
603             if (isServiceConnected()) {
604                 return getTelecomService().getPhoneAccountsForPackage(mContext.getPackageName());
605             }
606         } catch (RemoteException e) {
607             Log.e(TAG, "Error calling ITelecomService#getPhoneAccountsForPackage", e);
608         }
609         return null;
610     }
611 
612     /**
613      * Return the {@link PhoneAccount} for a specified {@link PhoneAccountHandle}. Object includes
614      * resources which can be used in a user interface.
615      *
616      * @param account The {@link PhoneAccountHandle}.
617      * @return The {@link PhoneAccount} object.
618      */
getPhoneAccount(PhoneAccountHandle account)619     public PhoneAccount getPhoneAccount(PhoneAccountHandle account) {
620         try {
621             if (isServiceConnected()) {
622                 return getTelecomService().getPhoneAccount(account);
623             }
624         } catch (RemoteException e) {
625             Log.e(TAG, "Error calling ITelecomService#getPhoneAccount", e);
626         }
627         return null;
628     }
629 
630     /**
631      * Returns a count of all {@link PhoneAccount}s.
632      *
633      * @return The count of {@link PhoneAccount}s.
634      * @hide
635      */
636     @SystemApi
getAllPhoneAccountsCount()637     public int getAllPhoneAccountsCount() {
638         try {
639             if (isServiceConnected()) {
640                 return getTelecomService().getAllPhoneAccountsCount();
641             }
642         } catch (RemoteException e) {
643             Log.e(TAG, "Error calling ITelecomService#getAllPhoneAccountsCount", e);
644         }
645         return 0;
646     }
647 
648     /**
649      * Returns a list of all {@link PhoneAccount}s.
650      *
651      * @return All {@link PhoneAccount}s.
652      * @hide
653      */
654     @SystemApi
getAllPhoneAccounts()655     public List<PhoneAccount> getAllPhoneAccounts() {
656         try {
657             if (isServiceConnected()) {
658                 return getTelecomService().getAllPhoneAccounts();
659             }
660         } catch (RemoteException e) {
661             Log.e(TAG, "Error calling ITelecomService#getAllPhoneAccounts", e);
662         }
663         return Collections.EMPTY_LIST;
664     }
665 
666     /**
667      * Returns a list of all {@link PhoneAccountHandle}s.
668      *
669      * @return All {@link PhoneAccountHandle}s.
670      * @hide
671      */
672     @SystemApi
getAllPhoneAccountHandles()673     public List<PhoneAccountHandle> getAllPhoneAccountHandles() {
674         try {
675             if (isServiceConnected()) {
676                 return getTelecomService().getAllPhoneAccountHandles();
677             }
678         } catch (RemoteException e) {
679             Log.e(TAG, "Error calling ITelecomService#getAllPhoneAccountHandles", e);
680         }
681         return Collections.EMPTY_LIST;
682     }
683 
684     /**
685      * Register a {@link PhoneAccount} for use by the system. When registering
686      * {@link PhoneAccount}s, existing registrations will be overwritten if the
687      * {@link PhoneAccountHandle} matches that of a {@link PhoneAccount} which is already
688      * registered. Once registered, the {@link PhoneAccount} is listed to the user as an option
689      * when placing calls. The user may still need to enable the {@link PhoneAccount} within
690      * the phone app settings before the account is usable.
691      * <p>
692      * A {@link SecurityException} will be thrown if an app tries to register a
693      * {@link PhoneAccountHandle} where the package name specified within
694      * {@link PhoneAccountHandle#getComponentName()} does not match the package name of the app.
695      *
696      * @param account The complete {@link PhoneAccount}.
697      */
registerPhoneAccount(PhoneAccount account)698     public void registerPhoneAccount(PhoneAccount account) {
699         try {
700             if (isServiceConnected()) {
701                 getTelecomService().registerPhoneAccount(account);
702             }
703         } catch (RemoteException e) {
704             Log.e(TAG, "Error calling ITelecomService#registerPhoneAccount", e);
705         }
706     }
707 
708     /**
709      * Remove a {@link PhoneAccount} registration from the system.
710      *
711      * @param accountHandle A {@link PhoneAccountHandle} for the {@link PhoneAccount} to unregister.
712      */
unregisterPhoneAccount(PhoneAccountHandle accountHandle)713     public void unregisterPhoneAccount(PhoneAccountHandle accountHandle) {
714         try {
715             if (isServiceConnected()) {
716                 getTelecomService().unregisterPhoneAccount(accountHandle);
717             }
718         } catch (RemoteException e) {
719             Log.e(TAG, "Error calling ITelecomService#unregisterPhoneAccount", e);
720         }
721     }
722 
723     /**
724      * Remove all Accounts that belong to the calling package from the system.
725      * @hide
726      */
727     @SystemApi
clearPhoneAccounts()728     public void clearPhoneAccounts() {
729         clearAccounts();
730     }
731     /**
732      * Remove all Accounts that belong to the calling package from the system.
733      * @deprecated Use {@link #clearPhoneAccounts()} instead.
734      * @hide
735      */
736     @SystemApi
clearAccounts()737     public void clearAccounts() {
738         try {
739             if (isServiceConnected()) {
740                 getTelecomService().clearAccounts(mContext.getPackageName());
741             }
742         } catch (RemoteException e) {
743             Log.e(TAG, "Error calling ITelecomService#clearAccounts", e);
744         }
745     }
746 
747     /**
748      * Remove all Accounts that belong to the specified package from the system.
749      * @hide
750      */
clearAccountsForPackage(String packageName)751     public void clearAccountsForPackage(String packageName) {
752         try {
753             if (isServiceConnected() && !TextUtils.isEmpty(packageName)) {
754                 getTelecomService().clearAccounts(packageName);
755             }
756         } catch (RemoteException e) {
757             Log.e(TAG, "Error calling ITelecomService#clearAccountsForPackage", e);
758         }
759     }
760 
761 
762     /**
763      * @deprecated - Use {@link TelecomManager#getDefaultDialerPackage} to directly access
764      *         the default dialer's package name instead.
765      * @hide
766      */
767     @SystemApi
getDefaultPhoneApp()768     public ComponentName getDefaultPhoneApp() {
769         try {
770             if (isServiceConnected()) {
771                 return getTelecomService().getDefaultPhoneApp();
772             }
773         } catch (RemoteException e) {
774             Log.e(TAG, "RemoteException attempting to get the default phone app.", e);
775         }
776         return null;
777     }
778 
779     /**
780      * Used to determine the currently selected default dialer package.
781      *
782      * @return package name for the default dialer package or null if no package has been
783      *         selected as the default dialer.
784      */
getDefaultDialerPackage()785     public String getDefaultDialerPackage() {
786         try {
787             if (isServiceConnected()) {
788                 return getTelecomService().getDefaultDialerPackage();
789             }
790         } catch (RemoteException e) {
791             Log.e(TAG, "RemoteException attempting to get the default dialer package name.", e);
792         }
793         return null;
794     }
795 
796     /**
797      * Used to set the default dialer package.
798      *
799      * @param packageName to set the default dialer to..
800      *
801      * @result {@code true} if the default dialer was successfully changed, {@code false} if
802      *         the specified package does not correspond to an installed dialer, or is already
803      *         the default dialer.
804      *
805      * Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE}
806      * Requires permission: {@link android.Manifest.permission#WRITE_SECURE_SETTINGS}
807      *
808      * @hide
809      */
setDefaultDialer(String packageName)810     public boolean setDefaultDialer(String packageName) {
811         try {
812             if (isServiceConnected()) {
813                 return getTelecomService().setDefaultDialer(packageName);
814             }
815         } catch (RemoteException e) {
816             Log.e(TAG, "RemoteException attempting to set the default dialer.", e);
817         }
818         return false;
819     }
820 
821     /**
822      * Used to determine the dialer package that is preloaded on the system partition.
823      *
824      * @return package name for the system dialer package or null if no system dialer is preloaded.
825      * @hide
826      */
getSystemDialerPackage()827     public String getSystemDialerPackage() {
828         try {
829             if (isServiceConnected()) {
830                 return getTelecomService().getSystemDialerPackage();
831             }
832         } catch (RemoteException e) {
833             Log.e(TAG, "RemoteException attempting to get the system dialer package name.", e);
834         }
835         return null;
836     }
837 
838     /**
839      * Return whether a given phone number is the configured voicemail number for a
840      * particular phone account.
841      *
842      * @param accountHandle The handle for the account to check the voicemail number against
843      * @param number The number to look up.
844      */
isVoiceMailNumber(PhoneAccountHandle accountHandle, String number)845     public boolean isVoiceMailNumber(PhoneAccountHandle accountHandle, String number) {
846         try {
847             if (isServiceConnected()) {
848                 return getTelecomService().isVoiceMailNumber(accountHandle, number,
849                         mContext.getOpPackageName());
850             }
851         } catch (RemoteException e) {
852             Log.e(TAG, "RemoteException calling ITelecomService#isVoiceMailNumber.", e);
853         }
854         return false;
855     }
856 
857     /**
858      * Return the voicemail number for a given phone account.
859      *
860      * @param accountHandle The handle for the phone account.
861      * @return The voicemail number for the phone account, and {@code null} if one has not been
862      *         configured.
863      */
getVoiceMailNumber(PhoneAccountHandle accountHandle)864     public String getVoiceMailNumber(PhoneAccountHandle accountHandle) {
865         try {
866             if (isServiceConnected()) {
867                 return getTelecomService().getVoiceMailNumber(accountHandle,
868                         mContext.getOpPackageName());
869             }
870         } catch (RemoteException e) {
871             Log.e(TAG, "RemoteException calling ITelecomService#hasVoiceMailNumber.", e);
872         }
873         return null;
874     }
875 
876     /**
877      * Return the line 1 phone number for given phone account.
878      *
879      * @param accountHandle The handle for the account retrieve a number for.
880      * @return A string representation of the line 1 phone number.
881      */
getLine1Number(PhoneAccountHandle accountHandle)882     public String getLine1Number(PhoneAccountHandle accountHandle) {
883         try {
884             if (isServiceConnected()) {
885                 return getTelecomService().getLine1Number(accountHandle,
886                         mContext.getOpPackageName());
887             }
888         } catch (RemoteException e) {
889             Log.e(TAG, "RemoteException calling ITelecomService#getLine1Number.", e);
890         }
891         return null;
892     }
893 
894     /**
895      * Returns whether there is an ongoing phone call (can be in dialing, ringing, active or holding
896      * states).
897      * <p>
898      * Requires permission: {@link android.Manifest.permission#READ_PHONE_STATE}
899      * </p>
900      */
isInCall()901     public boolean isInCall() {
902         try {
903             if (isServiceConnected()) {
904                 return getTelecomService().isInCall(mContext.getOpPackageName());
905             }
906         } catch (RemoteException e) {
907             Log.e(TAG, "RemoteException calling isInCall().", e);
908         }
909         return false;
910     }
911 
912     /**
913      * Returns one of the following constants that represents the current state of Telecom:
914      *
915      * {@link TelephonyManager#CALL_STATE_RINGING}
916      * {@link TelephonyManager#CALL_STATE_OFFHOOK}
917      * {@link TelephonyManager#CALL_STATE_IDLE}
918      *
919      * Note that this API does not require the
920      * {@link android.Manifest.permission#READ_PHONE_STATE} permission. This is intentional, to
921      * preserve the behavior of {@link TelephonyManager#getCallState()}, which also did not require
922      * the permission.
923      * @hide
924      */
925     @SystemApi
getCallState()926     public int getCallState() {
927         try {
928             if (isServiceConnected()) {
929                 return getTelecomService().getCallState();
930             }
931         } catch (RemoteException e) {
932             Log.d(TAG, "RemoteException calling getCallState().", e);
933         }
934         return TelephonyManager.CALL_STATE_IDLE;
935     }
936 
937     /**
938      * Returns whether there currently exists is a ringing incoming-call.
939      *
940      * @hide
941      */
942     @SystemApi
isRinging()943     public boolean isRinging() {
944         try {
945             if (isServiceConnected()) {
946                 return getTelecomService().isRinging(mContext.getOpPackageName());
947             }
948         } catch (RemoteException e) {
949             Log.e(TAG, "RemoteException attempting to get ringing state of phone app.", e);
950         }
951         return false;
952     }
953 
954     /**
955      * Ends an ongoing call.
956      * TODO: L-release - need to convert all invocations of ITelecomService#endCall to use this
957      * method (clockwork & gearhead).
958      * @hide
959      */
960     @SystemApi
endCall()961     public boolean endCall() {
962         try {
963             if (isServiceConnected()) {
964                 return getTelecomService().endCall();
965             }
966         } catch (RemoteException e) {
967             Log.e(TAG, "Error calling ITelecomService#endCall", e);
968         }
969         return false;
970     }
971 
972     /**
973      * If there is a ringing incoming call, this method accepts the call on behalf of the user.
974      * TODO: L-release - need to convert all invocation of ITelecmmService#answerRingingCall to use
975      * this method (clockwork & gearhead).
976      *
977      * @hide
978      */
979     @SystemApi
acceptRingingCall()980     public void acceptRingingCall() {
981         try {
982             if (isServiceConnected()) {
983                 getTelecomService().acceptRingingCall();
984             }
985         } catch (RemoteException e) {
986             Log.e(TAG, "Error calling ITelecomService#acceptRingingCall", e);
987         }
988     }
989 
990     /**
991      * Silences the ringer if a ringing call exists.
992      */
silenceRinger()993     public void silenceRinger() {
994         try {
995             if (isServiceConnected()) {
996                 getTelecomService().silenceRinger(mContext.getOpPackageName());
997             }
998         } catch (RemoteException e) {
999             Log.e(TAG, "Error calling ITelecomService#silenceRinger", e);
1000         }
1001     }
1002 
1003     /**
1004      * Returns whether TTY is supported on this device.
1005      *
1006      * @hide
1007      */
1008     @SystemApi
isTtySupported()1009     public boolean isTtySupported() {
1010         try {
1011             if (isServiceConnected()) {
1012                 return getTelecomService().isTtySupported(mContext.getOpPackageName());
1013             }
1014         } catch (RemoteException e) {
1015             Log.e(TAG, "RemoteException attempting to get TTY supported state.", e);
1016         }
1017         return false;
1018     }
1019 
1020     /**
1021      * Returns the current TTY mode of the device. For TTY to be on the user must enable it in
1022      * settings and have a wired headset plugged in.
1023      * Valid modes are:
1024      * - {@link TelecomManager#TTY_MODE_OFF}
1025      * - {@link TelecomManager#TTY_MODE_FULL}
1026      * - {@link TelecomManager#TTY_MODE_HCO}
1027      * - {@link TelecomManager#TTY_MODE_VCO}
1028      * @hide
1029      */
getCurrentTtyMode()1030     public int getCurrentTtyMode() {
1031         try {
1032             if (isServiceConnected()) {
1033                 return getTelecomService().getCurrentTtyMode(mContext.getOpPackageName());
1034             }
1035         } catch (RemoteException e) {
1036             Log.e(TAG, "RemoteException attempting to get the current TTY mode.", e);
1037         }
1038         return TTY_MODE_OFF;
1039     }
1040 
1041     /**
1042      * Registers a new incoming call. A {@link ConnectionService} should invoke this method when it
1043      * has an incoming call. The specified {@link PhoneAccountHandle} must have been registered
1044      * with {@link #registerPhoneAccount}. Once invoked, this method will cause the system to bind
1045      * to the {@link ConnectionService} associated with the {@link PhoneAccountHandle} and request
1046      * additional information about the call (See
1047      * {@link ConnectionService#onCreateIncomingConnection}) before starting the incoming call UI.
1048      *
1049      * @param phoneAccount A {@link PhoneAccountHandle} registered with
1050      *            {@link #registerPhoneAccount}.
1051      * @param extras A bundle that will be passed through to
1052      *            {@link ConnectionService#onCreateIncomingConnection}.
1053      */
addNewIncomingCall(PhoneAccountHandle phoneAccount, Bundle extras)1054     public void addNewIncomingCall(PhoneAccountHandle phoneAccount, Bundle extras) {
1055         try {
1056             if (isServiceConnected()) {
1057                 getTelecomService().addNewIncomingCall(
1058                         phoneAccount, extras == null ? new Bundle() : extras);
1059             }
1060         } catch (RemoteException e) {
1061             Log.e(TAG, "RemoteException adding a new incoming call: " + phoneAccount, e);
1062         }
1063     }
1064 
1065     /**
1066      * Registers a new unknown call with Telecom. This can only be called by the system Telephony
1067      * service. This is invoked when Telephony detects a new unknown connection that was neither
1068      * a new incoming call, nor an user-initiated outgoing call.
1069      *
1070      * @param phoneAccount A {@link PhoneAccountHandle} registered with
1071      *            {@link #registerPhoneAccount}.
1072      * @param extras A bundle that will be passed through to
1073      *            {@link ConnectionService#onCreateIncomingConnection}.
1074      * @hide
1075      */
1076     @SystemApi
addNewUnknownCall(PhoneAccountHandle phoneAccount, Bundle extras)1077     public void addNewUnknownCall(PhoneAccountHandle phoneAccount, Bundle extras) {
1078         try {
1079             if (isServiceConnected()) {
1080                 getTelecomService().addNewUnknownCall(
1081                         phoneAccount, extras == null ? new Bundle() : extras);
1082             }
1083         } catch (RemoteException e) {
1084             Log.e(TAG, "RemoteException adding a new unknown call: " + phoneAccount, e);
1085         }
1086     }
1087 
1088     /**
1089      * Processes the specified dial string as an MMI code.
1090      * MMI codes are any sequence of characters entered into the dialpad that contain a "*" or "#".
1091      * Some of these sequences launch special behavior through handled by Telephony.
1092      * This method uses the default subscription.
1093      * <p>
1094      * Requires that the method-caller be set as the system dialer app.
1095      * </p>
1096      *
1097      * @param dialString The digits to dial.
1098      * @return True if the digits were processed as an MMI code, false otherwise.
1099      */
handleMmi(String dialString)1100     public boolean handleMmi(String dialString) {
1101         ITelecomService service = getTelecomService();
1102         if (service != null) {
1103             try {
1104                 return service.handlePinMmi(dialString, mContext.getOpPackageName());
1105             } catch (RemoteException e) {
1106                 Log.e(TAG, "Error calling ITelecomService#handlePinMmi", e);
1107             }
1108         }
1109         return false;
1110     }
1111 
1112     /**
1113      * Processes the specified dial string as an MMI code.
1114      * MMI codes are any sequence of characters entered into the dialpad that contain a "*" or "#".
1115      * Some of these sequences launch special behavior through handled by Telephony.
1116      * <p>
1117      * Requires that the method-caller be set as the system dialer app.
1118      * </p>
1119      *
1120      * @param accountHandle The handle for the account the MMI code should apply to.
1121      * @param dialString The digits to dial.
1122      * @return True if the digits were processed as an MMI code, false otherwise.
1123      */
handleMmi(String dialString, PhoneAccountHandle accountHandle)1124     public boolean handleMmi(String dialString, PhoneAccountHandle accountHandle) {
1125         ITelecomService service = getTelecomService();
1126         if (service != null) {
1127             try {
1128                 return service.handlePinMmiForPhoneAccount(accountHandle, dialString,
1129                         mContext.getOpPackageName());
1130             } catch (RemoteException e) {
1131                 Log.e(TAG, "Error calling ITelecomService#handlePinMmi", e);
1132             }
1133         }
1134         return false;
1135     }
1136 
1137     /**
1138      * @param accountHandle The handle for the account to derive an adn query URI for or
1139      * {@code null} to return a URI which will use the default account.
1140      * @return The URI (with the content:// scheme) specific to the specified {@link PhoneAccount}
1141      * for the the content retrieve.
1142      */
getAdnUriForPhoneAccount(PhoneAccountHandle accountHandle)1143     public Uri getAdnUriForPhoneAccount(PhoneAccountHandle accountHandle) {
1144         ITelecomService service = getTelecomService();
1145         if (service != null && accountHandle != null) {
1146             try {
1147                 return service.getAdnUriForPhoneAccount(accountHandle, mContext.getOpPackageName());
1148             } catch (RemoteException e) {
1149                 Log.e(TAG, "Error calling ITelecomService#getAdnUriForPhoneAccount", e);
1150             }
1151         }
1152         return Uri.parse("content://icc/adn");
1153     }
1154 
1155     /**
1156      * Removes the missed-call notification if one is present.
1157      * <p>
1158      * Requires that the method-caller be set as the system dialer app.
1159      * </p>
1160      */
cancelMissedCallsNotification()1161     public void cancelMissedCallsNotification() {
1162         ITelecomService service = getTelecomService();
1163         if (service != null) {
1164             try {
1165                 service.cancelMissedCallsNotification(mContext.getOpPackageName());
1166             } catch (RemoteException e) {
1167                 Log.e(TAG, "Error calling ITelecomService#cancelMissedCallsNotification", e);
1168             }
1169         }
1170     }
1171 
1172     /**
1173      * Brings the in-call screen to the foreground if there is an ongoing call. If there is
1174      * currently no ongoing call, then this method does nothing.
1175      * <p>
1176      * Requires that the method-caller be set as the system dialer app or have the
1177      * {@link android.Manifest.permission#READ_PHONE_STATE} permission.
1178      * </p>
1179      *
1180      * @param showDialpad Brings up the in-call dialpad as part of showing the in-call screen.
1181      */
showInCallScreen(boolean showDialpad)1182     public void showInCallScreen(boolean showDialpad) {
1183         ITelecomService service = getTelecomService();
1184         if (service != null) {
1185             try {
1186                 service.showInCallScreen(showDialpad, mContext.getOpPackageName());
1187             } catch (RemoteException e) {
1188                 Log.e(TAG, "Error calling ITelecomService#showCallScreen", e);
1189             }
1190         }
1191     }
1192 
1193     /**
1194      * Places a new outgoing call to the provided address using the system telecom service with
1195      * the specified extras.
1196      *
1197      * This method is equivalent to placing an outgoing call using {@link Intent#ACTION_CALL},
1198      * except that the outgoing call will always be sent via the system telecom service. If
1199      * method-caller is either the user selected default dialer app or preloaded system dialer
1200      * app, then emergency calls will also be allowed.
1201      *
1202      * Requires permission: {@link android.Manifest.permission#CALL_PHONE}
1203      *
1204      * Usage example:
1205      * <pre>
1206      * Uri uri = Uri.fromParts("tel", "12345", null);
1207      * Bundle extras = new Bundle();
1208      * extras.putBoolean(TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, true);
1209      * telecomManager.placeCall(uri, extras);
1210      * </pre>
1211      *
1212      * The following keys are supported in the supplied extras.
1213      * <ul>
1214      *   <li>{@link #EXTRA_OUTGOING_CALL_EXTRAS}</li>
1215      *   <li>{@link #EXTRA_PHONE_ACCOUNT_HANDLE}</li>
1216      *   <li>{@link #EXTRA_START_CALL_WITH_SPEAKERPHONE}</li>
1217      *   <li>{@link #EXTRA_START_CALL_WITH_VIDEO_STATE}</li>
1218      * </ul>
1219      *
1220      * @param address The address to make the call to.
1221      * @param extras Bundle of extras to use with the call.
1222      */
placeCall(Uri address, Bundle extras)1223     public void placeCall(Uri address, Bundle extras) {
1224         ITelecomService service = getTelecomService();
1225         if (service != null) {
1226             if (address == null) {
1227                 Log.w(TAG, "Cannot place call to empty address.");
1228             }
1229             try {
1230                 service.placeCall(address, extras == null ? new Bundle() : extras,
1231                         mContext.getOpPackageName());
1232             } catch (RemoteException e) {
1233                 Log.e(TAG, "Error calling ITelecomService#placeCall", e);
1234             }
1235         }
1236     }
1237 
1238     /**
1239      * Enables and disables specified phone account.
1240      *
1241      * @param handle Handle to the phone account.
1242      * @param isEnabled Enable state of the phone account.
1243      * @hide
1244      */
1245     @SystemApi
enablePhoneAccount(PhoneAccountHandle handle, boolean isEnabled)1246     public void enablePhoneAccount(PhoneAccountHandle handle, boolean isEnabled) {
1247         ITelecomService service = getTelecomService();
1248         if (service != null) {
1249             try {
1250                 service.enablePhoneAccount(handle, isEnabled);
1251             } catch (RemoteException e) {
1252                 Log.e(TAG, "Error enablePhoneAbbount", e);
1253             }
1254         }
1255     }
1256 
getTelecomService()1257     private ITelecomService getTelecomService() {
1258         return ITelecomService.Stub.asInterface(ServiceManager.getService(Context.TELECOM_SERVICE));
1259     }
1260 
isServiceConnected()1261     private boolean isServiceConnected() {
1262         boolean isConnected = getTelecomService() != null;
1263         if (!isConnected) {
1264             Log.w(TAG, "Telecom Service not found.");
1265         }
1266         return isConnected;
1267     }
1268 }
1269