电子说
说明:
开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
import sim from '@ohos.telephony.sim';
isSimActive(slotId: number, callback: AsyncCallback): void
获取指定卡槽SIM卡是否激活,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。 |
示例:
sim.isSimActive(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
isSimActive(slotId: number): Promise
获取指定卡槽SIM卡是否激活,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回指定卡槽是否激活,如果激活返回true。 |
示例:
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)}`);
});
getDefaultVoiceSlotId(callback: AsyncCallback): void
获取默认语音业务的卡槽ID,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback | 是 | 回调函数。 |
示例:
sim.getDefaultVoiceSlotId((err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
getDefaultVoiceSlotId(): Promise
获取默认语音业务的卡槽ID,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回默认语音业务的卡槽ID。 |
示例:
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)}`);
});
hasOperatorPrivileges(slotId: number, callback: AsyncCallback): void
检查应用(调用者)是否已被授予运营商权限,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。 |
示例:
sim.hasOperatorPrivileges(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
hasOperatorPrivileges(slotId: number): Promise
检查应用(调用者)是否已被授予运营商权限,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回检查应用(调用者)是否已被授予运营商权限。 |
示例:
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)}`);
});
getISOCountryCodeForSim(slotId: number, callback: AsyncCallback): void
获取指定卡槽SIM卡的ISO国家码,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。返回国家码,例如:CN(中国)。 |
示例:
sim.getISOCountryCodeForSim(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
getISOCountryCodeForSim(slotId: number): Promise
获取指定卡槽SIM卡的ISO国家码,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回获取指定卡槽SIM卡的ISO国家码,例如:CN(中国)。 |
示例:
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)}`);
});
getSimOperatorNumeric(slotId: number, callback: AsyncCallback): void
获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。 |
示例:
sim.getSimOperatorNumeric(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
getSimOperatorNumeric(slotId: number): Promise
获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回获取指定卡槽SIM卡的归属PLMN号。 |
示例:
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)}`);
});
getSimSpn(slotId: number, callback: AsyncCallback): void
获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。 |
示例:
sim.getSimSpn(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
getSimSpn(slotId: number): Promise
获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回获取指定卡槽SIM卡的SPN。 |
示例:
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)}`);
});
getSimState(slotId: number, callback: AsyncCallback): void
获取指定卡槽的SIM卡状态,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback<[SimState]> | 是 | 回调函数。参考SimState。 |
示例:
sim.getSimState(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
getSimState(slotId: number): Promise
获取指定卡槽的SIM卡状态,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise<[SimState]> | 以Promise形式返回获取指定卡槽的SIM卡状态。 |
示例:
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)}`);
});
getCardType(slotId: number, callback: AsyncCallback): void
获取指定卡槽SIM卡的卡类型,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback<[CardType]> | 是 | 回调函数。 |
示例:
sim.getCardType(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
getCardType(slotId: number): Promise
获取指定卡槽SIM卡的卡类型,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise<[CardType]> | 以Promise形式返回指定卡槽SIM卡的卡类型。 |
示例:
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)}`);
});
hasSimCard(slotId: number, callback: AsyncCallback): void
获取指定卡槽SIM卡是否插卡,使用callback方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。 |
示例:
sim.hasSimCard(0, (err, data) = > {
console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});
hasSimCard(slotId: number): Promise
获取指定卡槽SIM卡是否插卡,使用Promise方式作为异步方法。
系统能力 :SystemCapability.Communication.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回指定卡槽是否插卡,如果插卡返回true。 |
示例:
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)}`);
});
getMaxSimCount(): number
获取卡槽数量。
系统能力 :SystemCapability.Communication.CoreService
返回值:
类型 | 说明 |
---|---|
number | 卡槽数量。 |
示例:
console.log("Result: "+sim.getMaxSimCount())
SIM卡状态。
系统能力 :以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 值 | 说明 |
---|---|---|
SIM_STATE_UNKNOWN | 0 | SIM卡状态未知,即无法获取准确的状态。 |
SIM_STATE_NOT_PRESENT | 1 | 表示SIM卡处于not present状态,即卡槽中没有插入SIM卡。 |
SIM_STATE_LOCKED | 2 | 表示SIM卡处于locked状态,即SIM卡被PIN、PUK或网络锁锁定。 |
SIM_STATE_NOT_READY | 3 | 表示SIM卡处于not ready状态,即SIM卡在位但无法正常工作。 |
SIM_STATE_READY | 4 | 表示SIM卡处于ready状态,即SIM卡在位且工作正常。 |
SIM_STATE_LOADED | 5 | 表示SIM卡处于loaded状态,即SIM卡在位且所有卡文件加载完毕。HarmonyOS与OpenHarmony鸿蒙文档籽料:mau123789是v直接拿 |
卡类型。
系统能力 :以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 值 | 说明 |
---|---|---|
UNKNOWN_CARD | -1 | 未知类型 |
SINGLE_MODE_SIM_CARD | 10 | 单SIM卡 |
SINGLE_MODE_USIM_CARD | 20 | 单USIM卡 |
SINGLE_MODE_RUIM_CARD | 30 | 单RUIM卡 |
DUAL_MODE_CG_CARD | 40 | 双卡模式C+G |
CT_NATIONAL_ROAMING_CARD | 41 | 中国电信内部漫游卡 |
CU_DUAL_MODE_CARD | 42 | 中国联通双模卡 |
DUAL_MODE_TELECOM_LTE_CARD | 43 | 双模式电信LTE卡 |
DUAL_MODE_UG_CARD | 50 | 双模式UG卡 |
SINGLE_MODE_ISIM_CARD8+ | 60 | 单一ISIM卡类型 |
审核编辑 黄宇
全部0条评论
快来发表一下你的评论吧 !