Disable VoLTE if TTY is on and TTY is not supported over VoLTE
[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.os.IBinder;
23 import android.os.Message;
24 import android.os.RemoteException;
25 import android.os.ServiceManager;
26 import android.os.SystemProperties;
27 import android.provider.Settings;
28 import android.telecom.TelecomManager;
29 import android.telephony.Rlog;
30 import android.telephony.SubscriptionManager;
31 import android.telephony.TelephonyManager;
32
33 import com.android.ims.internal.IImsCallSession;
34 import com.android.ims.internal.IImsEcbm;
35 import com.android.ims.internal.IImsEcbmListener;
36 import com.android.ims.internal.IImsRegistrationListener;
37 import com.android.ims.internal.IImsService;
38 import com.android.ims.internal.IImsUt;
39 import com.android.ims.internal.ImsCallSession;
40 import com.android.ims.internal.IImsConfig;
41
42 import java.util.HashMap;
43
44 /**
45  * Provides APIs for IMS services, such as initiating IMS calls, and provides access to
46  * the operator's IMS network. This class is the starting point for any IMS actions.
47  * You can acquire an instance of it with {@link #getInstance getInstance()}.</p>
48  * <p>The APIs in this class allows you to:</p>
49  *
50  * @hide
51  */
52 public class ImsManager {
53
54     /*
55      * Debug flag to override configuration flag
56      */
57     public static final String PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE = "persist.dbg.volte_avail_ovr";
58     public static final int PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE_DEFAULT = 0;
59     public static final String PROPERTY_DBG_VT_AVAIL_OVERRIDE = "persist.dbg.vt_avail_ovr";
60     public static final int PROPERTY_DBG_VT_AVAIL_OVERRIDE_DEFAULT = 0;
61
62     /**
63      * For accessing the IMS related service.
64      * Internal use only.
65      * @hide
66      */
67     private static final String IMS_SERVICE = "ims";
68
69     /**
70      * The result code to be sent back with the incoming call {@link PendingIntent}.
71      * @see #open(PendingIntent, ImsConnectionStateListener)
72      */
73     public static final int INCOMING_CALL_RESULT_CODE = 101;
74
75     /**
76      * Key to retrieve the call ID from an incoming call intent.
77      * @see #open(PendingIntent, ImsConnectionStateListener)
78      */
79     public static final String EXTRA_CALL_ID = "android:imsCallID";
80
81     /**
82      * Action to broadcast when ImsService is up.
83      * Internal use only.
84      * @hide
85      */
86     public static final String ACTION_IMS_SERVICE_UP =
87             "com.android.ims.IMS_SERVICE_UP";
88
89     /**
90      * Action to broadcast when ImsService is down.
91      * Internal use only.
92      * @hide
93      */
94     public static final String ACTION_IMS_SERVICE_DOWN =
95             "com.android.ims.IMS_SERVICE_DOWN";
96
97     /**
98      * Part of the ACTION_IMS_SERVICE_UP or _DOWN intents.
99      * A long value; the phone ID corresponding to the IMS service coming up or down.
100      * Internal use only.
101      * @hide
102      */
103     public static final String EXTRA_PHONE_ID = "android:phone_id";
104
105     /**
106      * Action for the incoming call intent for the Phone app.
107      * Internal use only.
108      * @hide
109      */
110     public static final String ACTION_IMS_INCOMING_CALL =
111             "com.android.ims.IMS_INCOMING_CALL";
112
113     /**
114      * Part of the ACTION_IMS_INCOMING_CALL intents.
115      * An integer value; service identifier obtained from {@link ImsManager#open}.
116      * Internal use only.
117      * @hide
118      */
119     public static final String EXTRA_SERVICE_ID = "android:imsServiceId";
120
121     /**
122      * Part of the ACTION_IMS_INCOMING_CALL intents.
123      * An boolean value; Flag to indicate that the incoming call is a normal call or call for USSD.
124      * The value "true" indicates that the incoming call is for USSD.
125      * Internal use only.
126      * @hide
127      */
128     public static final String EXTRA_USSD = "android:ussd";
129
130     private static final String TAG = "ImsManager";
131     private static final boolean DBG = true;
132
133     private static HashMap<Integer, ImsManager> sImsManagerInstances =
134             new HashMap<Integer, ImsManager>();
135
136     private Context mContext;
137     private int mPhoneId;
138     private IImsService mImsService = null;
139     private ImsServiceDeathRecipient mDeathRecipient = new ImsServiceDeathRecipient();
140     // Ut interface for the supplementary service configuration
141     private ImsUt mUt = null;
142     // Interface to get/set ims config items
143     private ImsConfig mConfig = null;
144
145     // ECBM interface
146     private ImsEcbm mEcbm = null;
147
148     /**
149      * Gets a manager instance.
150      *
151      * @param context application context for creating the manager object
152      * @param phoneId the phone ID for the IMS Service
153      * @return the manager instance corresponding to the phoneId
154      */
155     public static ImsManager getInstance(Context context, int phoneId) {
156         synchronized (sImsManagerInstances) {
157             if (sImsManagerInstances.containsKey(phoneId))
158                 return sImsManagerInstances.get(phoneId);
159
160             ImsManager mgr = new ImsManager(context, phoneId);
161             sImsManagerInstances.put(phoneId, mgr);
162
163             return mgr;
164         }
165     }
166
167     /**
168      * Returns the user configuration of Enhanced 4G LTE Mode setting
169      */
170     public static boolean isEnhanced4gLteModeSettingEnabledByUser(Context context) {
171         int enabled = android.provider.Settings.Global.getInt(
172                     context.getContentResolver(),
173                     android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED, ImsConfig.FeatureValueConstants.ON);
174         return (enabled == 1)? true:false;
175     }
176
177     /**
178      * Change persistent Enhanced 4G LTE Mode setting
179      */
180     public static void setEnhanced4gLteModeSetting(Context context, boolean enabled) {
181         int value = enabled ? 1 : 0;
182         android.provider.Settings.Global.putInt(
183                 context.getContentResolver(),
184                 android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED, value);
185
186         if (isNonTtyOrTtyOnVolteEnabled(context)) {
187             ImsManager imsManager = ImsManager.getInstance(context,
188                     SubscriptionManager.getDefaultVoicePhoneId());
189             if (imsManager != null) {
190                 try {
191                     imsManager.setAdvanced4GMode(enabled);
192                 } catch (ImsException ie) {
193                     // do nothing
194                 }
195             }
196         }
197     }
198
199     /**
200      * Indicates whether the call is non-TTY or if TTY - whether TTY on VoLTE is
201      * supported.
202      */
203     public static boolean isNonTtyOrTtyOnVolteEnabled(Context context) {
204         if (context.getResources().getBoolean(
205                 com.android.internal.R.bool.config_carrier_volte_tty_supported)) {
206             return true;
207         }
208
209         return Settings.Secure.getInt(context.getContentResolver(),
210                 Settings.Secure.PREFERRED_TTY_MODE, TelecomManager.TTY_MODE_OFF)
211                 == TelecomManager.TTY_MODE_OFF;
212     }
213
214     /**
215      * Returns a platform configuration for VoLTE which may override the user setting.
216      */
217     public static boolean isVolteEnabledByPlatform(Context context) {
218         if (SystemProperties.getInt(PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE,
219                 PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE_DEFAULT) == 1) {
220             return true;
221         }
222
223         boolean disabledByGlobalSetting = android.provider.Settings.Global.getInt(
224                 context.getContentResolver(),
225                 android.provider.Settings.Global.VOLTE_FEATURE_DISABLED, 0) == 1;
226
227         return
228                 context.getResources().getBoolean(
229                         com.android.internal.R.bool.config_device_volte_available) &&
230                 context.getResources().getBoolean(
231                         com.android.internal.R.bool.config_carrier_volte_available) &&
232                 !disabledByGlobalSetting;
233     }
234
235     /**
236      * Returns a platform configuration for VT which may override the user setting.
237      *
238      * Note: VT presumes that VoLTE is enabled (these are configuration settings
239      * which must be done correctly).
240      */
241     public static boolean isVtEnabledByPlatform(Context context) {
242         if (SystemProperties.getInt(PROPERTY_DBG_VT_AVAIL_OVERRIDE,
243                 PROPERTY_DBG_VT_AVAIL_OVERRIDE_DEFAULT) == 1) {
244             return true;
245         }
246
247         return
248                 context.getResources().getBoolean(
249                         com.android.internal.R.bool.config_device_vt_available) &&
250                 context.getResources().getBoolean(
251                         com.android.internal.R.bool.config_carrier_vt_available);
252     }
253
254     private ImsManager(Context context, int phoneId) {
255         mContext = context;
256         mPhoneId = phoneId;
257         createImsService(true);
258     }
259
260     /**
261      * Opens the IMS service for making calls and/or receiving generic IMS calls.
262      * The caller may make subsquent calls through {@link #makeCall}.
263      * The IMS service will register the device to the operator's network with the credentials
264      * (from ISIM) periodically in order to receive calls from the operator's network.
265      * When the IMS service receives a new call, it will send out an intent with
266      * the provided action string.
267      * The intent contains a call ID extra {@link getCallId} and it can be used to take a call.
268      *
269      * @param serviceClass a service class specified in {@link ImsServiceClass}
270      *      For VoLTE service, it MUST be a {@link ImsServiceClass#MMTEL}.
271      * @param incomingCallPendingIntent When an incoming call is received,
272      *        the IMS service will call {@link PendingIntent#send(Context, int, Intent)} to
273      *        send back the intent to the caller with {@link #INCOMING_CALL_RESULT_CODE}
274      *        as the result code and the intent to fill in the call ID; It cannot be null
275      * @param listener To listen to IMS registration events; It cannot be null
276      * @return identifier (greater than 0) for the specified service
277      * @throws NullPointerException if {@code incomingCallPendingIntent}
278      *      or {@code listener} is null
279      * @throws ImsException if calling the IMS service results in an error
280      * @see #getCallId
281      * @see #getServiceId
282      */
283     public int open(int serviceClass, PendingIntent incomingCallPendingIntent,
284             ImsConnectionStateListener listener) throws ImsException {
285         checkAndThrowExceptionIfServiceUnavailable();
286
287         if (incomingCallPendingIntent == null) {
288             throw new NullPointerException("incomingCallPendingIntent can't be null");
289         }
290
291         if (listener == null) {
292             throw new NullPointerException("listener can't be null");
293         }
294
295         int result = 0;
296
297         try {
298             result = mImsService.open(mPhoneId, serviceClass, incomingCallPendingIntent,
299                     createRegistrationListenerProxy(serviceClass, listener));
300         } catch (RemoteException e) {
301             throw new ImsException("open()", e,
302                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
303         }
304
305         if (result <= 0) {
306             // If the return value is a minus value,
307             // it means that an error occurred in the service.
308             // So, it needs to convert to the reason code specified in ImsReasonInfo.
309             throw new ImsException("open()", (result * (-1)));
310         }
311
312         return result;
313     }
314
315     /**
316      * Closes the specified service ({@link ImsServiceClass}) not to make/receive calls.
317      * All the resources that were allocated to the service are also released.
318      *
319      * @param serviceId a service id to be closed which is obtained from {@link ImsManager#open}
320      * @throws ImsException if calling the IMS service results in an error
321      */
322     public void close(int serviceId) throws ImsException {
323         checkAndThrowExceptionIfServiceUnavailable();
324
325         try {
326             mImsService.close(serviceId);
327         } catch (RemoteException e) {
328             throw new ImsException("close()", e,
329                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
330         } finally {
331             mUt = null;
332             mConfig = null;
333             mEcbm = null;
334         }
335     }
336
337     /**
338      * Gets the configuration interface to provision / withdraw the supplementary service settings.
339      *
340      * @param serviceId a service id which is obtained from {@link ImsManager#open}
341      * @return the Ut interface instance
342      * @throws ImsException if getting the Ut interface results in an error
343      */
344     public ImsUtInterface getSupplementaryServiceConfiguration(int serviceId)
345             throws ImsException {
346         // FIXME: manage the multiple Ut interfaces based on the service id
347         if (mUt == null) {
348             checkAndThrowExceptionIfServiceUnavailable();
349
350             try {
351                 IImsUt iUt = mImsService.getUtInterface(serviceId);
352
353                 if (iUt == null) {
354                     throw new ImsException("getSupplementaryServiceConfiguration()",
355                             ImsReasonInfo.CODE_UT_NOT_SUPPORTED);
356                 }
357
358                 mUt = new ImsUt(iUt);
359             } catch (RemoteException e) {
360                 throw new ImsException("getSupplementaryServiceConfiguration()", e,
361                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
362             }
363         }
364
365         return mUt;
366     }
367
368     /**
369      * Checks if the IMS service has successfully registered to the IMS network
370      * with the specified service & call type.
371      *
372      * @param serviceId a service id which is obtained from {@link ImsManager#open}
373      * @param serviceType a service type that is specified in {@link ImsCallProfile}
374      *        {@link ImsCallProfile#SERVICE_TYPE_NORMAL}
375      *        {@link ImsCallProfile#SERVICE_TYPE_EMERGENCY}
376      * @param callType a call type that is specified in {@link ImsCallProfile}
377      *        {@link ImsCallProfile#CALL_TYPE_VOICE_N_VIDEO}
378      *        {@link ImsCallProfile#CALL_TYPE_VOICE}
379      *        {@link ImsCallProfile#CALL_TYPE_VT}
380      *        {@link ImsCallProfile#CALL_TYPE_VS}
381      * @return true if the specified service id is connected to the IMS network;
382      *        false otherwise
383      * @throws ImsException if calling the IMS service results in an error
384      */
385     public boolean isConnected(int serviceId, int serviceType, int callType)
386             throws ImsException {
387         checkAndThrowExceptionIfServiceUnavailable();
388
389         try {
390             return mImsService.isConnected(serviceId, serviceType, callType);
391         } catch (RemoteException e) {
392             throw new ImsException("isServiceConnected()", e,
393                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
394         }
395     }
396
397     /**
398      * Checks if the specified IMS service is opend.
399      *
400      * @param serviceId a service id which is obtained from {@link ImsManager#open}
401      * @return true if the specified service id is opened; false otherwise
402      * @throws ImsException if calling the IMS service results in an error
403      */
404     public boolean isOpened(int serviceId) throws ImsException {
405         checkAndThrowExceptionIfServiceUnavailable();
406
407         try {
408             return mImsService.isOpened(serviceId);
409         } catch (RemoteException e) {
410             throw new ImsException("isOpened()", e,
411                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
412         }
413     }
414
415     /**
416      * Creates a {@link ImsCallProfile} from the service capabilities & IMS registration state.
417      *
418      * @param serviceId a service id which is obtained from {@link ImsManager#open}
419      * @param serviceType a service type that is specified in {@link ImsCallProfile}
420      *        {@link ImsCallProfile#SERVICE_TYPE_NONE}
421      *        {@link ImsCallProfile#SERVICE_TYPE_NORMAL}
422      *        {@link ImsCallProfile#SERVICE_TYPE_EMERGENCY}
423      * @param callType a call type that is specified in {@link ImsCallProfile}
424      *        {@link ImsCallProfile#CALL_TYPE_VOICE}
425      *        {@link ImsCallProfile#CALL_TYPE_VT}
426      *        {@link ImsCallProfile#CALL_TYPE_VT_TX}
427      *        {@link ImsCallProfile#CALL_TYPE_VT_RX}
428      *        {@link ImsCallProfile#CALL_TYPE_VT_NODIR}
429      *        {@link ImsCallProfile#CALL_TYPE_VS}
430      *        {@link ImsCallProfile#CALL_TYPE_VS_TX}
431      *        {@link ImsCallProfile#CALL_TYPE_VS_RX}
432      * @return a {@link ImsCallProfile} object
433      * @throws ImsException if calling the IMS service results in an error
434      */
435     public ImsCallProfile createCallProfile(int serviceId,
436             int serviceType, int callType) throws ImsException {
437         checkAndThrowExceptionIfServiceUnavailable();
438
439         try {
440             return mImsService.createCallProfile(serviceId, serviceType, callType);
441         } catch (RemoteException e) {
442             throw new ImsException("createCallProfile()", e,
443                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
444         }
445     }
446
447     /**
448      * Creates a {@link ImsCall} to make a call.
449      *
450      * @param serviceId a service id which is obtained from {@link ImsManager#open}
451      * @param profile a call profile to make the call
452      *      (it contains service type, call type, media information, etc.)
453      * @param participants participants to invite the conference call
454      * @param listener listen to the call events from {@link ImsCall}
455      * @return a {@link ImsCall} object
456      * @throws ImsException if calling the IMS service results in an error
457      */
458     public ImsCall makeCall(int serviceId, ImsCallProfile profile, String[] callees,
459             ImsCall.Listener listener) throws ImsException {
460         if (DBG) {
461             log("makeCall :: serviceId=" + serviceId
462                     + ", profile=" + profile + ", callees=" + callees);
463         }
464
465         checkAndThrowExceptionIfServiceUnavailable();
466
467         ImsCall call = new ImsCall(mContext, profile);
468
469         call.setListener(listener);
470         ImsCallSession session = createCallSession(serviceId, profile);
471
472         if ((callees != null) && (callees.length == 1)) {
473             call.start(session, callees[0]);
474         } else {
475             call.start(session, callees);
476         }
477
478         return call;
479     }
480
481     /**
482      * Creates a {@link ImsCall} to take an incoming call.
483      *
484      * @param serviceId a service id which is obtained from {@link ImsManager#open}
485      * @param incomingCallIntent the incoming call broadcast intent
486      * @param listener to listen to the call events from {@link ImsCall}
487      * @return a {@link ImsCall} object
488      * @throws ImsException if calling the IMS service results in an error
489      */
490     public ImsCall takeCall(int serviceId, Intent incomingCallIntent,
491             ImsCall.Listener listener) throws ImsException {
492         if (DBG) {
493             log("takeCall :: serviceId=" + serviceId
494                     + ", incomingCall=" + incomingCallIntent);
495         }
496
497         checkAndThrowExceptionIfServiceUnavailable();
498
499         if (incomingCallIntent == null) {
500             throw new ImsException("Can't retrieve session with null intent",
501                     ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
502         }
503
504         int incomingServiceId = getServiceId(incomingCallIntent);
505
506         if (serviceId != incomingServiceId) {
507             throw new ImsException("Service id is mismatched in the incoming call intent",
508                     ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
509         }
510
511         String callId = getCallId(incomingCallIntent);
512
513         if (callId == null) {
514             throw new ImsException("Call ID missing in the incoming call intent",
515                     ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
516         }
517
518         try {
519             IImsCallSession session = mImsService.getPendingCallSession(serviceId, callId);
520
521             if (session == null) {
522                 throw new ImsException("No pending session for the call",
523                         ImsReasonInfo.CODE_LOCAL_NO_PENDING_CALL);
524             }
525
526             ImsCall call = new ImsCall(mContext, session.getCallProfile());
527
528             call.attachSession(new ImsCallSession(session));
529             call.setListener(listener);
530
531             return call;
532         } catch (Throwable t) {
533             throw new ImsException("takeCall()", t, ImsReasonInfo.CODE_UNSPECIFIED);
534         }
535     }
536
537     /**
538      * Gets the config interface to get/set service/capability parameters.
539      *
540      * @return the ImsConfig instance.
541      * @throws ImsException if getting the setting interface results in an error.
542      */
543     public ImsConfig getConfigInterface() throws ImsException {
544
545         if (mConfig == null) {
546             checkAndThrowExceptionIfServiceUnavailable();
547
548             try {
549                 IImsConfig config = mImsService.getConfigInterface(mPhoneId);
550                 if (config == null) {
551                     throw new ImsException("getConfigInterface()",
552                             ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
553                 }
554                 mConfig = new ImsConfig(config, mContext);
555             } catch (RemoteException e) {
556                 throw new ImsException("getConfigInterface()", e,
557                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
558             }
559         }
560         if (DBG) log("getConfigInterface(), mConfig= " + mConfig);
561         return mConfig;
562     }
563
564     public void setUiTTYMode(Context context, int serviceId, int uiTtyMode, Message onComplete)
565             throws ImsException {
566
567         checkAndThrowExceptionIfServiceUnavailable();
568
569         try {
570             mImsService.setUiTTYMode(serviceId, uiTtyMode, onComplete);
571         } catch (RemoteException e) {
572             throw new ImsException("setTTYMode()", e,
573                     ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
574         }
575
576         if (!context.getResources().getBoolean(
577                 com.android.internal.R.bool.config_carrier_volte_tty_supported)) {
578             setAdvanced4GMode((uiTtyMode == TelecomManager.TTY_MODE_OFF) &&
579                     isEnhanced4gLteModeSettingEnabledByUser(context));
580         }
581     }
582
583     /**
584      * Gets the call ID from the specified incoming call broadcast intent.
585      *
586      * @param incomingCallIntent the incoming call broadcast intent
587      * @return the call ID or null if the intent does not contain it
588      */
589     private static String getCallId(Intent incomingCallIntent) {
590         if (incomingCallIntent == null) {
591             return null;
592         }
593
594         return incomingCallIntent.getStringExtra(EXTRA_CALL_ID);
595     }
596
597     /**
598      * Gets the service type from the specified incoming call broadcast intent.
599      *
600      * @param incomingCallIntent the incoming call broadcast intent
601      * @return the service identifier or -1 if the intent does not contain it
602      */
603     private static int getServiceId(Intent incomingCallIntent) {
604         if (incomingCallIntent == null) {
605             return (-1);
606         }
607
608         return incomingCallIntent.getIntExtra(EXTRA_SERVICE_ID, -1);
609     }
610
611     /**
612      * Binds the IMS service only if the service is not created.
613      */
614     private void checkAndThrowExceptionIfServiceUnavailable()
615             throws ImsException {
616         if (mImsService == null) {
617             createImsService(true);
618
619             if (mImsService == null) {
620                 throw new ImsException("Service is unavailable",
621                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
622             }
623         }
624     }
625
626     private static String getImsServiceName(int phoneId) {
627         // TODO: MSIM implementation needs to decide on service name as a function of phoneId
628         return IMS_SERVICE;
629     }
630
631     /**
632      * Binds the IMS service to make/receive the call.
633      */
634     private void createImsService(boolean checkService) {
635         if (checkService) {
636             IBinder binder = ServiceManager.checkService(getImsServiceName(mPhoneId));
637
638             if (binder == null) {
639                 return;
640             }
641         }
642
643         IBinder b = ServiceManager.getService(getImsServiceName(mPhoneId));
644
645         if (b != null) {
646             try {
647                 b.linkToDeath(mDeathRecipient, 0);
648             } catch (RemoteException e) {
649             }
650         }
651
652         mImsService = IImsService.Stub.asInterface(b);
653     }
654
655     /**
656      * Creates a {@link ImsCallSession} with the specified call profile.
657      * Use other methods, if applicable, instead of interacting with
658      * {@link ImsCallSession} directly.
659      *
660      * @param serviceId a service id which is obtained from {@link ImsManager#open}
661      * @param profile a call profile to make the call
662      */
663     private ImsCallSession createCallSession(int serviceId,
664             ImsCallProfile profile) throws ImsException {
665         try {
666             return new ImsCallSession(mImsService.createCallSession(serviceId, profile, null));
667         } catch (RemoteException e) {
668             return null;
669         }
670     }
671
672     private ImsRegistrationListenerProxy createRegistrationListenerProxy(int serviceClass,
673             ImsConnectionStateListener listener) {
674         ImsRegistrationListenerProxy proxy =
675                 new ImsRegistrationListenerProxy(serviceClass, listener);
676         return proxy;
677     }
678
679     private void log(String s) {
680         Rlog.d(TAG, s);
681     }
682
683     private void loge(String s) {
684         Rlog.e(TAG, s);
685     }
686
687     private void loge(String s, Throwable t) {
688         Rlog.e(TAG, s, t);
689     }
690
691     /**
692      * Used for turning on IMS.if its off already
693      */
694     private void turnOnIms() throws ImsException {
695         checkAndThrowExceptionIfServiceUnavailable();
696
697         try {
698             mImsService.turnOnIms(mPhoneId);
699         } catch (RemoteException e) {
700             throw new ImsException("turnOnIms() ", e, ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
701         }
702     }
703
704     private void setAdvanced4GMode(boolean turnOn) throws ImsException {
705         checkAndThrowExceptionIfServiceUnavailable();
706
707         ImsConfig config = getConfigInterface();
708         if (config != null) {
709             config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_LTE,
710                     TelephonyManager.NETWORK_TYPE_LTE, turnOn ? 1 : 0, null);
711             if (isVtEnabledByPlatform(mContext)) {
712                 // TODO: once VT is available on platform replace the '1' with the current
713                 // user configuration of VT.
714                 config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VIDEO_OVER_LTE,
715                         TelephonyManager.NETWORK_TYPE_LTE, turnOn ? 1 : 0, null);
716             }
717         }
718
719         if (turnOn) {
720             turnOnIms();
721         } else if (mContext.getResources().getBoolean(
722                 com.android.internal.R.bool.imsServiceAllowTurnOff)) {
723             log("setAdvanced4GMode() : imsServiceAllowTurnOff -> turnOffIms");
724             turnOffIms();
725         }
726     }
727
728     /**
729      * Used for turning off IMS completely in order to make the device CSFB'ed.
730      * Once turned off, all calls will be over CS.
731      */
732     private void turnOffIms() throws ImsException {
733         checkAndThrowExceptionIfServiceUnavailable();
734
735         try {
736             mImsService.turnOffIms(mPhoneId);
737         } catch (RemoteException e) {
738             throw new ImsException("turnOffIms() ", e, ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
739         }
740     }
741
742     /**
743      * Death recipient class for monitoring IMS service.
744      */
745     private class ImsServiceDeathRecipient implements IBinder.DeathRecipient {
746         @Override
747         public void binderDied() {
748             mImsService = null;
749             mUt = null;
750             mConfig = null;
751             mEcbm = null;
752
753             if (mContext != null) {
754                 Intent intent = new Intent(ACTION_IMS_SERVICE_DOWN);
755                 intent.putExtra(EXTRA_PHONE_ID, mPhoneId);
756                 mContext.sendBroadcast(new Intent(intent));
757             }
758         }
759     }
760
761     /**
762      * Adapter class for {@link IImsRegistrationListener}.
763      */
764     private class ImsRegistrationListenerProxy extends IImsRegistrationListener.Stub {
765         private int mServiceClass;
766         private ImsConnectionStateListener mListener;
767
768         public ImsRegistrationListenerProxy(int serviceClass,
769                 ImsConnectionStateListener listener) {
770             mServiceClass = serviceClass;
771             mListener = listener;
772         }
773
774         public boolean isSameProxy(int serviceClass) {
775             return (mServiceClass == serviceClass);
776         }
777
778         @Override
779         public void registrationConnected() {
780             if (DBG) {
781                 log("registrationConnected ::");
782             }
783
784             if (mListener != null) {
785                 mListener.onImsConnected();
786             }
787         }
788
789         @Override
790         public void registrationDisconnected() {
791             if (DBG) {
792                 log("registrationDisconnected ::");
793             }
794
795             if (mListener != null) {
796                 mListener.onImsDisconnected();
797             }
798         }
799
800         @Override
801         public void registrationResumed() {
802             if (DBG) {
803                 log("registrationResumed ::");
804             }
805
806             if (mListener != null) {
807                 mListener.onImsResumed();
808             }
809         }
810
811         @Override
812         public void registrationSuspended() {
813             if (DBG) {
814                 log("registrationSuspended ::");
815             }
816
817             if (mListener != null) {
818                 mListener.onImsSuspended();
819             }
820         }
821
822         @Override
823         public void registrationServiceCapabilityChanged(int serviceClass, int event) {
824             log("registrationServiceCapabilityChanged :: serviceClass=" +
825                     serviceClass + ", event=" + event);
826
827             if (mListener != null) {
828                 mListener.onImsConnected();
829             }
830         }
831
832         @Override
833         public void registrationFeatureCapabilityChanged(int serviceClass,
834                 int[] enabledFeatures, int[] disabledFeatures) {
835             log("registrationFeatureCapabilityChanged :: serviceClass=" +
836                     serviceClass);
837             if (mListener != null) {
838                 mListener.onFeatureCapabilityChanged(serviceClass,
839                         enabledFeatures, disabledFeatures);
840             }
841         }
842
843     }
844     /**
845      * Gets the ECBM interface to request ECBM exit.
846      *
847      * @param serviceId a service id which is obtained from {@link ImsManager#open}
848      * @return the ECBM interface instance
849      * @throws ImsException if getting the ECBM interface results in an error
850      */
851     public ImsEcbm getEcbmInterface(int serviceId) throws ImsException {
852         if (mEcbm == null) {
853             checkAndThrowExceptionIfServiceUnavailable();
854
855             try {
856                 IImsEcbm iEcbm = mImsService.getEcbmInterface(serviceId);
857
858                 if (iEcbm == null) {
859                     throw new ImsException("getEcbmInterface()",
860                             ImsReasonInfo.CODE_ECBM_NOT_SUPPORTED);
861                 }
862                 mEcbm = new ImsEcbm(iEcbm);
863             } catch (RemoteException e) {
864                 throw new ImsException("getEcbmInterface()", e,
865                         ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
866             }
867         }
868         return mEcbm;
869     }
870 }