SIM卡管理

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨標(biāo)記接口的起始版本。

導(dǎo)入模塊

import sim from '@ohos.telephony.sim';

sim.isSimActive7+

isSimActive(slotId: number, callback: AsyncCallback): void

獲取指定卡槽SIM卡是否激活，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.isSimActive(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.isSimActive7+

isSimActive(slotId: number): Promise

獲取指定卡槽SIM卡是否激活，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.isSimActive(0);
promise.then(data = > {
    console.log(`isSimActive success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`isSimActive fail, promise: err- >${JSON.stringify(err)}`);
});

sim.getDefaultVoiceSlotId7+

getDefaultVoiceSlotId(callback: AsyncCallback): void

獲取默認(rèn)語音業(yè)務(wù)的卡槽ID，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.getDefaultVoiceSlotId((err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.getDefaultVoiceSlotId7+

getDefaultVoiceSlotId(): Promise

獲取默認(rèn)語音業(yè)務(wù)的卡槽ID，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

返回值：

示例：

let promise = sim.getDefaultVoiceSlotId();
promise.then(data = > {
    console.log(`getDefaultVoiceSlotId success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getDefaultVoiceSlotId fail, promise: err- >${JSON.stringify(err)}`);
});

sim.hasOperatorPrivileges7+

hasOperatorPrivileges(slotId: number, callback: AsyncCallback): void

檢查應(yīng)用（調(diào)用者）是否已被授予運營商權(quán)限，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.hasOperatorPrivileges(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.hasOperatorPrivileges7+

hasOperatorPrivileges(slotId: number): Promise

檢查應(yīng)用（調(diào)用者）是否已被授予運營商權(quán)限，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.hasOperatorPrivileges(0);
promise.then(data = > {
    console.log(`hasOperatorPrivileges success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`hasOperatorPrivileges fail, promise: err- >${JSON.stringify(err)}`);
});

sim.getISOCountryCodeForSim

getISOCountryCodeForSim(slotId: number, callback: AsyncCallback): void

獲取指定卡槽SIM卡的ISO國家碼，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.getISOCountryCodeForSim(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.getISOCountryCodeForSim

getISOCountryCodeForSim(slotId: number): Promise

獲取指定卡槽SIM卡的ISO國家碼，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.getISOCountryCodeForSim(0);
promise.then(data = > {
    console.log(`getISOCountryCodeForSim success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getISOCountryCodeForSim fail, promise: err- >${JSON.stringify(err)}`);
});

sim.getSimOperatorNumeric

getSimOperatorNumeric(slotId: number, callback: AsyncCallback): void

獲取指定卡槽SIM卡的歸屬PLMN（Public Land Mobile Network）號，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.getSimOperatorNumeric(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.getSimOperatorNumeric

getSimOperatorNumeric(slotId: number): Promise

獲取指定卡槽SIM卡的歸屬PLMN（Public Land Mobile Network）號，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.getSimOperatorNumeric(0);
promise.then(data = > {
    console.log(`getSimOperatorNumeric success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getSimOperatorNumeric fail, promise: err- >${JSON.stringify(err)}`);
});

sim.getSimSpn

getSimSpn(slotId: number, callback: AsyncCallback): void

獲取指定卡槽SIM卡的服務(wù)提供商名稱（Service Provider Name，SPN），使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.getSimSpn(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.getSimSpn

getSimSpn(slotId: number): Promise

獲取指定卡槽SIM卡的服務(wù)提供商名稱（Service Provider Name，SPN），使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.getSimSpn(0);
promise.then(data = > {
    console.log(`getSimSpn success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getSimSpn fail, promise: err- >${JSON.stringify(err)}`);
});

sim.getSimState

getSimState(slotId: number, callback: AsyncCallback): void

獲取指定卡槽的SIM卡狀態(tài)，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.getSimState(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.getSimState

getSimState(slotId: number): Promise

獲取指定卡槽的SIM卡狀態(tài)，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.getSimState(0);
promise.then(data = > {
    console.log(`getSimState success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getSimState fail, promise: err- >${JSON.stringify(err)}`);
});

sim.getCardType7+

getCardType(slotId: number, callback: AsyncCallback): void

獲取指定卡槽SIM卡的卡類型，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.getCardType(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.getCardType7+

getCardType(slotId: number): Promise

獲取指定卡槽SIM卡的卡類型，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.getCardType(0);
promise.then(data = > {
    console.log(`getCardType success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getCardType fail, promise: err- >${JSON.stringify(err)}`);
});

sim.hasSimCard7+

hasSimCard(slotId: number, callback: AsyncCallback): void

獲取指定卡槽SIM卡是否插卡，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

示例：

sim.hasSimCard(0, (err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

sim.hasSimCard7+

hasSimCard(slotId: number): Promise

獲取指定卡槽SIM卡是否插卡，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

參數(shù)：

返回值：

示例：

let promise = sim.hasSimCard(0);
promise.then(data = > {
    console.log(`hasSimCard success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`hasSimCard fail, promise: err- >${JSON.stringify(err)}`);
});

sim.getMaxSimCount7+

getMaxSimCount(): number

獲取卡槽數(shù)量。

系統(tǒng)能力 ：SystemCapability.Communication.CoreService

返回值：

示例：

console.log("Result: "+sim.getMaxSimCount())

SimState

SIM卡狀態(tài)。

系統(tǒng)能力 ：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CoreService。

CardType7+

卡類型。

系統(tǒng)能力 ：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CoreService。

審核編輯 黃宇