1a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen/* 2a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * Copyright (c) 2013 The Android Open Source Project 3a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 4a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * Licensed under the Apache License, Version 2.0 (the "License"); 5a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * you may not use this file except in compliance with the License. 6a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * You may obtain a copy of the License at 7a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 8a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * http://www.apache.org/licenses/LICENSE-2.0 9a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 10a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * Unless required by applicable law or agreed to in writing, software 11a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * distributed under the License is distributed on an "AS IS" BASIS, 12a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * See the License for the specific language governing permissions and 14a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * limitations under the License. 15a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 16a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 17a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 18a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohenpackage com.android.ims.internal; 19a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 20a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohenimport com.android.ims.ImsConfigListener; 21a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 22a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen/** 23796d60b12e0756db4689632d0985f7a5ed7a47d3Etan Cohen * Provides APIs to get/set the IMS service feature/capability/parameters. 24796d60b12e0756db4689632d0985f7a5ed7a47d3Etan Cohen * The config items include: 25796d60b12e0756db4689632d0985f7a5ed7a47d3Etan Cohen * 1) Items provisioned by the operator. 26796d60b12e0756db4689632d0985f7a5ed7a47d3Etan Cohen * 2) Items configured by user. Mainly service feature class. 27a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 28a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * {@hide} 29a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 30a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Coheninterface IImsConfig { 31a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen /** 322cdac3bd53a1e8e8342a3cff9d53bb7c5b27b1c9Libin.Tang@motorola.com * Gets the value for ims service/capabilities parameters from the provisioned 33a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * value storage. Synchronous blocking call. 34a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 35a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param item, as defined in com.android.ims.ImsConfig#ConfigConstants. 36a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @return value in Integer format. 37a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 382cdac3bd53a1e8e8342a3cff9d53bb7c5b27b1c9Libin.Tang@motorola.com int getProvisionedValue(int item); 39a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 40a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen /** 412cdac3bd53a1e8e8342a3cff9d53bb7c5b27b1c9Libin.Tang@motorola.com * Gets the value for ims service/capabilities parameters from the provisioned 42a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * value storage. Synchronous blocking call. 43a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 44a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param item, as defined in com.android.ims.ImsConfig#ConfigConstants. 45a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @return value in String format. 46a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 472cdac3bd53a1e8e8342a3cff9d53bb7c5b27b1c9Libin.Tang@motorola.com String getProvisionedStringValue(int item); 48a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 49a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen /** 50a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * Sets the value for IMS service/capabilities parameters by the operator device 51a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * management entity. It sets the config item value in the provisioned storage 52a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * from which the master value is derived. Synchronous blocking call. 53a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 54a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param item, as defined in com.android.ims.ImsConfig#ConfigConstants. 55a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param value in Integer format. 56846b71daaf4468c01e5371ee64e19327f7c094f1Libin.Tang@motorola.com * @return as defined in com.android.ims.ImsConfig#OperationStatusConstants. 57a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 58846b71daaf4468c01e5371ee64e19327f7c094f1Libin.Tang@motorola.com int setProvisionedValue(int item, int value); 59a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 60a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen /** 61a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * Sets the value for IMS service/capabilities parameters by the operator device 62a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * management entity. It sets the config item value in the provisioned storage 63a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * from which the master value is derived. Synchronous blocking call. 64a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 65a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param item, as defined in com.android.ims.ImsConfig#ConfigConstants. 66a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param value in String format. 67846b71daaf4468c01e5371ee64e19327f7c094f1Libin.Tang@motorola.com * @return as defined in com.android.ims.ImsConfig#OperationStatusConstants. 68a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 69846b71daaf4468c01e5371ee64e19327f7c094f1Libin.Tang@motorola.com int setProvisionedStringValue(int item, String value); 70a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 71a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen /** 72a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * Gets the value of the specified IMS feature item for specified network type. 73a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * This operation gets the feature config value from the master storage (i.e. final 74a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * value). Asynchronous non-blocking call. 75a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 76a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param feature. as defined in com.android.ims.ImsConfig#FeatureConstants. 77a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param network. as defined in android.telephony.TelephonyManager#NETWORK_TYPE_XXX. 78a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param listener. feature value returned asynchronously through listener. 79a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @return void 80a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 81a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen oneway void getFeatureValue(int feature, int network, ImsConfigListener listener); 82a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen 83a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen /** 84a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * Sets the value for IMS feature item for specified network type. 85a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * This operation stores the user setting in setting db from which master db 86a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * is dervied. 87a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * 88a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param feature. as defined in com.android.ims.ImsConfig#FeatureConstants. 89a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param network. as defined in android.telephony.TelephonyManager#NETWORK_TYPE_XXX. 90a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param value. as defined in com.android.ims.ImsConfig#FeatureValueConstants. 91a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @param listener, provided if caller needs to be notified for set result. 92a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen * @return void 93a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen */ 94a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen oneway void setFeatureValue(int feature, int network, int value, ImsConfigListener listener); 95bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com 96bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com /** 97bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com * Gets the value for IMS volte provisioned. 98bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com * This should be the same as the operator provisioned value if applies. 99bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com * 100bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com * @return void 101bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com */ 102bec2c3e25124552c6c86a1c1723ce3562edcaaffLibin.Tang@motorola.com boolean getVolteProvisioned(); 10307366813cdf3768dcd69a1f744023747564d654aRekha Kumar 10407366813cdf3768dcd69a1f744023747564d654aRekha Kumar /** 10507366813cdf3768dcd69a1f744023747564d654aRekha Kumar * 10607366813cdf3768dcd69a1f744023747564d654aRekha Kumar * Gets the value for ims fature item video quality. 10707366813cdf3768dcd69a1f744023747564d654aRekha Kumar * 10807366813cdf3768dcd69a1f744023747564d654aRekha Kumar * @param listener. Video quality value returned asynchronously through listener. 10907366813cdf3768dcd69a1f744023747564d654aRekha Kumar * @return void 11007366813cdf3768dcd69a1f744023747564d654aRekha Kumar */ 11107366813cdf3768dcd69a1f744023747564d654aRekha Kumar oneway void getVideoQuality(ImsConfigListener listener); 11207366813cdf3768dcd69a1f744023747564d654aRekha Kumar 11307366813cdf3768dcd69a1f744023747564d654aRekha Kumar /** 11407366813cdf3768dcd69a1f744023747564d654aRekha Kumar * Sets the value for IMS feature item video quality. 11507366813cdf3768dcd69a1f744023747564d654aRekha Kumar * 11607366813cdf3768dcd69a1f744023747564d654aRekha Kumar * @param quality, defines the value of video quality. 11707366813cdf3768dcd69a1f744023747564d654aRekha Kumar * @param listener, provided if caller needs to be notified for set result. 11807366813cdf3768dcd69a1f744023747564d654aRekha Kumar * @return void 11907366813cdf3768dcd69a1f744023747564d654aRekha Kumar * 12007366813cdf3768dcd69a1f744023747564d654aRekha Kumar * @throws ImsException if calling the IMS service results in an error. 12107366813cdf3768dcd69a1f744023747564d654aRekha Kumar */ 12207366813cdf3768dcd69a1f744023747564d654aRekha Kumar oneway void setVideoQuality(int quality, ImsConfigListener listener); 123a4d88d1e6e0af284b5ecccc5d55bfcdaa2f784a8Etan Cohen} 124