【笔记】Android Telephony | SIM 卡管理和subId、slotId、phoneId 定义关系说明

相关业务背景

DSDS双卡双待 ：手机可以插入两张手机卡，而且能同时待机，但是某一时刻只能有一张卡上有电话。

一个SIM卡代表一个账号，那么双卡手机就意味着多账户，需要增加多账户管理和业务处理。

• 账号管理：双卡手机提供界面给设置默认打电话、发短信和上网卡等。
• 业务管理：基于两卡的独立性，双卡设备需要提供双卡进行通话业务设置（呼叫限制、呼叫转移）和网络业务设置（数据开关、数据漫游开关、VoLTE、VoWiFi业务开关等）。

和单卡业务类似，只是处理前需要选定一个账号，因此就需要正确的subId、slotId、phoneId等参数确认和区分业务卡。

SIM卡有关ID介绍

为了区分不同的卡，在Android上实现了多种id，如：slotId、phoneId、subId等，定义区别如下：

XID	定义和特殊场景说明
ICCID	SIM 卡的唯一标识。 在SIM卡加载完成后，Telephony 以ICCID为关键字在数据库中查找，如果没有找到 ，则说明此卡第一次插入，则在数据库中添加此SIM卡记录（siminfo表）；如果找到则更新原有记录，但是此记录在数据库中的序号不变，即subId不变。
Sub Id	siminfo表中的Primary Key，从1开始的整数，标识卡记录在数据库表中的顺序号。 第1张插入的卡是1，之后累加。 - SIM卡可以切换卡槽 ，但是subId不会变。phoneId和slotId会0/1变化。 - Android 平台，在手机关机时会将当前使用的SIM卡Slot ID设为-1，在下次开机时检测到加载成功的SIM卡后将对应的Slot ID设为0或1（这样当通过SubscriptionManager接口请求当前可用Sub info时，就能从db中检索SlotID不为-1的SIM卡即可）。
Phone Id	Phone 实例对应的ID，双卡设备的phoneId是0或1。
Slot Id	卡槽ID，当前可以认为slotId 和 phoneId 是相同的。

ID 变化规则和关系

ICCID、Sub ID 和 slot ID 都是 siminfo 数据库中的字段

• Phone ID 和 Slot ID 当前可认为是一样的，跟卡槽对应，卡1的 ID 是0，卡2是1；
• 切换卡槽，subId不变，phoneId 和 slotId 变化
• SubscrptionManager 提供接口对 phoneId 进行转换。
  • subId 指示当前使用的SIM卡，phoneId/slotId 只关注卡槽。
• 每张SIM卡都有一个对应的Subscription，用运营商的SIM卡就相当于订阅(Subscription)其业务。

API 函数名	参数 ID	隐藏/公开	功能作用
getActiveSubscriptionInfo(int sudId)	subId	公开	获取指定 subId 的当前可用的SIM卡信息
isNetworkRoaming(int subId)	subId	公开	查询指定 subId 的漫游数据开关状态
getAcitiveSubscriptionInfoForSimSlotIndex(int slotIndex)	slotId	公开	获取指定SlotId的当前可用SIM卡信息
getActiveSubscriptionInfoForIccIndex(String iccId)	ICCID	hide	获取指定ICCID的当前可用SIM卡信息
setDisplayName(String displayName, int subId)	subId	hide	将指定subId 的SIM卡显示名称保存到数据库
setDataRoaming(int roaming,  int subId)	subId	hide	将指定subId 的SIM卡漫游开关保存到数据库
getSlotIndex(int subId)	subId	hide	获取subId对应的slotId
getSubId(int slotIndex)	subId	hide	获取slotId对应的subId

数据库

双卡业务相关设置项分别保存在Settings 数据库、网络端（通话设置：呼叫转移和呼叫限制）和Telephony 数据库（telephony.db，需要权限）

获取telephony.db数据库文件：

adb  pull data/user_de/0/com.android.providers.telephony/databases

双卡设置在Settings 应用界面。

设置项	子设置项	Android KEY	保存位置
双卡设置	默认数据卡	Settings.Global.MULTI_SIM_DATA_CALL_SUBSCRIPTION	Settings数据库
	默认通话卡	Settings.Global.MULTI_SIM_VOICE_CALL_SUBSCRIPTION
	默认彩信卡	Settings.Global.MULTI_SIM_SMS_SUBSCRIPTION
网络设置（卡 1和卡2）	数据开关	Settings.Global.Mobile_DATA + subId
	数据漫游开关	Settings.Global.DATA_ROAMING + subId
	网络模式选择	Settings.Global.PREFERRED_NETWORK_MODE + subId
	VoLTE功能开关	SubscriptiionManager.ENHANCED_4G_MODE_ENABLED	Telephony.db 的siminfo表
	ViLTE功能开关	SubscriptiionManager.VT_IMS_ENABLED
	WFC功能开关	SubscriptiionManager.WFC_IMS_ENABLED

代码案例

在注册状态变化时（onSubscriptionsChanged）更新PhoneId。

    //添加注册状态变化的监听器
    private final SubscriptionManager.OnSubscriptionsChangedListener mOnSubscriptionsChangedListener =
            new SubscriptionManager.OnSubscriptionsChangedListener() {
        @Override
        public void onSubscriptionsChanged() {
            //获取上下文信息
            final Activity activity = getActivity();
            if (activity == null || activity.isFinishing() || activity.isDestroyed()) {
                return;
            }
            final List mSubList =
                    SubscriptionUtil.getAvailableSubscriptions(getContext());
            SubscriptionInfo mSubInfo = null;

            for (SubscriptionInfo subInfo : mSubList) {
                Log.d(TAG, "onSubscriptionsChanged: subInfo = " + subInfo.toString());
                if (subInfo.getSubscriptionId() == mSubId) {
                    mSubInfo = subInfo;
                    //校验PhoneId正常并更新的方法
                    if (!SubscriptionManager.isValidPhoneId(mPhoneId)) {
                        mPhoneId = SubscriptionManager.getPhoneId(mSubId);
                        Log.d(TAG, "onSubscriptionsChanged: mPhoneId = " + mPhoneId);
                        if (SubscriptionManager.isValidPhoneId(mPhoneId)) {
                            mPhone = PhoneFactory.getPhone(mPhoneId);
                        }
                    }
                    break;
                }
            }
            if (mSubInfo == null) {
                Log.d(TAG, "onSubscriptionsChanged: can't find subInfo for subId " + mSubId, so call finish()");
            }
        }
    };

通过subId获取phoneId。疑问：通过subid获取phoneId为什么会异常？
 

        if (mSubId != SubscriptionManager.INVALID_SUBSCRIPTION_ID) {
            int mPhoneId = SubscriptionManager.getPhoneId(mSubId); //会异常啊
            
            if (!SubscriptionManager.isValidPhoneId(mPhoneId)) {
                mPhoneId = getPhoneIdFromSubId(mSubId, phoneId);
                log("getPhone: phoneIdFromSubId: " + phoneId);
            }

            //phoneId合法，则根据ID获取Phone对象
            if (SubscriptionManager.isValidPhoneId(phoneId)) {
                log("updatePhone :: isValidPhoneId: ");
                mPhone = PhoneFactory.getPhone(phoneId);
            }
        }

//类似源码命名：getActiveSubscriptionInfoForIccIndex，通过iccid获取subId，用for。
    //通过subId 获取PhoneId（源码命名是For的）
    private int getPhoneIdFromSubId(int subId, int phoneId){
        int phoneIdFromSubId = phoneId;
        //获取注册信息列表
        List subscriptionInfoList = mSubscriptionManager.getAvailableSubscriptionInfoList();
        String iccidForSub = null;
        if (subscriptionInfoList != null) {
            for (SubscriptionInfo si : subscriptionInfoList) {
                if (si.getSubscriptionId() == subId){
                    iccidForSub = si.getIccId();
                    break;
                }
            }
        }
        List cardsInfos = mTelephonyManager.getUiccCardsInfo();
        if (cardsInfo != null) {
            for (UiccCardInfo info : cardsInfos) {
                if (info != null) {
                    String iccid = info.getIccId();
                    if (iccidForSub != null && iccidForSub.equals(iccid)) {
                        phoneIdFromSubId = info.getSlotIndex();
                        break;
                    }
                }
            }
        }
        return phoneIdFromSubId;
    }