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