Wiring up Ims framework multi-endpoint APIs.
[android/platform/frameworks/opt/net/ims.git] / src / java / com / android / ims / ImsManager.java
1 /*
2  * Copyright (c) 2013 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 package com.android.ims;
18
19 import android.app.PendingIntent;
20 import android.content.Context;
21 import android.content.Intent;
22 import android.net.Uri;
23 import android.os.IBinder;
24 import android.os.Message;
25 import android.os.PersistableBundle;
26 import android.os.RemoteException;
27 import android.os.ServiceManager;
28 import android.os.SystemProperties;
29 import android.provider.Settings;
30 import android.telecom.TelecomManager;
31 import android.telephony.CarrierConfigManager;
32 import android.telephony.Rlog;
33 import android.telephony.SubscriptionManager;
34 import android.telephony.TelephonyManager;
35
36 import com.android.ims.internal.IImsCallSession;
37 import com.android.ims.internal.IImsEcbm;
38 import com.android.ims.internal.IImsEcbmListener;
39 import com.android.ims.internal.IImsMultiEndpoint;
40 import com.android.ims.internal.IImsRegistrationListener;
41 import com.android.ims.internal.IImsService;
42 import com.android.ims.internal.IImsUt;
43 import com.android.ims.internal.ImsCallSession;
44 import com.android.ims.internal.IImsConfig;
45
46 import java.io.FileDescriptor;
47 import java.io.PrintWriter;
48 import java.util.HashMap;
49
50 /**
51  * Provides APIs for IMS services, such as initiating IMS calls, and provides access to
52  * the operator's IMS network. This class is the starting point for any IMS actions.
53  * You can acquire an instance of it with {@link #getInstance getInstance()}.</p>
54  * <p>The APIs in this class allows you to:</p>
55  *
56  * @hide
57  */
58 public class ImsManager {
59
60     /*
61      * Debug flag to override configuration flag
62      */
63     public static final String PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE = "persist.dbg.volte_avail_ovr";
64     public static final int PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE_DEFAULT = 0;
65     public static final String PROPERTY_DBG_VT_AVAIL_OVERRIDE = "persist.dbg.vt_avail_ovr";
66     public static final int PROPERTY_DBG_VT_AVAIL_OVERRIDE_DEFAULT = 0;
67     public static final String PROPERTY_DBG_WFC_AVAIL_OVERRIDE = "persist.dbg.wfc_avail_ovr";
68     public static final int PROPERTY_DBG_WFC_AVAIL_OVERRIDE_DEFAULT = 0;
69
70     /**
71      * For accessing the IMS related service.
72      * Internal use only.
73      * @hide
74      */
75     private static final String IMS_SERVICE = "ims";
76
77     /**
78      * The result code to be sent back with the incoming call {@link PendingIntent}.
79      * @see #open(PendingIntent, ImsConnectionStateListener)
80      */
81     public static final int INCOMING_CALL_RESULT_CODE = 101;
82
83     /**
84      * Key to retrieve the call ID from an incoming call intent.
85      * @see #open(PendingIntent, ImsConnectionStateListener)
86      */
87     public static final String EXTRA_CALL_ID = "android:imsCallID";
88
89     /**
90      * Action to broadcast when ImsService is up.
91      * Internal use only.
92      * @hide
93      */
94     public static final String ACTION_IMS_SERVICE_UP =
95             "com.android.ims.IMS_SERVICE_UP";
96
97     /**
98      * Action to broadcast when ImsService is down.
99      * Internal use only.
100      * @hide
101      */
102     public static final String ACTION_IMS_SERVICE_DOWN =
103             "com.android.ims.IMS_SERVICE_DOWN";
104
105     /**
106      * Action to broadcast when ImsService registration fails.
107      * Internal use only.
108      * @hide
109      */
110     public static final String ACTION_IMS_REGISTRATION_ERROR =
111             "com.android.ims.REGISTRATION_ERROR";
112
113     /**
114      * Part of the ACTION_IMS_SERVICE_UP or _DOWN intents.
115      * A long value; the phone ID corresponding to the IMS service coming up or down.
116      * Internal use only.
117      * @hide
118      */
119     public static final String EXTRA_PHONE_ID = "android:phone_id";
120
121     /**
122      * Action for the incoming call intent for the Phone app.
123      * Internal use only.
124      * @hide
125      */
126     public static final String ACTION_IMS_INCOMING_CALL =
127             "com.android.ims.IMS_INCOMING_CALL";
128
129     /**
130      * Part of the ACTION_IMS_INCOMING_CALL intents.
131      * An integer value; service identifier obtained from {@link ImsManager#open}.
132      * Internal use only.
133      * @hide
134      */
135     public static final String EXTRA_SERVICE_ID = "android:imsServiceId";
136
137     /**
138      * Part of the ACTION_IMS_INCOMING_CALL intents.
139      * An boolean value; Flag to indicate that the incoming call is a normal call or call for USSD.
140      * The value "true" indicates that the incoming call is for USSD.
141      * Internal use only.
142      * @hide
143      */
144     public static final String EXTRA_USSD = "android:ussd";
145
146     /**
147      * Part of the ACTION_IMS_INCOMING_CALL intents.
148      * A boolean value; Flag to indicate whether the call is an unknown
149      * dialing call. Such calls are originated by sending commands (like
150      * AT commands) directly to modem without Android involvement.
151      * Even though they are not incoming calls, they are propagated
152      * to Phone app using same ACTION_IMS_INCOMING_CALL intent.
153      * Internal use only.
154      * @hide
155      */
156     public static final String EXTRA_IS_UNKNOWN_CALL = "android:isUnknown";
157
158     private static final String TAG = "ImsManager";
159     private static final boolean DBG = true;
160
161     private static HashMap<Integer, ImsManager> sImsManagerInstances =
162             new HashMap<Integer, ImsManager>();
163
164     private Context mContext;
165     private int mPhoneId;
166     private IImsService mImsService = null;
167     private ImsServiceDeathRecipient mDeathRecipient = new ImsServiceDeathRecipient();
168     // Ut interface for the supplementary service configuration
169     private ImsUt mUt = null;
170     // Interface to get/set ims config items
171     private ImsConfig mConfig = null;
172     private boolean mConfigUpdated = false;
173
174     private ImsConfigListener mImsConfigListener;
175
176     // ECBM interface
177     private ImsEcbm mEcbm = null;
178
179     private ImsMultiEndpoint mMultiEndpoint = null;
180
181     /**
182      * Gets a manager instance.
183      *
184      * @param context application context for creating the manager object
185      * @param phoneId the phone ID for the IMS Service
186      * @return the manager instance corresponding to the phoneId
187      */
188     public static ImsManager getInstance(Context context, int phoneId) {
189         synchronized (sImsManagerInstances) {
190             if (sImsManagerInstances.containsKey(phoneId))
191                 return sImsManagerInstances.get(phoneId);
192
193             ImsManager mgr = new ImsManager(context, phoneId);
194             sImsManagerInstances.put(phoneId, mgr);
195
196             return mgr;
197         }
198     }
199
200     /**
201      * Returns the user configuration of Enhanced 4G LTE Mode setting
202      */
203     public static boolean isEnhanced4gLteModeSettingEnabledByUser(Context context) {
204         // If user can't edit Enhanced 4G LTE Mode, it assumes Enhanced 4G LTE Mode is always true.
205         // If user changes SIM from editable mode to uneditable mode, need to return true.
206         if (!getBooleanCarrierConfig(context,
207                     CarrierConfigManager.KEY_EDITABLE_ENHANCED_4G_LTE_BOOL)) {
208             return true;
209         }
210         int enabled = android.provider.Settings.Global.getInt(
211                     context.getContentResolver(),
212                     android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED, ImsConfig.FeatureValueConstants.ON);
213         return (enabled == 1) ? true : false;
214     }
215
216     /**
217      * Change persistent Enhanced 4G LTE Mode setting
218      */
219     public static void setEnhanced4gLteModeSetting(Context context, boolean enabled) {
220         int value = enabled ? 1 : 0;
221         android.provider.Settings.Global.putInt(
222                 context.getContentResolver(),
223                 android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED, value);
224
225         if (isNonTtyOrTtyOnVolteEnabled(context)) {
226             ImsManager imsManager = ImsManager.getInstance(context,
227                     SubscriptionManager.getDefaultVoicePhoneId());
228             if (imsManager != null) {
229                 try {
230                     imsManager.setAdvanced4GMode(enabled);
231                 } catch (ImsException ie) {
232                     // do nothing
233                 }
234             }
235         }
236     }
237
238     /**
239      * Indicates whether the call is non-TTY or if TTY - whether TTY on VoLTE is
240      * supported.
241      */
242     public static boolean isNonTtyOrTtyOnVolteEnabled(Context context) {
243         if (getBooleanCarrierConfig(context,
244                 CarrierConfigManager.KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL)) {
245             return true;
246         }
247
248         return Settings.Secure.getInt(context.getContentResolver(),
249                 Settings.Secure.PREFERRED_TTY_MODE, TelecomManager.TTY_MODE_OFF)
250                 == TelecomManager.TTY_MODE_OFF;
251     }
252
253     /**
254      * Returns a platform configuration for VoLTE which may override the user setting.
255      */
256     public static boolean isVolteEnabledByPlatform(Context context) {
257         if (SystemProperties.getInt(PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE,
258                 PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE_DEFAULT) == 1) {
259             return true;
260         }
261
262         return context.getResources().getBoolean(
263                 com.android.internal.R.bool.config_device_volte_available)
264                 && getBooleanCarrierConfig(context,
265                         CarrierConfigManager.KEY_CARRIER_VOLTE_AVAILABLE_BOOL)
266                 && isGbaValid(context);
267     }
268
269     /*
270      * Indicates whether VoLTE is provisioned on device
271      */
272     public static boolean isVolteProvisionedOnDevice(Context context) {
273         boolean isProvisioned = true;
274         if (getBooleanCarrierConfig(context,
275                     CarrierConfigManager.KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL)) {
276             isProvisioned = false; // disable on any error
277             ImsManager mgr = ImsManager.getInstance(context,
278                     SubscriptionManager.getDefaultVoicePhoneId());
279             if (mgr != null) {
280                 try {
281                     ImsConfig config = mgr.getConfigInterface();
282                     if (config != null) {
283                         isProvisioned = config.getVolteProvisioned();
284                     }
285                 } catch (ImsException ie) {
286                     // do nothing
287                 }
288             }
289         }
290
291         return isProvisioned;
292     }
293
294     /**
295      * Returns a platform configuration for VT which may override the user setting.
296      *
297      * Note: VT presumes that VoLTE is enabled (these are configuration settings
298      * which must be done correctly).
299      */
300     public static boolean isVtEnabledByPlatform(Context context) {
301         if (SystemProperties.getInt(PROPERTY_DBG_VT_AVAIL_OVERRIDE,
302                 PROPERTY_DBG_VT_AVAIL_OVERRIDE_DEFAULT) == 1) {
303             return true;
304         }
305
306         return
307                 context.getResources().getBoolean(
308                         com.android.internal.R.bool.config_device_vt_available) &&
309                 getBooleanCarrierConfig(context,
310                         CarrierConfigManager.KEY_CARRIER_VT_AVAILABLE_BOOL) &&
311                 isGbaValid(context);
312     }
313
314     /**
315      * Returns the user configuration of VT setting
316      */
317     public static boolean isVtEnabledByUser(Context context) {
318         int enabled = android.provider.Settings.Global.getInt(context.getContentResolver(),
319                 android.provider.Settings.Global.VT_IMS_ENABLED,
320                 ImsConfig.FeatureValueConstants.ON);
321         return (enabled == 1) ? true : false;
322     }
323
324     /**
325      * Change persistent VT enabled setting
326      */
327     public static void setVtSetting(Context context, boolean enabled) {
328         int value = enabled ? 1 : 0;
329         android.provider.Settings.Global.putInt(context.getContentResolver(),
330                 android.provider.Settings.Global.VT_IMS_ENABLED, value);
331
332         ImsManager imsManager = ImsManager.getInstance(context,
333                 SubscriptionManager.getDefaultVoicePhoneId());
334         if (imsManager != null) {
335             try {
336                 ImsConfig config = imsManager.getConfigInterface();
337                 config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VIDEO_OVER_LTE,
338                         TelephonyManager.NETWORK_TYPE_LTE,
339                         enabled ? ImsConfig.FeatureValueConstants.ON
340                                 : ImsConfig.FeatureValueConstants.OFF,
341                         imsManager.mImsConfigListener);
342
343                 if (enabled) {
344                     imsManager.turnOnIms();
345                 } else if (getBooleanCarrierConfig(context,
346                         CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)
347                         && (!isVolteEnabledByPlatform(context)
348                         || !isEnhanced4gLteModeSettingEnabledByUser(context))) {
349                     log("setVtSetting() : imsServiceAllowTurnOff -> turnOffIms");
350                     imsManager.turnOffIms();
351                 }
352             } catch (ImsException e) {
353                 loge("setVtSetting(): " + e);
354             }
355         }
356     }
357
358     /**
359      * Returns the user configuration of WFC setting
360      */
361     public static boolean isWfcEnabledByUser(Context context) {
362         int enabled = android.provider.Settings.Global.getInt(context.getContentResolver(),
363                 android.provider.Settings.Global.WFC_IMS_ENABLED,
364                 getBooleanCarrierConfig(context,
365                         CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL) ?
366                         ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
367         return (enabled == 1) ? true : false;
368     }
369
370     /**
371      * Change persistent WFC enabled setting
372      */
373     public static void setWfcSetting(Context context, boolean enabled) {
374         int value = enabled ? 1 : 0;
375         android.provider.Settings.Global.putInt(context.getContentResolver(),
376                 android.provider.Settings.Global.WFC_IMS_ENABLED, value);
377
378         ImsManager imsManager = ImsManager.getInstance(context,
379                 SubscriptionManager.getDefaultVoicePhoneId());
380         if (imsManager != null) {
381             try {
382                 ImsConfig config = imsManager.getConfigInterface();
383                 config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_WIFI,
384                         TelephonyManager.NETWORK_TYPE_IWLAN,
385                         enabled ? ImsConfig.FeatureValueConstants.ON
386                                 : ImsConfig.FeatureValueConstants.OFF,
387                         imsManager.mImsConfigListener);
388
389                 if (enabled) {
390                     imsManager.turnOnIms();
391                 } else if (getBooleanCarrierConfig(context,
392                         CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)
393                         && (!isVolteEnabledByPlatform(context)
394                         || !isEnhanced4gLteModeSettingEnabledByUser(context))) {
395                     log("setWfcSetting() : imsServiceAllowTurnOff -> turnOffIms");
396                     imsManager.turnOffIms();
397                 }
398
399                 // Force IMS to register over LTE when turning off WFC
400                 setWfcModeInternal(context, enabled
401                         ? getWfcMode(context)
402                         : ImsConfig.WfcModeFeatureValueConstants.CELLULAR_PREFERRED);
403             } catch (ImsException e) {
404                 loge("setWfcSetting(): " + e);
405             }
406         }
407     }
408
409     /**
410      * Returns the user configuration of WFC modem setting
411      */
412     public static int getWfcMode(Context context) {
413         int setting = android.provider.Settings.Global.getInt(context.getContentResolver(),
414                 android.provider.Settings.Global.WFC_IMS_MODE, getIntCarrierConfig(context,
415                         CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT));
416         if (DBG) log("getWfcMode - setting=" + setting);
417         return setting;
418     }
419
420     /**
421      * Returns the user configuration of WFC modem setting
422      */
423     public static void setWfcMode(Context context, int wfcMode) {
424         if (DBG) log("setWfcMode - setting=" + wfcMode);
425         android.provider.Settings.Global.putInt(context.getContentResolver(),
426                 android.provider.Settings.Global.WFC_IMS_MODE, wfcMode);
427
428         setWfcModeInternal(context, wfcMode);
429     }
430
431     private static void setWfcModeInternal(Context context, int wfcMode) {
432         final ImsManager imsManager = ImsManager.getInstance(context,
433                 SubscriptionManager.getDefaultVoicePhoneId());
434         if (imsManager != null) {
435             final int value = wfcMode;
436             Thread thread = new Thread(new Runnable() {
437                 public void run() {
438                     try {
439                         imsManager.getConfigInterface().setProvisionedValue(
440                                 ImsConfig.ConfigConstants.VOICE_OVER_WIFI_MODE,
441                                 value);
442                     } catch (ImsException e) {
443                         // do nothing
444                     }
445                 }
446             });
447             thread.start();
448         }
449     }
450
451     /**
452      * Returns the user configuration of WFC roaming setting
453      */
454     public static boolean isWfcRoamingEnabledByUser(Context context) {
455         int enabled = android.provider.Settings.Global.getInt(context.getContentResolver(),
456                 android.provider.Settings.Global.WFC_IMS_ROAMING_ENABLED,
457                 getBooleanCarrierConfig(context,
458                         CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL) ?
459                         ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
460         return (enabled == 1) ? true : false;
461     }
462
463     /**
464      * Change persistent WFC roaming enabled setting
465      */
466     public static void setWfcRoamingSetting(Context context, boolean enabled) {
467         android.provider.Settings.Global.putInt(context.getContentResolver(),
468                 android.provider.Settings.Global.WFC_IMS_ROAMING_ENABLED,
469                 enabled ? ImsConfig.FeatureValueConstants.ON
470                         : ImsConfig.FeatureValueConstants.OFF);
471
472         setWfcRoamingSettingInternal(context, enabled);
473     }
474
475     private static void setWfcRoamingSettingInternal(Context context, boolean enabled) {
476         final ImsManager imsManager = ImsManager.getInstance(context,
477                 SubscriptionManager.getDefaultVoicePhoneId());
478         if (imsManager != null) {
479             final int value = enabled
480                     ? ImsConfig.FeatureValueConstants.ON
481                     : ImsConfig.FeatureValueConstants.OFF;
482             Thread thread = new Thread(new Runnable() {
483                 public void run() {
484                     try {
485                         imsManager.getConfigInterface().setProvisionedValue(
486                                 ImsConfig.ConfigConstants.VOICE_OVER_WIFI_ROAMING,
487                                 value);
488                     } catch (ImsException e) {
489                         // do nothing
490                     }
491                 }
492             });
493             thread.start();
494         }
495     }
496
497     /**
498      * Returns a platform configuration for WFC which may override the user
499      * setting. Note: WFC presumes that VoLTE is enabled (these are
500      * configuration settings which must be done correctly).
501      */
502     public static boolean isWfcEnabledByPlatform(Context context) {
503         if (SystemProperties.getInt(PROPERTY_DBG_WFC_AVAIL_OVERRIDE,
504                 PROPERTY_DBG_WFC_AVAIL_OVERRIDE_DEFAULT) == 1) {
505             return true;
506         }
507
508         return
509                context.getResources().getBoolean(
510                        com.android.internal.R.bool.config_device_wfc_ims_available) &&
511                getBooleanCarrierConfig(context,
512                        CarrierConfigManager.KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL) &&
513                isGbaValid(context);
514     }
515
516     /**
517      * If carrier requires that IMS is only available if GBA capable SIM is used,
518      * then this function checks GBA bit in EF IST.
519      *
520      * Format of EF IST is defined in 3GPP TS 31.103 (Section 4.2.7).
521      */
522     private static boolean isGbaValid(Context context) {
523         if (getBooleanCarrierConfig(context,
524                 CarrierConfigManager.KEY_CARRIER_IMS_GBA_REQUIRED_BOOL)) {
525             final TelephonyManager telephonyManager = TelephonyManager.getDefault();
526             String efIst = telephonyManager.getIsimIst();
527             if (efIst == null) {
528                 loge("ISF is NULL");
529                 return true;
530             }
531             boolean result = efIst != null && efIst.length() > 1 &&
532                     (0x02 & (byte)efIst.charAt(1)) != 0;
533             if (DBG) log("GBA capable=" + result + ", ISF=" + efIst);
534             return result;
535         }
536         return true;
537     }
538
539     /**
540      * Sync carrier config and user settings with ImsConfig.
541      *
542      * @param context for the manager object
543      * @param phoneId phone id
544      * @param force update
545      */
546     public static void updateImsServiceConfig(Context context, int phoneId, boolean force) {
547         if (!force) {
548             if (TelephonyManager.getDefault().getSimState() != TelephonyManager.SIM_STATE_READY) {
549                 log("updateImsServiceConfig: SIM not ready");
550                 // Don't disable IMS if SIM is not ready
551                 return;
552             }
553         }
554
555         final ImsManager imsManager = ImsManager.getInstance(context, phoneId);
556         if (imsManager != null && (!imsManager.mConfigUpdated || force)) {
557             try {
558                 boolean isImsUsed = imsManager.updateVolteFeatureValue();
559                 isImsUsed |= imsManager.updateVideoCallFeatureValue();
560                 isImsUsed |= imsManager.updateWfcFeatureAndProvisionedValues();
561
562                 if (isImsUsed || !getBooleanCarrierConfig(context,
563                       CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)) {
564                     // Turn on IMS if it is used.
565                     // Also, if turning off is not allowed for current carrier,
566                     // we need to turn IMS on because it might be turned off before
567                     // phone switched to current carrier.
568                     imsManager.turnOnIms();
569                 } else {
570                     // Turn off IMS if it is not used AND turning off is allowed for carrier.
571                     imsManager.turnOffIms();
572                 }
573
574                 imsManager.mConfigUpdated = true;
575             } catch (ImsException e) {
576                 loge("updateImsServiceConfig: " + e);
577                 imsManager.mConfigUpdated = false;
578             }
579         }
580     }
581
582     /**
583      * Update VoLTE config
584      * @return whether feature is On
585      * @throws ImsException
586      */
587     private boolean updateVolteFeatureValue() throws ImsException {
588         boolean available = isVolteEnabledByPlatform(mContext);
589         boolean enabled = isEnhanced4gLteModeSettingEnabledByUser(mContext);
590         boolean isNonTty = isNonTtyOrTtyOnVolteEnabled(mContext);
591         boolean isFeatureOn = available && enabled && isNonTty;
592
593         log("updateVolteFeatureValue: available = " + available
594                 + ", enabled = " + enabled
595                 + ", nonTTY = " + isNonTty);
596
597         getConfigInterface().setFeatureValue(
598                 ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_LTE,
599                 TelephonyManager.NETWORK_TYPE_LTE,
600                 isFeatureOn ?
601                         ImsConfig.FeatureValueConstants.ON :
602                         ImsConfig.FeatureValueConstants.OFF,
603                 mImsConfigListener);
604
605         return isFeatureOn;
606     }
607
608     /**
609      * Update VC config
610      * @return whether feature is On
611      * @throws ImsException
612      */
613     private boolean updateVideoCallFeatureValue() throws ImsException {
614         boolean available = isVtEnabledByPlatform(mContext);
615         boolean enabled = isEnhanced4gLteModeSettingEnabledByUser(mContext) &&
616                 isVtEnabledByUser(mContext);
617         boolean isNonTty = isNonTtyOrTtyOnVolteEnabled(mContext);
618         boolean isFeatureOn = available && enabled && isNonTty;
619
620         log("updateVideoCallFeatureValue: available = " + available
621                 + ", enabled = " + enabled
622                 + ", nonTTY = " + isNonTty);
623
624         getConfigInterface().setFeatureValue(
625                 ImsConfig.FeatureConstants.FEATURE_TYPE_VIDEO_OVER_LTE,
626                 TelephonyManager.NETWORK_TYPE_LTE,
627                 isFeatureOn ?
628                         ImsConfig.FeatureValueConstants.ON :
629                         ImsConfig.FeatureValueConstants.OFF,
630                 mImsConfigListener);
631
632         return isFeatureOn;
633     }
634
635     /**
636      * Update WFC config
637      * @return whether feature is On
638      * @throws ImsException
639      */
640     private boolean updateWfcFeatureAndProvisionedValues() throws ImsException {
641         boolean available = isWfcEnabledByPlatform(mContext);
642         boolean enabled = isWfcEnabledByUser(mContext);
643         int mode = getWfcMode(mContext);
644         boolean roaming = isWfcRoamingEnabledByUser(mContext);
645         boolean isFeatureOn = available && enabled;
646
647         log("updateWfcFeatureAndProvisionedValues: available = " + available
648                 + ", enabled = " + enabled
649                 + ", mode = " + mode
650                 + ", roaming = " + roaming);
651
652         getConfigInterface().setFeatureValue(
653                 ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_WIFI,
654                 TelephonyManager.NETWORK_TYPE_IWLAN,
655                 isFeatureOn ?
656                         ImsConfig.FeatureValueConstants.ON :
657                         ImsConfig.FeatureValueConstants.OFF,
658                 mImsConfigListener);
659
660         if (!isFeatureOn) {
661             mode = ImsConfig.WfcModeFeatureValueConstants.CELLULAR_PREFERRED;
662             roaming = false;
663         }
664         setWfcModeInternal(mContext, mode);
665         setWfcRoamingSettingInternal(mContext, roaming);
666
667         return isFeatureOn;
668     }
669
670     private ImsManager(Context context, int phoneId) {
671         mContext = context;
672         mPhoneId = phoneId;
673         createImsService(true);
674     }
675
676     /*
677      * Returns a flag indicating whether the IMS service is available.
678      */
679     public boolean isServiceAvailable() {
680         if (mImsService != null) {
681             return true;
682         }
683
684         IBinder binder = ServiceManager.checkService(getImsServiceName(mPhoneId));
685         if (binder != null) {
686             return true;
687         }
688
689         return false;
690     }
691
692     public void setImsConfigListener(ImsConfigListener listener) {
693         mImsConfigListener = listener;
694     }
695
696     /**
697      * Opens the IMS service for making calls and/or receiving generic IMS calls.
698      * The caller may make subsquent calls through {@link #makeCall}.
699      * The IMS service will register the device to the operator's network with the credentials
700      * (from ISIM) periodically in order to receive calls from the operator's network.
701      * When the IMS service receives a new call, it will send out an intent with
702      * the provided action string.
703      * The intent contains a call ID extra {@link getCallId} and it can be used to take a call.
704      *
705      * @param serviceClass a service class specified in {@link ImsServiceClass}
706      *      For VoLTE service, it MUST be a {@link ImsServiceClass#MMTEL}.
707      * @param incomingCallPendingIntent When an incoming call is received,
708      *        the IMS service will call {@link PendingIntent#send(Context, int, Intent)} to
709      *        send back the intent to the caller with {@link #INCOMING_CALL_RESULT_CODE}
710      *        as the result code and the intent to fill in the call ID; It cannot be null
711      * @param listener To listen to IMS registration events; It cannot be null
712      * @return identifier (greater than 0) for the specified service
713      * @throws NullPointerException if {@code incomingCallPendingIntent}
714      *      or {@code listener} is null
715      * @throws ImsException if calling the IMS service results in an error
716      * @see #getCallId
717      * @see #getServiceId
718      */
719     public int open(int serviceClass, PendingIntent incomingCallPendingIntent,
720             ImsConnectionStateListener listener) throws ImsException {
721         checkAndThrowExceptionIfServiceUnavailable();
722
723         if (incomingCallPendingIntent == null) {
724             throw new NullPointerException("incomingCallPendingIntent can't be null");
725         }
726
727         if (listener == null) {
728             throw new NullPointerException("listener can't be null");
729         }
730
731         int result = 0;
732
733         try {
734             result = mImsService.open(mPhoneId, serviceClass, incomingCallPendingIntent,
735                     createRegistrationListenerProxy(serviceClass, listener));
736         } catch (RemoteException e) {
737             throw new ImsException("open()", e,
738                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
739         }
740
741         if (result <= 0) {
742             // If the return value is a minus value,
743             // it means that an error occurred in the service.
744             // So, it needs to convert to the reason code specified in ImsReasonInfo.
745             throw new ImsException("open()", (result * (-1)));
746         }
747
748         return result;
749     }
750
751     /**
752      * Closes the specified service ({@link ImsServiceClass}) not to make/receive calls.
753      * All the resources that were allocated to the service are also released.
754      *
755      * @param serviceId a service id to be closed which is obtained from {@link ImsManager#open}
756      * @throws ImsException if calling the IMS service results in an error
757      */
758     public void close(int serviceId) throws ImsException {
759         checkAndThrowExceptionIfServiceUnavailable();
760
761         try {
762             mImsService.close(serviceId);
763         } catch (RemoteException e) {
764             throw new ImsException("close()", e,
765                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
766         } finally {
767             mUt = null;
768             mConfig = null;
769             mEcbm = null;
770             mMultiEndpoint = null;
771         }
772     }
773
774     /**
775      * Gets the configuration interface to provision / withdraw the supplementary service settings.
776      *
777      * @param serviceId a service id which is obtained from {@link ImsManager#open}
778      * @return the Ut interface instance
779      * @throws ImsException if getting the Ut interface results in an error
780      */
781     public ImsUtInterface getSupplementaryServiceConfiguration(int serviceId)
782             throws ImsException {
783         // FIXME: manage the multiple Ut interfaces based on the service id
784         if (mUt == null) {
785             checkAndThrowExceptionIfServiceUnavailable();
786
787             try {
788                 IImsUt iUt = mImsService.getUtInterface(serviceId);
789
790                 if (iUt == null) {
791                     throw new ImsException("getSupplementaryServiceConfiguration()",
792                             ImsReasonInfo.CODE_UT_NOT_SUPPORTED);
793                 }
794
795                 mUt = new ImsUt(iUt);
796             } catch (RemoteException e) {
797                 throw new ImsException("getSupplementaryServiceConfiguration()", e,
798                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
799             }
800         }
801
802         return mUt;
803     }
804
805     /**
806      * Checks if the IMS service has successfully registered to the IMS network
807      * with the specified service & call type.
808      *
809      * @param serviceId a service id which is obtained from {@link ImsManager#open}
810      * @param serviceType a service type that is specified in {@link ImsCallProfile}
811      *        {@link ImsCallProfile#SERVICE_TYPE_NORMAL}
812      *        {@link ImsCallProfile#SERVICE_TYPE_EMERGENCY}
813      * @param callType a call type that is specified in {@link ImsCallProfile}
814      *        {@link ImsCallProfile#CALL_TYPE_VOICE_N_VIDEO}
815      *        {@link ImsCallProfile#CALL_TYPE_VOICE}
816      *        {@link ImsCallProfile#CALL_TYPE_VT}
817      *        {@link ImsCallProfile#CALL_TYPE_VS}
818      * @return true if the specified service id is connected to the IMS network;
819      *        false otherwise
820      * @throws ImsException if calling the IMS service results in an error
821      */
822     public boolean isConnected(int serviceId, int serviceType, int callType)
823             throws ImsException {
824         checkAndThrowExceptionIfServiceUnavailable();
825
826         try {
827             return mImsService.isConnected(serviceId, serviceType, callType);
828         } catch (RemoteException e) {
829             throw new ImsException("isServiceConnected()", e,
830                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
831         }
832     }
833
834     /**
835      * Checks if the specified IMS service is opend.
836      *
837      * @param serviceId a service id which is obtained from {@link ImsManager#open}
838      * @return true if the specified service id is opened; false otherwise
839      * @throws ImsException if calling the IMS service results in an error
840      */
841     public boolean isOpened(int serviceId) throws ImsException {
842         checkAndThrowExceptionIfServiceUnavailable();
843
844         try {
845             return mImsService.isOpened(serviceId);
846         } catch (RemoteException e) {
847             throw new ImsException("isOpened()", e,
848                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
849         }
850     }
851
852     /**
853      * Creates a {@link ImsCallProfile} from the service capabilities & IMS registration state.
854      *
855      * @param serviceId a service id which is obtained from {@link ImsManager#open}
856      * @param serviceType a service type that is specified in {@link ImsCallProfile}
857      *        {@link ImsCallProfile#SERVICE_TYPE_NONE}
858      *        {@link ImsCallProfile#SERVICE_TYPE_NORMAL}
859      *        {@link ImsCallProfile#SERVICE_TYPE_EMERGENCY}
860      * @param callType a call type that is specified in {@link ImsCallProfile}
861      *        {@link ImsCallProfile#CALL_TYPE_VOICE}
862      *        {@link ImsCallProfile#CALL_TYPE_VT}
863      *        {@link ImsCallProfile#CALL_TYPE_VT_TX}
864      *        {@link ImsCallProfile#CALL_TYPE_VT_RX}
865      *        {@link ImsCallProfile#CALL_TYPE_VT_NODIR}
866      *        {@link ImsCallProfile#CALL_TYPE_VS}
867      *        {@link ImsCallProfile#CALL_TYPE_VS_TX}
868      *        {@link ImsCallProfile#CALL_TYPE_VS_RX}
869      * @return a {@link ImsCallProfile} object
870      * @throws ImsException if calling the IMS service results in an error
871      */
872     public ImsCallProfile createCallProfile(int serviceId,
873             int serviceType, int callType) throws ImsException {
874         checkAndThrowExceptionIfServiceUnavailable();
875
876         try {
877             return mImsService.createCallProfile(serviceId, serviceType, callType);
878         } catch (RemoteException e) {
879             throw new ImsException("createCallProfile()", e,
880                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
881         }
882     }
883
884     /**
885      * Creates a {@link ImsCall} to make a call.
886      *
887      * @param serviceId a service id which is obtained from {@link ImsManager#open}
888      * @param profile a call profile to make the call
889      *      (it contains service type, call type, media information, etc.)
890      * @param participants participants to invite the conference call
891      * @param listener listen to the call events from {@link ImsCall}
892      * @return a {@link ImsCall} object
893      * @throws ImsException if calling the IMS service results in an error
894      */
895     public ImsCall makeCall(int serviceId, ImsCallProfile profile, String[] callees,
896             ImsCall.Listener listener) throws ImsException {
897         if (DBG) {
898             log("makeCall :: serviceId=" + serviceId
899                     + ", profile=" + profile + ", callees=" + callees);
900         }
901
902         checkAndThrowExceptionIfServiceUnavailable();
903
904         ImsCall call = new ImsCall(mContext, profile);
905
906         call.setListener(listener);
907         ImsCallSession session = createCallSession(serviceId, profile);
908
909         if ((callees != null) && (callees.length == 1)) {
910             call.start(session, callees[0]);
911         } else {
912             call.start(session, callees);
913         }
914
915         return call;
916     }
917
918     /**
919      * Creates a {@link ImsCall} to take an incoming call.
920      *
921      * @param serviceId a service id which is obtained from {@link ImsManager#open}
922      * @param incomingCallIntent the incoming call broadcast intent
923      * @param listener to listen to the call events from {@link ImsCall}
924      * @return a {@link ImsCall} object
925      * @throws ImsException if calling the IMS service results in an error
926      */
927     public ImsCall takeCall(int serviceId, Intent incomingCallIntent,
928             ImsCall.Listener listener) throws ImsException {
929         if (DBG) {
930             log("takeCall :: serviceId=" + serviceId
931                     + ", incomingCall=" + incomingCallIntent);
932         }
933
934         checkAndThrowExceptionIfServiceUnavailable();
935
936         if (incomingCallIntent == null) {
937             throw new ImsException("Can't retrieve session with null intent",
938                     ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
939         }
940
941         int incomingServiceId = getServiceId(incomingCallIntent);
942
943         if (serviceId != incomingServiceId) {
944             throw new ImsException("Service id is mismatched in the incoming call intent",
945                     ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
946         }
947
948         String callId = getCallId(incomingCallIntent);
949
950         if (callId == null) {
951             throw new ImsException("Call ID missing in the incoming call intent",
952                     ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
953         }
954
955         try {
956             IImsCallSession session = mImsService.getPendingCallSession(serviceId, callId);
957
958             if (session == null) {
959                 throw new ImsException("No pending session for the call",
960                         ImsReasonInfo.CODE_LOCAL_NO_PENDING_CALL);
961             }
962
963             ImsCall call = new ImsCall(mContext, session.getCallProfile());
964
965             call.attachSession(new ImsCallSession(session));
966             call.setListener(listener);
967
968             return call;
969         } catch (Throwable t) {
970             throw new ImsException("takeCall()", t, ImsReasonInfo.CODE_UNSPECIFIED);
971         }
972     }
973
974     /**
975      * Gets the config interface to get/set service/capability parameters.
976      *
977      * @return the ImsConfig instance.
978      * @throws ImsException if getting the setting interface results in an error.
979      */
980     public ImsConfig getConfigInterface() throws ImsException {
981
982         if (mConfig == null) {
983             checkAndThrowExceptionIfServiceUnavailable();
984
985             try {
986                 IImsConfig config = mImsService.getConfigInterface(mPhoneId);
987                 if (config == null) {
988                     throw new ImsException("getConfigInterface()",
989                             ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
990                 }
991                 mConfig = new ImsConfig(config, mContext);
992             } catch (RemoteException e) {
993                 throw new ImsException("getConfigInterface()", e,
994                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
995             }
996         }
997         if (DBG) log("getConfigInterface(), mConfig= " + mConfig);
998         return mConfig;
999     }
1000
1001     public void setUiTTYMode(Context context, int serviceId, int uiTtyMode, Message onComplete)
1002             throws ImsException {
1003
1004         checkAndThrowExceptionIfServiceUnavailable();
1005
1006         try {
1007             mImsService.setUiTTYMode(serviceId, uiTtyMode, onComplete);
1008         } catch (RemoteException e) {
1009             throw new ImsException("setTTYMode()", e,
1010                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1011         }
1012
1013         if (!getBooleanCarrierConfig(context,
1014                 CarrierConfigManager.KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL)) {
1015             setAdvanced4GMode((uiTtyMode == TelecomManager.TTY_MODE_OFF) &&
1016                     isEnhanced4gLteModeSettingEnabledByUser(context));
1017         }
1018     }
1019
1020     /**
1021      * Get the boolean config from carrier config manager.
1022      *
1023      * @param context the context to get carrier service
1024      * @param key config key defined in CarrierConfigManager
1025      * @return boolean value of corresponding key.
1026      */
1027     private static boolean getBooleanCarrierConfig(Context context, String key) {
1028         CarrierConfigManager configManager = (CarrierConfigManager) context.getSystemService(
1029                 Context.CARRIER_CONFIG_SERVICE);
1030         PersistableBundle b = null;
1031         if (configManager != null) {
1032             b = configManager.getConfig();
1033         }
1034         if (b != null) {
1035             return b.getBoolean(key);
1036         } else {
1037             // Return static default defined in CarrierConfigManager.
1038             return CarrierConfigManager.getDefaultConfig().getBoolean(key);
1039         }
1040     }
1041
1042     /**
1043      * Get the int config from carrier config manager.
1044      *
1045      * @param context the context to get carrier service
1046      * @param key config key defined in CarrierConfigManager
1047      * @return integer value of corresponding key.
1048      */
1049     private static int getIntCarrierConfig(Context context, String key) {
1050         CarrierConfigManager configManager = (CarrierConfigManager) context.getSystemService(
1051                 Context.CARRIER_CONFIG_SERVICE);
1052         PersistableBundle b = null;
1053         if (configManager != null) {
1054             b = configManager.getConfig();
1055         }
1056         if (b != null) {
1057             return b.getInt(key);
1058         } else {
1059             // Return static default defined in CarrierConfigManager.
1060             return CarrierConfigManager.getDefaultConfig().getInt(key);
1061         }
1062     }
1063
1064     /**
1065      * Gets the call ID from the specified incoming call broadcast intent.
1066      *
1067      * @param incomingCallIntent the incoming call broadcast intent
1068      * @return the call ID or null if the intent does not contain it
1069      */
1070     private static String getCallId(Intent incomingCallIntent) {
1071         if (incomingCallIntent == null) {
1072             return null;
1073         }
1074
1075         return incomingCallIntent.getStringExtra(EXTRA_CALL_ID);
1076     }
1077
1078     /**
1079      * Gets the service type from the specified incoming call broadcast intent.
1080      *
1081      * @param incomingCallIntent the incoming call broadcast intent
1082      * @return the service identifier or -1 if the intent does not contain it
1083      */
1084     private static int getServiceId(Intent incomingCallIntent) {
1085         if (incomingCallIntent == null) {
1086             return (-1);
1087         }
1088
1089         return incomingCallIntent.getIntExtra(EXTRA_SERVICE_ID, -1);
1090     }
1091
1092     /**
1093      * Binds the IMS service only if the service is not created.
1094      */
1095     private void checkAndThrowExceptionIfServiceUnavailable()
1096             throws ImsException {
1097         if (mImsService == null) {
1098             createImsService(true);
1099
1100             if (mImsService == null) {
1101                 throw new ImsException("Service is unavailable",
1102                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1103             }
1104         }
1105     }
1106
1107     private static String getImsServiceName(int phoneId) {
1108         // TODO: MSIM implementation needs to decide on service name as a function of phoneId
1109         return IMS_SERVICE;
1110     }
1111
1112     /**
1113      * Binds the IMS service to make/receive the call.
1114      */
1115     private void createImsService(boolean checkService) {
1116         if (checkService) {
1117             IBinder binder = ServiceManager.checkService(getImsServiceName(mPhoneId));
1118
1119             if (binder == null) {
1120                 return;
1121             }
1122         }
1123
1124         IBinder b = ServiceManager.getService(getImsServiceName(mPhoneId));
1125
1126         if (b != null) {
1127             try {
1128                 b.linkToDeath(mDeathRecipient, 0);
1129             } catch (RemoteException e) {
1130             }
1131         }
1132
1133         mImsService = IImsService.Stub.asInterface(b);
1134     }
1135
1136     /**
1137      * Creates a {@link ImsCallSession} with the specified call profile.
1138      * Use other methods, if applicable, instead of interacting with
1139      * {@link ImsCallSession} directly.
1140      *
1141      * @param serviceId a service id which is obtained from {@link ImsManager#open}
1142      * @param profile a call profile to make the call
1143      */
1144     private ImsCallSession createCallSession(int serviceId,
1145             ImsCallProfile profile) throws ImsException {
1146         try {
1147             return new ImsCallSession(mImsService.createCallSession(serviceId, profile, null));
1148         } catch (RemoteException e) {
1149             return null;
1150         }
1151     }
1152
1153     private ImsRegistrationListenerProxy createRegistrationListenerProxy(int serviceClass,
1154             ImsConnectionStateListener listener) {
1155         ImsRegistrationListenerProxy proxy =
1156                 new ImsRegistrationListenerProxy(serviceClass, listener);
1157         return proxy;
1158     }
1159
1160     private static void log(String s) {
1161         Rlog.d(TAG, s);
1162     }
1163
1164     private static void loge(String s) {
1165         Rlog.e(TAG, s);
1166     }
1167
1168     private static void loge(String s, Throwable t) {
1169         Rlog.e(TAG, s, t);
1170     }
1171
1172     /**
1173      * Used for turning on IMS.if its off already
1174      */
1175     private void turnOnIms() throws ImsException {
1176         checkAndThrowExceptionIfServiceUnavailable();
1177
1178         try {
1179             mImsService.turnOnIms(mPhoneId);
1180         } catch (RemoteException e) {
1181             throw new ImsException("turnOnIms() ", e, ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1182         }
1183     }
1184
1185     private boolean isImsTurnOffAllowed() {
1186         return getBooleanCarrierConfig(mContext,
1187                 CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)
1188                 && (!isWfcEnabledByPlatform(mContext)
1189                 || !isWfcEnabledByUser(mContext));
1190     }
1191
1192     private void setAdvanced4GMode(boolean turnOn) throws ImsException {
1193         checkAndThrowExceptionIfServiceUnavailable();
1194
1195         try {
1196             ImsConfig config = getConfigInterface();
1197             if (config != null && (turnOn || !isImsTurnOffAllowed())) {
1198                 config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_LTE,
1199                         TelephonyManager.NETWORK_TYPE_LTE, turnOn ? 1 : 0, mImsConfigListener);
1200             }
1201         } catch (ImsException e) {
1202             log("setAdvanced4GMode() : " + e);
1203         }
1204         if (turnOn) {
1205             turnOnIms();
1206         } else if (isImsTurnOffAllowed()) {
1207             log("setAdvanced4GMode() : imsServiceAllowTurnOff -> turnOffIms");
1208             turnOffIms();
1209         }
1210     }
1211
1212     /**
1213      * Used for turning off IMS completely in order to make the device CSFB'ed.
1214      * Once turned off, all calls will be over CS.
1215      */
1216     private void turnOffIms() throws ImsException {
1217         checkAndThrowExceptionIfServiceUnavailable();
1218
1219         try {
1220             mImsService.turnOffIms(mPhoneId);
1221         } catch (RemoteException e) {
1222             throw new ImsException("turnOffIms() ", e, ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1223         }
1224     }
1225
1226     /**
1227      * Death recipient class for monitoring IMS service.
1228      */
1229     private class ImsServiceDeathRecipient implements IBinder.DeathRecipient {
1230         @Override
1231         public void binderDied() {
1232             mImsService = null;
1233             mUt = null;
1234             mConfig = null;
1235             mEcbm = null;
1236             mMultiEndpoint = null;
1237
1238             if (mContext != null) {
1239                 Intent intent = new Intent(ACTION_IMS_SERVICE_DOWN);
1240                 intent.putExtra(EXTRA_PHONE_ID, mPhoneId);
1241                 mContext.sendBroadcast(new Intent(intent));
1242             }
1243         }
1244     }
1245
1246     /**
1247      * Adapter class for {@link IImsRegistrationListener}.
1248      */
1249     private class ImsRegistrationListenerProxy extends IImsRegistrationListener.Stub {
1250         private int mServiceClass;
1251         private ImsConnectionStateListener mListener;
1252
1253         public ImsRegistrationListenerProxy(int serviceClass,
1254                 ImsConnectionStateListener listener) {
1255             mServiceClass = serviceClass;
1256             mListener = listener;
1257         }
1258
1259         public boolean isSameProxy(int serviceClass) {
1260             return (mServiceClass == serviceClass);
1261         }
1262
1263         @Deprecated
1264         public void registrationConnected() {
1265             if (DBG) {
1266                 log("registrationConnected ::");
1267             }
1268
1269             if (mListener != null) {
1270                 mListener.onImsConnected();
1271             }
1272         }
1273
1274         @Deprecated
1275         public void registrationProgressing() {
1276             if (DBG) {
1277                 log("registrationProgressing ::");
1278             }
1279
1280             if (mListener != null) {
1281                 mListener.onImsProgressing();
1282             }
1283         }
1284
1285         @Override
1286         public void registrationConnectedWithRadioTech(int imsRadioTech) {
1287             // Note: imsRadioTech value maps to RIL_RADIO_TECHNOLOGY
1288             //       values in ServiceState.java.
1289             if (DBG) {
1290                 log("registrationConnectedWithRadioTech :: imsRadioTech=" + imsRadioTech);
1291             }
1292
1293             if (mListener != null) {
1294                 mListener.onImsConnected();
1295             }
1296         }
1297
1298         @Override
1299         public void registrationProgressingWithRadioTech(int imsRadioTech) {
1300             // Note: imsRadioTech value maps to RIL_RADIO_TECHNOLOGY
1301             //       values in ServiceState.java.
1302             if (DBG) {
1303                 log("registrationProgressingWithRadioTech :: imsRadioTech=" + imsRadioTech);
1304             }
1305
1306             if (mListener != null) {
1307                 mListener.onImsProgressing();
1308             }
1309         }
1310
1311         @Override
1312         public void registrationDisconnected(ImsReasonInfo imsReasonInfo) {
1313             if (DBG) {
1314                 log("registrationDisconnected :: imsReasonInfo" + imsReasonInfo);
1315             }
1316
1317             if (mListener != null) {
1318                 mListener.onImsDisconnected(imsReasonInfo);
1319             }
1320         }
1321
1322         @Override
1323         public void registrationResumed() {
1324             if (DBG) {
1325                 log("registrationResumed ::");
1326             }
1327
1328             if (mListener != null) {
1329                 mListener.onImsResumed();
1330             }
1331         }
1332
1333         @Override
1334         public void registrationSuspended() {
1335             if (DBG) {
1336                 log("registrationSuspended ::");
1337             }
1338
1339             if (mListener != null) {
1340                 mListener.onImsSuspended();
1341             }
1342         }
1343
1344         @Override
1345         public void registrationServiceCapabilityChanged(int serviceClass, int event) {
1346             log("registrationServiceCapabilityChanged :: serviceClass=" +
1347                     serviceClass + ", event=" + event);
1348
1349             if (mListener != null) {
1350                 mListener.onImsConnected();
1351             }
1352         }
1353
1354         @Override
1355         public void registrationFeatureCapabilityChanged(int serviceClass,
1356                 int[] enabledFeatures, int[] disabledFeatures) {
1357             log("registrationFeatureCapabilityChanged :: serviceClass=" +
1358                     serviceClass);
1359             if (mListener != null) {
1360                 mListener.onFeatureCapabilityChanged(serviceClass,
1361                         enabledFeatures, disabledFeatures);
1362             }
1363         }
1364
1365         @Override
1366         public void voiceMessageCountUpdate(int count) {
1367             log("voiceMessageCountUpdate :: count=" + count);
1368
1369             if (mListener != null) {
1370                 mListener.onVoiceMessageCountChanged(count);
1371             }
1372         }
1373
1374         @Override
1375         public void registrationAssociatedUriChanged(Uri[] uris) {
1376             if (DBG) log("registrationAssociatedUriChanged ::");
1377
1378             if (mListener != null) {
1379                 mListener.registrationAssociatedUriChanged(uris);
1380             }
1381         }
1382     }
1383
1384     /**
1385      * Gets the ECBM interface to request ECBM exit.
1386      *
1387      * @param serviceId a service id which is obtained from {@link ImsManager#open}
1388      * @return the ECBM interface instance
1389      * @throws ImsException if getting the ECBM interface results in an error
1390      */
1391     public ImsEcbm getEcbmInterface(int serviceId) throws ImsException {
1392         if (mEcbm == null) {
1393             checkAndThrowExceptionIfServiceUnavailable();
1394
1395             try {
1396                 IImsEcbm iEcbm = mImsService.getEcbmInterface(serviceId);
1397
1398                 if (iEcbm == null) {
1399                     throw new ImsException("getEcbmInterface()",
1400                             ImsReasonInfo.CODE_ECBM_NOT_SUPPORTED);
1401                 }
1402                 mEcbm = new ImsEcbm(iEcbm);
1403             } catch (RemoteException e) {
1404                 throw new ImsException("getEcbmInterface()", e,
1405                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1406             }
1407         }
1408         return mEcbm;
1409     }
1410
1411     /**
1412      * Gets the Multi-Endpoint interface to subscribe to multi-enpoint notifications..
1413      *
1414      * @param serviceId a service id which is obtained from {@link ImsManager#open}
1415      * @return the multi-endpoint interface instance
1416      * @throws ImsException if getting the multi-endpoint interface results in an error
1417      */
1418     public ImsMultiEndpoint getMultiEndpointInterface(int serviceId) throws ImsException {
1419         if (mMultiEndpoint == null) {
1420             checkAndThrowExceptionIfServiceUnavailable();
1421
1422             try {
1423                 IImsMultiEndpoint iImsMultiEndpoint = mImsService.getMultiEndpointInterface(
1424                         serviceId);
1425
1426                 if (iImsMultiEndpoint == null) {
1427                     throw new ImsException("getMultiEndpointInterface()",
1428                             ImsReasonInfo.CODE_MULTIENDPOINT_NOT_SUPPORTED);
1429                 }
1430                 mMultiEndpoint = new ImsMultiEndpoint(iImsMultiEndpoint);
1431             } catch (RemoteException e) {
1432                 throw new ImsException("getMultiEndpointInterface()", e,
1433                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1434             }
1435         }
1436         return mMultiEndpoint;
1437     }
1438
1439     /**
1440      * Resets ImsManager settings back to factory defaults.
1441      *
1442      * @hide
1443      */
1444     public static void factoryReset(Context context) {
1445         // Set VoLTE to default
1446         android.provider.Settings.Global.putInt(context.getContentResolver(),
1447                 android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED,
1448                 ImsConfig.FeatureValueConstants.ON);
1449
1450         // Set VoWiFi to default
1451         android.provider.Settings.Global.putInt(context.getContentResolver(),
1452                 android.provider.Settings.Global.WFC_IMS_ENABLED,
1453                 getBooleanCarrierConfig(context,
1454                         CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL) ?
1455                         ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
1456
1457         // Set VoWiFi mode to default
1458         android.provider.Settings.Global.putInt(context.getContentResolver(),
1459                 android.provider.Settings.Global.WFC_IMS_MODE,
1460                 getIntCarrierConfig(context,
1461                         CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT));
1462
1463         // Set VoWiFi roaming to default
1464         android.provider.Settings.Global.putInt(context.getContentResolver(),
1465                 android.provider.Settings.Global.WFC_IMS_ROAMING_ENABLED,
1466                 getBooleanCarrierConfig(context,
1467                         CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL) ?
1468                         ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
1469
1470         // Set VT to default
1471         android.provider.Settings.Global.putInt(context.getContentResolver(),
1472                 android.provider.Settings.Global.VT_IMS_ENABLED,
1473                 ImsConfig.FeatureValueConstants.ON);
1474
1475         // Push settings to ImsConfig
1476         ImsManager.updateImsServiceConfig(context,
1477                 SubscriptionManager.getDefaultVoicePhoneId(), true);
1478     }
1479
1480     public void dump(FileDescriptor fd, PrintWriter pw, String[] args) {
1481         pw.println("ImsManager:");
1482         pw.println("  mPhoneId = " + mPhoneId);
1483         pw.println("  mConfigUpdated = " + mConfigUpdated);
1484         pw.println("  mImsService = " + mImsService);
1485
1486         pw.println("  isGbaValid = " + isGbaValid(mContext));
1487         pw.println("  isImsTurnOffAllowed = " + isImsTurnOffAllowed());
1488         pw.println("  isNonTtyOrTtyOnVolteEnabled = " + isNonTtyOrTtyOnVolteEnabled(mContext));
1489
1490         pw.println("  isVolteEnabledByPlatform = " + isVolteEnabledByPlatform(mContext));
1491         pw.println("  isVolteProvisionedOnDevice = " + isVolteProvisionedOnDevice(mContext));
1492         pw.println("  isEnhanced4gLteModeSettingEnabledByUser = " +
1493                 isEnhanced4gLteModeSettingEnabledByUser(mContext));
1494         pw.println("  isVtEnabledByPlatform = " + isVtEnabledByPlatform(mContext));
1495         pw.println("  isVtEnabledByUser = " + isVtEnabledByUser(mContext));
1496
1497         pw.println("  isWfcEnabledByPlatform = " + isWfcEnabledByPlatform(mContext));
1498         pw.println("  isWfcEnabledByUser = " + isWfcEnabledByUser(mContext));
1499         pw.println("  getWfcMode = " + getWfcMode(mContext));
1500         pw.println("  isWfcRoamingEnabledByUser = " + isWfcRoamingEnabledByUser(mContext));
1501
1502         pw.flush();
1503     }
1504 }