Update documentation of IImsConfig interface.

Change-Id: Id176c131e0192a2ebb4dd73e902c2a893feebcdc
This commit is contained in:
Etan Cohen
2015-03-09 10:08:49 -07:00
parent 2f23212ce5
commit 796d60b12e

View File

@ -20,31 +20,11 @@ package com.android.ims.internal;
import com.android.ims.ImsConfigListener; import com.android.ims.ImsConfigListener;
/** /**
* Provides APIs to get/set the IMS service capability/parameters. * Provides APIs to get/set the IMS service feature/capability/parameters.
* The parameters can be configured by operator and/or user. * The config items include:
* We define 4 storage locations for the IMS config items: * 1) Items provisioned by the operator.
* 1) Default config:For factory out device or device after factory data reset, * 2) Items configured by user. Mainly service feature class.
* the default config is used to build the initial state of the master config value.
* 2) Provisioned value: as the parameters provisioned by operator need to be preserved
* across FDR(factory data reset)/BOTA(over the air software upgrade), the operator
* provisioned items should be stored in memory location preserved across FDR/BOTA.
* 3) Master value: as the provisioned value can override the user setting,
* and the master config are used by IMS stack. They should be stored in the
* storage based on IMS vendor implementations.
* 4) User setting: For items can be changed by both user/operator, the user
* setting should take effect in some cases. So the user setting should be stored in
* database like setting.db.
* *
* Priority consideration if both operator/user can config the same item:
* 1) For feature config items, the master value is obtained from the provisioned value
* masks with the user setting. Specifically the provisioned values overrides
* the user setting if feature is provisioned off. Otherwise, user setting takes
* effect.
* 2) For non-feature config item: to be implemented based on cases.
* Special cases considered as below:
* 1) Factory out device, the master configuration is built from default config.
* 2) For Factory data reset/SW upgrade device, the master config is built by
* taking provisioned value overriding default config.
* {@hide} * {@hide}
*/ */
interface IImsConfig { interface IImsConfig {