diff --git a/zh-cn/application-dev/js-reference/apis/js-apis-sim.md b/zh-cn/application-dev/js-reference/apis/js-apis-sim.md index 94b83aa123add20ccd0eee25ba59e1a219193ee1..7b1d14bb0a3bbb872c0297887ae3577174ef4be3 100755 --- a/zh-cn/application-dev/js-reference/apis/js-apis-sim.md +++ b/zh-cn/application-dev/js-reference/apis/js-apis-sim.md @@ -15,12 +15,15 @@ - [sim.getSimState](#sim.getSimState-promise) - [sim.getSimGid1](#sim.getSimGid1-callback) - [sim.getSimGid1](#sim.getSimGid1-promise) +- [hasSimCard8+](#hasSimCard) +- [getSimTelephoneNumber8+](#getSimTelephoneNumber) - [SimState](#SimState) >**说明:** > >- 从 API Version 6 开始支持。 >- 标记7+的接口从API Version 7开始支持。 +>- 标记8+的接口从API Version 8开始支持。 ## 导入模块 @@ -32,7 +35,7 @@ import sim from '@ohos.telephony.sim'; getSimIccId\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽SIM卡的ICCID(Integrate Circuit Card Identity),使用callback方式作为异步方法。 +获取指定卡槽SIM卡的ICCID\(Integrate Circuit Card Identity\),使用callback方式作为异步方法。 需要ohos.permission.GET\_TELEPHONY\_STATE权限,该权限为系统权限。 @@ -57,7 +60,7 @@ getSimIccId\(slotId: number, callback: AsyncCallback\): void getSimIccId\(slotId: number\): Promise -获取指定卡槽SIM卡的ICCID(Integrate Circuit Card Identity),使用Promise方式作为异步方法。 +获取指定卡槽SIM卡的ICCID\(Integrate Circuit Card Identity\),使用Promise方式作为异步方法。 需要ohos.permission.GET\_TELEPHONY\_STATE权限,该权限为系统权限。 @@ -71,7 +74,7 @@ getSimIccId\(slotId: number\): Promise | 类型 | 说明 | | --------------------- | ---------------------------------- | - | Promise<string> | 以Promise形式返回指定卡槽的ICCID。 | + | Promise<string> | 以Promise形式返回获取指定卡槽SIM卡的ICCID的结果。 | - 示例 @@ -88,7 +91,7 @@ getSimIccId\(slotId: number\): Promise getDefaultVoiceSlotId\(callback: AsyncCallback\): void -获取默认语音业务的卡槽ID,使用callback方式作为异步方法。 +获取语音业务的默认卡槽,使用callback方式作为异步方法。 - 参数 @@ -109,13 +112,13 @@ getDefaultVoiceSlotId\(callback: AsyncCallback\): void getDefaultVoiceSlotId\(\): Promise -获取默认语音业务的卡槽ID,使用Promise方式作为异步方法。 +获取语音业务的默认卡槽,使用Promise方式作为异步方法。 - 返回值 | 类型 | 说明 | | ----------------- | --------------------------------------- | - | Promise\ | 以Promise形式返回默认语音业务的卡槽ID。 | + | Promise\ | 以Promise形式返回获取语音业务的默认卡槽的结果。 | - 示例 @@ -137,9 +140,9 @@ getISOCountryCodeForSim\(slotId: number, callback: AsyncCallback\): voi - 参数 | 参数名 | 类型 | 必填 | 说明 | - | -------- | ----------------------- | ---- | ---------------------------------------- | - | slotId | number | 是 | 卡槽ID。
- 0:卡槽1
- 1:卡槽2 | - | callback | AsyncCallback\ | 是 | 回调函数。返回国家码,例如:CN(中国)。 | + | -------- | ----------------------- | ---- | ----------------------------------------| + | slotId | number | 是 | 卡槽ID。
- 0:卡槽1
- 1:卡槽2 | + | callback | AsyncCallback\ | 是 | 回调函数。 | - 示例 @@ -166,7 +169,7 @@ getISOCountryCodeForSim\(slotId: number\): Promise | 类型 | 说明 | | ----------------- | ------------------------------------------------------------ | - | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的ISO国家码,例如:CN(中国)。 | + | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的ISO国家码的结果。 | - 示例 @@ -184,7 +187,7 @@ getISOCountryCodeForSim\(slotId: number\): Promise getSimOperatorNumeric\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用callback方式作为异步方法。 +获取指定卡槽SIM卡的归属PLMN\(Public Land Mobile Network\)号,使用callback方式作为异步方法。 - 参数 @@ -206,7 +209,7 @@ getSimOperatorNumeric\(slotId: number, callback: AsyncCallback\): void getSimOperatorNumeric\(slotId: number\): Promise -获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用Promise方式作为异步方法。 +获取指定卡槽SIM卡的归属PLMN\(Public Land Mobile Network\)号,使用Promise方式作为异步方法。 - 参数 @@ -218,7 +221,7 @@ getSimOperatorNumeric\(slotId: number\): Promise | 类型 | 说明 | | ----------------- | ------------------------------------------------ | - | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的归属PLMN号。 | + | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的归属PLMN号的结果。 | - 示例 @@ -236,7 +239,7 @@ getSimOperatorNumeric\(slotId: number\): Promise getSimSpn\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用callback方式作为异步方法。 +获取指定卡槽SIM卡的运营商SPN\(Service Provider Name\),使用callback方式作为异步方法。 - 参数 @@ -258,7 +261,7 @@ getSimSpn\(slotId: number, callback: AsyncCallback\): void getSimSpn\(slotId: number\): Promise -获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用Promise方式作为异步方法。 +获取指定卡槽SIM卡的运营商SPN\(Service Provider Name\),使用Promise方式作为异步方法。 - 参数 @@ -270,7 +273,7 @@ getSimSpn\(slotId: number\): Promise | 类型 | 说明 | | ----------------- | ----------------------------------------- | - | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的SPN。 | + | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的SPN的结果。| - 示例 @@ -288,7 +291,7 @@ getSimSpn\(slotId: number\): Promise getSimState\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽的SIM卡状态,使用callback方式作为异步方法。 +获取指定卡槽SIM卡状态,使用callback方式作为异步方法。 - 参数 @@ -310,7 +313,7 @@ getSimState\(slotId: number, callback: AsyncCallback\): void getSimState\(slotId: number\): Promise -获取指定卡槽的SIM卡状态,使用Promise方式作为异步方法。 +获取指定卡槽SIM卡状态,使用Promise方式作为异步方法。 - 参数 @@ -322,7 +325,7 @@ getSimState\(slotId: number\): Promise | 类型 | 说明 | | -------------------------------- | ------------------------------------------ | - | Promise\<[SimState](#SimState)\> | 以Promise形式返回获取指定卡槽的SIM卡状态。 | + | Promise\<[SimState](#SimState)\> | 以Promise形式返回获取指定卡槽SIM卡状态的结果。 | - 示例 @@ -377,7 +380,7 @@ getSimGid1\(slotId: number\): Promise | 类型 | 说明 | | ----------------- | ------------------------------------------------------------ | - | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的GID1(Group Identifier Level 1)。 | + | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的GID1(Group Identifier Level 1)的结果。 | - 示例 @@ -390,6 +393,113 @@ getSimGid1\(slotId: number\): Promise }); ``` +## sim.hasSimCard8+ + +hasSimCard\(slotId: number, callback: AsyncCallback\): void + +检查SIM卡是否插入指定卡槽,使用callback方式作为异步方法。 + +- 参数 + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | ----------------------- | ---- | -------------------------------------- | + | 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)}`); + }); + ``` + + +## sim.hasSimCard8+ + +hasSimCard\(slotId: number\): Promise + +检查SIM卡是否插入指定卡槽,使用Promise方式作为异步方法。 + +- 参数 + + | 参数名 | 类型 | 必填 | 说明 | + | ------ | ------ | ---- | -------------------------------------- | + | slotId | number | 是 | 卡槽ID。
- 0:卡槽1
- 1:卡槽2 | + +- 返回值 + + | 类型 | 说明 | + | ----------------- | ------------------------------------------------------------ | + | Promise\ | 以Promise形式返回检查SIM卡是否插入指定卡槽的结果。 | + +- 示例 + + ``` + let p = sim.hasSimCard(0); + p.then(data => { + console.log(`hasSimCard test success, promise: data->${JSON.stringify(data)}`); + }).catch(err => { + console.log(`hasSimCard test fail, promise: err->${JSON.stringify(err)}`); + }); + ``` + + +## sim.getSimTelephoneNumber8+ + +getSimTelephoneNumber\(slotId: number, callback: AsyncCallback\): void + +获取指定卡槽SIM卡的MSISDN,使用callback方式作为异步方法。 + +需要ohos.permission.GET\_TELEPHONY\_STATE权限,该权限为系统权限。 + +- 参数 + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | ----------------------- | ---- | -------------------------------------- | + | slotId | number | 是 | 卡槽ID。
- 0:卡槽1
- 1:卡槽2 | + | callback | AsyncCallback\ | 是 | 回调函数。 | + +- 示例 + + ``` + sim.getSimTelephoneNumber(0, (err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); + }); + ``` + + +## sim.getSimTelephoneNumber8+ + +getSimTelephoneNumber\(slotId: number\): Promise + +获取指定卡槽SIM卡的MSISDN,使用Promise方式作为异步方法。 + +需要ohos.permission.GET\_TELEPHONY\_STATE权限,该权限为系统权限。 + +- 参数 + + | 参数名 | 类型 | 必填 | 说明 | + | ------ | ------ | ---- | -------------------------------------- | + | slotId | number | 是 | 卡槽ID。
- 0:卡槽1
- 1:卡槽2 | + +- 返回值 + + | 类型 | 说明 | + | ----------------- | ------------------------------------------------------------ | + | Promise\ | 以Promise形式返回获取指定卡槽SIM卡的MSISDN的结果。 | + +- 示例 + + ``` + let p = sim.getSimTelephoneNumber(0); + p.then(data => { + console.log(`getSimTelephoneNumber test success, promise: data->${JSON.stringify(data)}`); + }).catch(err => { + console.log(`getSimTelephoneNumber test fail, promise: err->${JSON.stringify(err)}`); + }); + ``` + ## SimState