/*
* Copyright (C) 2017 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License
*/
package com.android.ims;
import android.content.Context;
import android.os.RemoteException;
import android.telephony.Rlog;
import android.telephony.ims.ImsReasonInfo;
import android.telephony.ims.aidl.IImsConfig;
import android.telephony.ims.stub.ImsConfigImplBase;
Provides APIs to get/set the IMS service feature/capability/parameters.
The config items include:
1) Items provisioned by the operator.
2) Items configured by user. Mainly service feature class.
@hide
/**
* Provides APIs to get/set the IMS service feature/capability/parameters.
* The config items include:
* 1) Items provisioned by the operator.
* 2) Items configured by user. Mainly service feature class.
*
* @hide
*/
public class ImsConfig {
private static final String TAG = "ImsConfig";
private boolean DBG = true;
private final IImsConfig miConfig;
Broadcast action: the feature enable status was changed
@hide
/**
* Broadcast action: the feature enable status was changed
*
* @hide
*/
public static final String ACTION_IMS_FEATURE_CHANGED =
"com.android.intent.action.IMS_FEATURE_CHANGED";
Broadcast action: the configuration was changed
Deprecated: Use addConfigCallback(Callback)
instead. @hide
/**
* Broadcast action: the configuration was changed
* @deprecated Use {@link ImsConfig#addConfigCallback(ImsConfigImplBase.Callback)} instead.
* @hide
*/
public static final String ACTION_IMS_CONFIG_CHANGED =
"com.android.intent.action.IMS_CONFIG_CHANGED";
Extra parameter "item" of intent ACTION_IMS_FEATURE_CHANGED and ACTION_IMS_CONFIG_CHANGED.
It is the value of FeatureConstants or ConfigConstants.
@hide
/**
* Extra parameter "item" of intent ACTION_IMS_FEATURE_CHANGED and ACTION_IMS_CONFIG_CHANGED.
* It is the value of FeatureConstants or ConfigConstants.
*
* @hide
*/
public static final String EXTRA_CHANGED_ITEM = "item";
Extra parameter "value" of intent ACTION_IMS_FEATURE_CHANGED and ACTION_IMS_CONFIG_CHANGED.
It is the new value of "item".
@hide
/**
* Extra parameter "value" of intent ACTION_IMS_FEATURE_CHANGED and ACTION_IMS_CONFIG_CHANGED.
* It is the new value of "item".
*
* @hide
*/
public static final String EXTRA_NEW_VALUE = "value";
Defines IMS service/capability feature constants.
Deprecated: Use MmTelCapability
instead.
/**
* Defines IMS service/capability feature constants.
* @deprecated Use
* {@link android.telephony.ims.feature.MmTelFeature.MmTelCapabilities.MmTelCapability} instead.
*/
public static class FeatureConstants {
public static final int FEATURE_TYPE_UNKNOWN = -1;
FEATURE_TYPE_VOLTE supports features defined in 3GPP and
GSMA IR.92 over LTE.
/**
* FEATURE_TYPE_VOLTE supports features defined in 3GPP and
* GSMA IR.92 over LTE.
*/
public static final int FEATURE_TYPE_VOICE_OVER_LTE = 0;
FEATURE_TYPE_LVC supports features defined in 3GPP and
GSMA IR.94 over LTE.
/**
* FEATURE_TYPE_LVC supports features defined in 3GPP and
* GSMA IR.94 over LTE.
*/
public static final int FEATURE_TYPE_VIDEO_OVER_LTE = 1;
FEATURE_TYPE_VOICE_OVER_WIFI supports features defined in 3GPP and
GSMA IR.92 over WiFi.
/**
* FEATURE_TYPE_VOICE_OVER_WIFI supports features defined in 3GPP and
* GSMA IR.92 over WiFi.
*/
public static final int FEATURE_TYPE_VOICE_OVER_WIFI = 2;
FEATURE_TYPE_VIDEO_OVER_WIFI supports features defined in 3GPP and
GSMA IR.94 over WiFi.
/**
* FEATURE_TYPE_VIDEO_OVER_WIFI supports features defined in 3GPP and
* GSMA IR.94 over WiFi.
*/
public static final int FEATURE_TYPE_VIDEO_OVER_WIFI = 3;
FEATURE_TYPE_UT supports features defined in 3GPP and
GSMA IR.92 over LTE.
/**
* FEATURE_TYPE_UT supports features defined in 3GPP and
* GSMA IR.92 over LTE.
*/
public static final int FEATURE_TYPE_UT_OVER_LTE = 4;
FEATURE_TYPE_UT_OVER_WIFI supports features defined in 3GPP and
GSMA IR.92 over WiFi.
/**
* FEATURE_TYPE_UT_OVER_WIFI supports features defined in 3GPP and
* GSMA IR.92 over WiFi.
*/
public static final int FEATURE_TYPE_UT_OVER_WIFI = 5;
}
Defines IMS service/capability parameters.
/**
* Defines IMS service/capability parameters.
*/
public static class ConfigConstants {
// Define IMS config items
public static final int CONFIG_START = 0;
// Define operator provisioned config items
public static final int PROVISIONED_CONFIG_START = CONFIG_START;
AMR CODEC Mode Value set, 0-7 in comma separated sequence.
Value is in String format.
/**
* AMR CODEC Mode Value set, 0-7 in comma separated sequence.
* Value is in String format.
*/
public static final int VOCODER_AMRMODESET = CONFIG_START;
Wide Band AMR CODEC Mode Value set,0-7 in comma separated sequence.
Value is in String format.
/**
* Wide Band AMR CODEC Mode Value set,0-7 in comma separated sequence.
* Value is in String format.
*/
public static final int VOCODER_AMRWBMODESET = 1;
SIP Session Timer value (seconds).
Value is in Integer format.
/**
* SIP Session Timer value (seconds).
* Value is in Integer format.
*/
public static final int SIP_SESSION_TIMER = 2;
Minimum SIP Session Expiration Timer in (seconds).
Value is in Integer format.
/**
* Minimum SIP Session Expiration Timer in (seconds).
* Value is in Integer format.
*/
public static final int MIN_SE = 3;
SIP_INVITE cancellation time out value (in milliseconds). Integer format.
Value is in Integer format.
/**
* SIP_INVITE cancellation time out value (in milliseconds). Integer format.
* Value is in Integer format.
*/
public static final int CANCELLATION_TIMER = 4;
Delay time when an iRAT transition from eHRPD/HRPD/1xRTT to LTE.
Value is in Integer format.
/**
* Delay time when an iRAT transition from eHRPD/HRPD/1xRTT to LTE.
* Value is in Integer format.
*/
public static final int TDELAY = 5;
Silent redial status of Enabled (True), or Disabled (False).
Value is in Integer format.
/**
* Silent redial status of Enabled (True), or Disabled (False).
* Value is in Integer format.
*/
public static final int SILENT_REDIAL_ENABLE = 6;
SIP T1 timer value in milliseconds. See RFC 3261 for define.
Value is in Integer format.
/**
* SIP T1 timer value in milliseconds. See RFC 3261 for define.
* Value is in Integer format.
*/
public static final int SIP_T1_TIMER = 7;
SIP T2 timer value in milliseconds. See RFC 3261 for define.
Value is in Integer format.
/**
* SIP T2 timer value in milliseconds. See RFC 3261 for define.
* Value is in Integer format.
*/
public static final int SIP_T2_TIMER = 8;
SIP TF timer value in milliseconds. See RFC 3261 for define.
Value is in Integer format.
/**
* SIP TF timer value in milliseconds. See RFC 3261 for define.
* Value is in Integer format.
*/
public static final int SIP_TF_TIMER = 9;
VoLTE status for VLT/s status of Enabled (1), or Disabled (0).
Value is in Integer format.
/**
* VoLTE status for VLT/s status of Enabled (1), or Disabled (0).
* Value is in Integer format.
*/
public static final int VLT_SETTING_ENABLED = 10;
VoLTE status for LVC/s status of Enabled (1), or Disabled (0).
Value is in Integer format.
/**
* VoLTE status for LVC/s status of Enabled (1), or Disabled (0).
* Value is in Integer format.
*/
public static final int LVC_SETTING_ENABLED = 11;
Domain Name for the device to populate the request URI for REGISTRATION.
Value is in String format.
/**
* Domain Name for the device to populate the request URI for REGISTRATION.
* Value is in String format.
*/
public static final int DOMAIN_NAME = 12;
Device Outgoing SMS based on either 3GPP or 3GPP2 standards.
Value is in Integer format. 3GPP2(0), 3GPP(1)
/**
* Device Outgoing SMS based on either 3GPP or 3GPP2 standards.
* Value is in Integer format. 3GPP2(0), 3GPP(1)
*/
public static final int SMS_FORMAT = 13;
Turns IMS ON/OFF on the device.
Value is in Integer format. ON (1), OFF(0).
/**
* Turns IMS ON/OFF on the device.
* Value is in Integer format. ON (1), OFF(0).
*/
public static final int SMS_OVER_IP = 14;
Requested expiration for Published Online availability.
Value is in Integer format.
/**
* Requested expiration for Published Online availability.
* Value is in Integer format.
*/
public static final int PUBLISH_TIMER = 15;
Requested expiration for Published Offline availability.
Value is in Integer format.
/**
* Requested expiration for Published Offline availability.
* Value is in Integer format.
*/
public static final int PUBLISH_TIMER_EXTENDED = 16;
Value is in Integer format.
/**
*
* Value is in Integer format.
*/
public static final int CAPABILITY_DISCOVERY_ENABLED = 17;
Period of time the capability information of the contact is cached on handset.
Value is in Integer format.
/**
* Period of time the capability information of the contact is cached on handset.
* Value is in Integer format.
*/
public static final int CAPABILITIES_CACHE_EXPIRATION = 18;
Peiod of time the availability information of a contact is cached on device.
Value is in Integer format.
/**
* Peiod of time the availability information of a contact is cached on device.
* Value is in Integer format.
*/
public static final int AVAILABILITY_CACHE_EXPIRATION = 19;
Interval between successive capabilities polling.
Value is in Integer format.
/**
* Interval between successive capabilities polling.
* Value is in Integer format.
*/
public static final int CAPABILITIES_POLL_INTERVAL = 20;
Minimum time between two published messages from the device.
Value is in Integer format.
/**
* Minimum time between two published messages from the device.
* Value is in Integer format.
*/
public static final int SOURCE_THROTTLE_PUBLISH = 21;
The Maximum number of MDNs contained in one Request Contained List.
Value is in Integer format.
/**
* The Maximum number of MDNs contained in one Request Contained List.
* Value is in Integer format.
*/
public static final int MAX_NUMENTRIES_IN_RCL = 22;
Expiration timer for subscription of a Request Contained List, used in capability
polling.
Value is in Integer format.
/**
* Expiration timer for subscription of a Request Contained List, used in capability
* polling.
* Value is in Integer format.
*/
public static final int CAPAB_POLL_LIST_SUB_EXP = 23;
Applies compression to LIST Subscription.
Value is in Integer format. Enable (1), Disable(0).
/**
* Applies compression to LIST Subscription.
* Value is in Integer format. Enable (1), Disable(0).
*/
public static final int GZIP_FLAG = 24;
VOLTE Status for EAB/s status of Enabled (1), or Disabled (0).
Value is in Integer format.
/**
* VOLTE Status for EAB/s status of Enabled (1), or Disabled (0).
* Value is in Integer format.
*/
public static final int EAB_SETTING_ENABLED = 25;
Wi-Fi calling roaming status.
Value is in Integer format. ON (1), OFF(0).
/**
* Wi-Fi calling roaming status.
* Value is in Integer format. ON (1), OFF(0).
*/
public static final int VOICE_OVER_WIFI_ROAMING = 26;
Wi-Fi calling modem - WfcModeFeatureValueConstants.
Value is in Integer format.
/**
* Wi-Fi calling modem - WfcModeFeatureValueConstants.
* Value is in Integer format.
*/
public static final int VOICE_OVER_WIFI_MODE = 27;
VOLTE Status for voice over wifi status of Enabled (1), or Disabled (0).
Value is in Integer format.
/**
* VOLTE Status for voice over wifi status of Enabled (1), or Disabled (0).
* Value is in Integer format.
*/
public static final int VOICE_OVER_WIFI_SETTING_ENABLED = 28;
Mobile data enabled.
Value is in Integer format. On (1), OFF(0).
/**
* Mobile data enabled.
* Value is in Integer format. On (1), OFF(0).
*/
public static final int MOBILE_DATA_ENABLED = 29;
VoLTE user opted in status.
Value is in Integer format. Opted-in (1) Opted-out (0).
/**
* VoLTE user opted in status.
* Value is in Integer format. Opted-in (1) Opted-out (0).
*/
public static final int VOLTE_USER_OPT_IN_STATUS = 30;
Proxy for Call Session Control Function(P-CSCF) address for Local-BreakOut(LBO).
Value is in String format.
/**
* Proxy for Call Session Control Function(P-CSCF) address for Local-BreakOut(LBO).
* Value is in String format.
*/
public static final int LBO_PCSCF_ADDRESS = 31;
Keep Alive Enabled for SIP.
Value is in Integer format. On(1), OFF(0).
/**
* Keep Alive Enabled for SIP.
* Value is in Integer format. On(1), OFF(0).
*/
public static final int KEEP_ALIVE_ENABLED = 32;
Registration retry Base Time value in seconds.
Value is in Integer format.
/**
* Registration retry Base Time value in seconds.
* Value is in Integer format.
*/
public static final int REGISTRATION_RETRY_BASE_TIME_SEC = 33;
Registration retry Max Time value in seconds.
Value is in Integer format.
/**
* Registration retry Max Time value in seconds.
* Value is in Integer format.
*/
public static final int REGISTRATION_RETRY_MAX_TIME_SEC = 34;
Smallest RTP port for speech codec.
Value is in integer format.
/**
* Smallest RTP port for speech codec.
* Value is in integer format.
*/
public static final int SPEECH_START_PORT = 35;
Largest RTP port for speech code.
Value is in Integer format.
/**
* Largest RTP port for speech code.
* Value is in Integer format.
*/
public static final int SPEECH_END_PORT = 36;
SIP Timer A's value in milliseconds. Timer A is the INVITE request
retransmit interval, for UDP only.
Value is in Integer format.
/**
* SIP Timer A's value in milliseconds. Timer A is the INVITE request
* retransmit interval, for UDP only.
* Value is in Integer format.
*/
public static final int SIP_INVITE_REQ_RETX_INTERVAL_MSEC = 37;
SIP Timer B's value in milliseconds. Timer B is the wait time for
INVITE message to be acknowledged.
Value is in Integer format.
/**
* SIP Timer B's value in milliseconds. Timer B is the wait time for
* INVITE message to be acknowledged.
* Value is in Integer format.
*/
public static final int SIP_INVITE_RSP_WAIT_TIME_MSEC = 38;
SIP Timer D's value in milliseconds. Timer D is the wait time for
response retransmits of the invite client transactions.
Value is in Integer format.
/**
* SIP Timer D's value in milliseconds. Timer D is the wait time for
* response retransmits of the invite client transactions.
* Value is in Integer format.
*/
public static final int SIP_INVITE_RSP_RETX_WAIT_TIME_MSEC = 39;
SIP Timer E's value in milliseconds. Timer E is the value Non-INVITE
request retransmit interval, for UDP only.
Value is in Integer format.
/**
* SIP Timer E's value in milliseconds. Timer E is the value Non-INVITE
* request retransmit interval, for UDP only.
* Value is in Integer format.
*/
public static final int SIP_NON_INVITE_REQ_RETX_INTERVAL_MSEC = 40;
SIP Timer F's value in milliseconds. Timer F is the Non-INVITE transaction
timeout timer.
Value is in Integer format.
/**
* SIP Timer F's value in milliseconds. Timer F is the Non-INVITE transaction
* timeout timer.
* Value is in Integer format.
*/
public static final int SIP_NON_INVITE_TXN_TIMEOUT_TIMER_MSEC = 41;
SIP Timer G's value in milliseconds. Timer G is the value of INVITE response
retransmit interval.
Value is in Integer format.
/**
* SIP Timer G's value in milliseconds. Timer G is the value of INVITE response
* retransmit interval.
* Value is in Integer format.
*/
public static final int SIP_INVITE_RSP_RETX_INTERVAL_MSEC = 42;
SIP Timer H's value in milliseconds. Timer H is the value of wait time for
ACK receipt.
Value is in Integer format.
/**
* SIP Timer H's value in milliseconds. Timer H is the value of wait time for
* ACK receipt.
* Value is in Integer format.
*/
public static final int SIP_ACK_RECEIPT_WAIT_TIME_MSEC = 43;
SIP Timer I's value in milliseconds. Timer I is the value of wait time for
ACK retransmits.
Value is in Integer format.
/**
* SIP Timer I's value in milliseconds. Timer I is the value of wait time for
* ACK retransmits.
* Value is in Integer format.
*/
public static final int SIP_ACK_RETX_WAIT_TIME_MSEC = 44;
SIP Timer J's value in milliseconds. Timer J is the value of wait time for
non-invite request retransmission.
Value is in Integer format.
/**
* SIP Timer J's value in milliseconds. Timer J is the value of wait time for
* non-invite request retransmission.
* Value is in Integer format.
*/
public static final int SIP_NON_INVITE_REQ_RETX_WAIT_TIME_MSEC = 45;
SIP Timer K's value in milliseconds. Timer K is the value of wait time for
non-invite response retransmits.
Value is in Integer format.
/**
* SIP Timer K's value in milliseconds. Timer K is the value of wait time for
* non-invite response retransmits.
* Value is in Integer format.
*/
public static final int SIP_NON_INVITE_RSP_RETX_WAIT_TIME_MSEC = 46;
AMR WB octet aligned dynamic payload type.
Value is in Integer format.
/**
* AMR WB octet aligned dynamic payload type.
* Value is in Integer format.
*/
public static final int AMR_WB_OCTET_ALIGNED_PT = 47;
AMR WB bandwidth efficient payload type.
Value is in Integer format.
/**
* AMR WB bandwidth efficient payload type.
* Value is in Integer format.
*/
public static final int AMR_WB_BANDWIDTH_EFFICIENT_PT = 48;
AMR octet aligned dynamic payload type.
Value is in Integer format.
/**
* AMR octet aligned dynamic payload type.
* Value is in Integer format.
*/
public static final int AMR_OCTET_ALIGNED_PT = 49;
AMR bandwidth efficient payload type.
Value is in Integer format.
/**
* AMR bandwidth efficient payload type.
* Value is in Integer format.
*/
public static final int AMR_BANDWIDTH_EFFICIENT_PT = 50;
DTMF WB payload type.
Value is in Integer format.
/**
* DTMF WB payload type.
* Value is in Integer format.
*/
public static final int DTMF_WB_PT = 51;
DTMF NB payload type.
Value is in Integer format.
/**
* DTMF NB payload type.
* Value is in Integer format.
*/
public static final int DTMF_NB_PT = 52;
AMR Default encoding mode.
Value is in Integer format.
/**
* AMR Default encoding mode.
* Value is in Integer format.
*/
public static final int AMR_DEFAULT_MODE = 53;
SMS Public Service Identity.
Value is in String format.
/**
* SMS Public Service Identity.
* Value is in String format.
*/
public static final int SMS_PSI = 54;
Video Quality - VideoQualityFeatureValuesConstants.
Value is in Integer format.
/**
* Video Quality - VideoQualityFeatureValuesConstants.
* Value is in Integer format.
*/
public static final int VIDEO_QUALITY = 55;
LTE threshold.
Handover from LTE to WiFi if LTE < THLTE1 and WiFi >= VOWT_A.
/**
* LTE threshold.
* Handover from LTE to WiFi if LTE < THLTE1 and WiFi >= VOWT_A.
*/
public static final int TH_LTE1 = 56;
LTE threshold.
Handover from WiFi to LTE if LTE >= THLTE3 or (WiFi < VOWT_B and LTE >= THLTE2).
/**
* LTE threshold.
* Handover from WiFi to LTE if LTE >= THLTE3 or (WiFi < VOWT_B and LTE >= THLTE2).
*/
public static final int TH_LTE2 = 57;
LTE threshold.
Handover from WiFi to LTE if LTE >= THLTE3 or (WiFi < VOWT_B and LTE >= THLTE2).
/**
* LTE threshold.
* Handover from WiFi to LTE if LTE >= THLTE3 or (WiFi < VOWT_B and LTE >= THLTE2).
*/
public static final int TH_LTE3 = 58;
1x threshold.
Handover from 1x to WiFi if 1x < TH1x
/**
* 1x threshold.
* Handover from 1x to WiFi if 1x < TH1x
*/
public static final int TH_1x = 59;
WiFi threshold.
Handover from LTE to WiFi if LTE < THLTE1 and WiFi >= VOWT_A.
/**
* WiFi threshold.
* Handover from LTE to WiFi if LTE < THLTE1 and WiFi >= VOWT_A.
*/
public static final int VOWT_A = 60;
WiFi threshold.
Handover from WiFi to LTE if LTE >= THLTE3 or (WiFi < VOWT_B and LTE >= THLTE2).
/**
* WiFi threshold.
* Handover from WiFi to LTE if LTE >= THLTE3 or (WiFi < VOWT_B and LTE >= THLTE2).
*/
public static final int VOWT_B = 61;
LTE ePDG timer.
Device shall not handover back to LTE until the T_ePDG_LTE timer expires.
/**
* LTE ePDG timer.
* Device shall not handover back to LTE until the T_ePDG_LTE timer expires.
*/
public static final int T_EPDG_LTE = 62;
WiFi ePDG timer.
Device shall not handover back to WiFi until the T_ePDG_WiFi timer expires.
/**
* WiFi ePDG timer.
* Device shall not handover back to WiFi until the T_ePDG_WiFi timer expires.
*/
public static final int T_EPDG_WIFI = 63;
1x ePDG timer.
Device shall not re-register on 1x until the T_ePDG_1x timer expires.
/**
* 1x ePDG timer.
* Device shall not re-register on 1x until the T_ePDG_1x timer expires.
*/
public static final int T_EPDG_1X = 64;
MultiEndpoint status: Enabled (1), or Disabled (0).
Value is in Integer format.
/**
* MultiEndpoint status: Enabled (1), or Disabled (0).
* Value is in Integer format.
*/
public static final int VICE_SETTING_ENABLED = 65;
RTT status: Enabled (1), or Disabled (0).
Value is in Integer format.
/**
* RTT status: Enabled (1), or Disabled (0).
* Value is in Integer format.
*/
public static final int RTT_SETTING_ENABLED = 66;
// Expand the operator config items as needed here, need to change
// PROVISIONED_CONFIG_END after that.
public static final int PROVISIONED_CONFIG_END = RTT_SETTING_ENABLED;
// Expand the operator config items as needed here.
}
Defines IMS set operation status.
/**
* Defines IMS set operation status.
*/
public static class OperationStatusConstants {
public static final int UNKNOWN = -1;
public static final int SUCCESS = 0;
public static final int FAILED = 1;
public static final int UNSUPPORTED_CAUSE_NONE = 2;
public static final int UNSUPPORTED_CAUSE_RAT = 3;
public static final int UNSUPPORTED_CAUSE_DISABLED = 4;
}
Defines IMS get operation values.
/**
* Defines IMS get operation values.
*/
public static class OperationValuesConstants {
Values related to Video Quality
/**
* Values related to Video Quality
*/
public static final int VIDEO_QUALITY_UNKNOWN = -1;
public static final int VIDEO_QUALITY_LOW = 0;
public static final int VIDEO_QUALITY_HIGH = 1;
}
Defines IMS video quality feature value.
/**
* Defines IMS video quality feature value.
*/
public static class VideoQualityFeatureValuesConstants {
public static final int LOW = 0;
public static final int HIGH = 1;
}
Defines IMS feature value.
/**
* Defines IMS feature value.
*/
public static class FeatureValueConstants {
public static final int ERROR = -1;
public static final int OFF = 0;
public static final int ON = 1;
}
Defines IMS feature value.
/**
* Defines IMS feature value.
*/
public static class WfcModeFeatureValueConstants {
public static final int WIFI_ONLY = 0;
public static final int CELLULAR_PREFERRED = 1;
public static final int WIFI_PREFERRED = 2;
}
public ImsConfig(IImsConfig iconfig) {
miConfig = iconfig;
}
Deprecated: see getConfigInt(int)
instead.
/**
* @deprecated see {@link #getConfigInt(int)} instead.
*/
public int getProvisionedValue(int item) throws ImsException {
return getConfigInt(item);
}
Gets the configuration value for IMS service/capabilities parameters used by IMS stack.
Throws: - ImsException – if the ImsService is unavailable.
@param item, as defined in com.android.ims.ImsConfig#ConfigConstants. Returns: the value in Integer format.
/**
* Gets the configuration value for IMS service/capabilities parameters used by IMS stack.
*
* @param item, as defined in com.android.ims.ImsConfig#ConfigConstants.
* @return the value in Integer format.
* @throws ImsException if the ImsService is unavailable.
*/
public int getConfigInt(int item) throws ImsException {
int ret = 0;
try {
ret = miConfig.getConfigInt(item);
} catch (RemoteException e) {
throw new ImsException("getInt()", e,
ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
}
if (DBG) Rlog.d(TAG, "getInt(): item = " + item + ", ret =" + ret);
return ret;
}
Deprecated: see getConfigString(int)
instead
/**
* @deprecated see {@link #getConfigString(int)} instead
*/
public String getProvisionedStringValue(int item) throws ImsException {
return getConfigString(item);
}
Gets the configuration value for IMS service/capabilities parameters used by IMS stack.
Throws: - ImsException – if the ImsService is unavailable.
@param item, as defined in com.android.ims.ImsConfig#ConfigConstants. Returns: value in String format.
/**
* Gets the configuration value for IMS service/capabilities parameters used by IMS stack.
*
* @param item, as defined in com.android.ims.ImsConfig#ConfigConstants.
* @return value in String format.
*
* @throws ImsException if the ImsService is unavailable.
*/
public String getConfigString(int item) throws ImsException {
String ret = "Unknown";
try {
ret = miConfig.getConfigString(item);
} catch (RemoteException e) {
throw new ImsException("getConfigString()", e,
ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
}
if (DBG) Rlog.d(TAG, "getConfigString(): item = " + item + ", ret =" + ret);
return ret;
}
Deprecated: see setConfig(int, int)
instead.
/**
* @deprecated see {@link #setConfig(int, int)} instead.
*/
public int setProvisionedValue(int item, int value) throws ImsException {
return setConfig(item, value);
}
Deprecated: see setConfig(int, String)
instead.
/**
* @deprecated see {@link #setConfig(int, String)} instead.
*/
public int setProvisionedStringValue(int item, String value) throws ImsException {
return setConfig(item, value);
}
Sets the value for ImsService configuration item.
Params: - value – in Integer format.
Throws: - ImsException – if the ImsService is unavailable.
@param item, as defined in com.android.ims.ImsConfig#ConfigConstants. Returns: as defined in com.android.ims.ImsConfig#OperationStatusConstants
/**
* Sets the value for ImsService configuration item.
*
* @param item, as defined in com.android.ims.ImsConfig#ConfigConstants.
* @param value in Integer format.
* @return as defined in com.android.ims.ImsConfig#OperationStatusConstants
*
* @throws ImsException if the ImsService is unavailable.
*/
public int setConfig(int item, int value) throws ImsException {
int ret = OperationStatusConstants.UNKNOWN;
if (DBG) {
Rlog.d(TAG, "setConfig(): item = " + item +
"value = " + value);
}
try {
ret = miConfig.setConfigInt(item, value);
} catch (RemoteException e) {
throw new ImsException("setConfig()", e,
ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
}
if (DBG) {
Rlog.d(TAG, "setConfig(): item = " + item +
" value = " + value + " ret = " + ret);
}
return ret;
}
Sets the value for ImsService configuration item.
Params: - value – in Integer format.
Throws: - ImsException – if the ImsService is unavailable.
@param item, as defined in com.android.ims.ImsConfig#ConfigConstants. Returns: as defined in com.android.ims.ImsConfig#OperationStatusConstants
/**
* Sets the value for ImsService configuration item.
*
* @param item, as defined in com.android.ims.ImsConfig#ConfigConstants.
* @param value in Integer format.
* @return as defined in com.android.ims.ImsConfig#OperationStatusConstants
*
* @throws ImsException if the ImsService is unavailable.
*/
public int setConfig(int item, String value) throws ImsException {
int ret = OperationStatusConstants.UNKNOWN;
if (DBG) {
Rlog.d(TAG, "setConfig(): item = " + item +
"value = " + value);
}
try {
ret = miConfig.setConfigString(item, value);
} catch (RemoteException e) {
throw new ImsException("setConfig()", e,
ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
}
if (DBG) {
Rlog.d(TAG, "setConfig(): item = " + item +
" value = " + value + " ret = " + ret);
}
return ret;
}
Adds a Callback
to the ImsService to notify when a Configuration item has changed. Make sure to call removeConfigCallback(Callback)
when finished using this callback. /**
* Adds a {@link ImsConfigImplBase.Callback} to the ImsService to notify when a Configuration
* item has changed.
*
* Make sure to call {@link #removeConfigCallback(ImsConfigImplBase.Callback)} when finished
* using this callback.
*/
public void addConfigCallback(ImsConfigImplBase.Callback callback) throws ImsException {
if (DBG) Rlog.d(TAG, "addConfigCallback: " + callback);
try {
miConfig.addImsConfigCallback(callback);
} catch (RemoteException e) {
throw new ImsException("addConfigCallback()", e,
ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
}
}
Removes a Callback
from the ImsService that was previously added by addConfigCallback(Callback)
. /**
* Removes a {@link ImsConfigImplBase.Callback} from the ImsService that was previously added
* by {@link #addConfigCallback(ImsConfigImplBase.Callback)}.
*/
public void removeConfigCallback(ImsConfigImplBase.Callback callback) throws ImsException {
if (DBG) Rlog.d(TAG, "removeConfigCallback: " + callback);
try {
miConfig.removeImsConfigCallback(callback);
} catch (RemoteException e) {
throw new ImsException("removeConfigCallback()", e,
ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
}
}
Returns: true if the binder connection is alive, false otherwise.
/**
* @return true if the binder connection is alive, false otherwise.
*/
public boolean isBinderAlive() {
return miConfig.asBinder().isBinderAlive();
}
}