From 5ff1071bdc33720b0b6830872d4a32db139f417a Mon Sep 17 00:00:00 2001 From: maosiping Date: Mon, 7 Mar 2022 16:50:41 +0800 Subject: [PATCH 1/4] =?UTF-8?q?sim=E5=8D=A1=E7=AE=A1=E7=90=86API=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: maosiping --- .../reference/apis/js-apis-sim.md | 202 +++++++++++++++--- 1 file changed, 177 insertions(+), 25 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-sim.md b/zh-cn/application-dev/reference/apis/js-apis-sim.md index abdaf41abbe..be20dadb898 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sim.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sim.md @@ -10,11 +10,11 @@ import sim from '@ohos.telephony.sim'; ``` -## sim.getSimIccId +## sim.isSimActive -getSimIccId\(slotId: number, callback: AsyncCallback\): void +isSimActive\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽SIM卡的ICCID（Integrate Circuit Card Identity），使用callback方式作为异步方法。 +获取指定卡槽SIM卡的是否激活，使用callback方式作为异步方法。 需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 @@ -23,22 +23,22 @@ getSimIccId\(slotId: number, callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------- | ---- | -------------------------------------- | | slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | -| callback | AsyncCallback<string> | 是 | 回调函数。 | +| callback | AsyncCallback<boolean> | 是 | 回调函数。 | **示例：** ``` -sim.getSimIccId(0, (err, data) => { +sim.isSimActive(0, (err, data) => { console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` -## sim.getSimIccId +## sim.isSimActive -getSimIccId\(slotId: number\): Promise +isSimActive\(slotId: number\): Promise -获取指定卡槽SIM卡的ICCID（Integrate Circuit Card Identity），使用Promise方式作为异步方法。 +获取指定卡槽SIM卡的是否激活，使用Promise方式作为异步方法。 需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 @@ -52,19 +52,20 @@ getSimIccId\(slotId: number\): Promise | 类型 | 说明 | | --------------------- | ---------------------------------- | -| Promise<string> | 以Promise形式返回指定卡槽的ICCID。 | +| Promise<boolean> | 以Promise形式返回指定卡槽的是否激活，如果激活返回true。 | **示例：** ``` -let promise = sim.getSimIccId(0); +let promise = sim.isSimActive(0); promise.then(data => { - console.log(`getSimIccId success, promise: data->${JSON.stringify(data)}`); + console.log(`isSimActive success, promise: data->${JSON.stringify(data)}`); }).catch(err => { - console.log(`getSimIccId fail, promise: err->${JSON.stringify(err)}`); + console.log(`isSimActive fail, promise: err->${JSON.stringify(err)}`); }); ``` + ## sim.getDefaultVoiceSlotId7+ getDefaultVoiceSlotId\(callback: AsyncCallback\): void @@ -109,6 +110,63 @@ promise.then(data => { }); ``` + +## sim.hasOperatorPrivileges + +hasOperatorPrivileges\(slotId: number, callback: AsyncCallback\): void + +检查应用是否操作电话服务的权限，使用callback方式作为异步方法。 + +需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------- | ---- | -------------------------------------- | +| slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | +| callback | AsyncCallback<boolean> | 是 | 回调函数。 | + +**示例：** + +``` +sim.hasOperatorPrivileges(0, (err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); +}); +``` + + +## sim.hasOperatorPrivileges + +hasOperatorPrivileges\(slotId: number\): Promise + +检查应用是否操作电话服务的权限，使用Promise方式作为异步方法。 + +需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------------- | +| slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | + +**返回值：** + +| 类型 | 说明 | +| --------------------- | ---------------------------------- | +| Promise<boolean> | 以Promise形式返回指应用是否操作电话服务的权限，如果有返回true。 | + +**示例：** + +``` +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 @@ -316,11 +374,11 @@ promise.then(data => { }); ``` -## sim.getSimGid1 +## sim.getCardType -getSimGid1\(slotId: number, callback: AsyncCallback\): void +getCardType\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽SIM卡的GID1\(Group Identifier Level 1\)，使用callback方式作为异步方法。 +获取指定卡槽SIM卡的卡类型，使用callback方式作为异步方法。 需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 @@ -329,22 +387,22 @@ getSimGid1\(slotId: number, callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ----------------------- | ---- | -------------------------------------- | | slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | -| callback | AsyncCallback\ | 是 | 回调函数。 | +| callback | AsyncCallback\<[CardType](#cardtype)\> | 是 | 回调函数。 | **示例：** ``` -sim.getSimGid1(0, (err, data) => { +sim.getCardType(0, (err, data) => { console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` -## sim.getSimGid1 +## sim.getCardType -getSimGid1\(slotId: number\): Promise +getCardType\(slotId: number\): Promise -获取指定卡槽SIM卡的GID1\(Group Identifier Level 1\)，使用Promise方式作为异步方法。 +获取指定卡槽SIM卡的卡类型，使用Promise方式作为异步方法。 需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 @@ -358,20 +416,97 @@ getSimGid1\(slotId: number\): Promise | 类型 | 说明 | | ----------------- | ------------------------------------------------------------ | -| Promise\ | 以Promise形式返回获取指定卡槽SIM卡的GID1(Group Identifier Level 1)。 | +| Promise\<[CardType](#cardtype)\> | 以Promise形式返回指定卡槽SIM卡的卡类型。 | **示例：** ``` -let promise = sim.getSimGid1(0); +let promise = sim.getCardType(0); promise.then(data => { - console.log(`getSimGid1 success, promise: data->${JSON.stringify(data)}`); + console.log(`getCardType success, promise: data->${JSON.stringify(data)}`); }).catch(err => { - console.log(`getSimGid1 fail, promise: err->${JSON.stringify(err)}`); + console.log(`getCardType fail, promise: err->${JSON.stringify(err)}`); }); ``` +## sim.hasSimCard + +hasSimCard\(slotId: number, callback: AsyncCallback\): void + +获取指定卡槽SIM卡的是否插卡，使用callback方式作为异步方法。 + +需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------- | ---- | -------------------------------------- | +| slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | +| callback | AsyncCallback<boolean> | 是 | 回调函数。 | + +**示例：** + +``` +sim.hasSimCard(0, (err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); +}); +``` + + +## sim.hasSimCard + +hasSimCard\(slotId: number\): Promise + +获取指定卡槽SIM卡的是否插卡，使用Promise方式作为异步方法。 + +需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------------- | +| slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | + +**返回值：** + +| 类型 | 说明 | +| --------------------- | ---------------------------------- | +| Promise<boolean> | 以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)}`); +}); +``` + + +## sim.getMaxSimCount + +getMaxSimCount\(\): number + +获取卡槽数量。 + +需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 + +**返回值：** + +| 类型 | 说明 | +| ----------------- | ------------------------------------------------------------ | +| number | 卡槽数量。 | + +**示例：** + +``` +console.log(sim.getMaxSimCount()) +``` + + ## SimState SIM卡状态。 @@ -383,4 +518,21 @@ SIM卡状态。 | SIM_STATE_LOCKED | 表示SIM卡处于locked状态，即SIM卡被PIN、PUK或网络锁锁定。 | | SIM_STATE_NOT_READY | 表示SIM卡处于not ready状态，即SIM卡在位但无法正常工作。 | | SIM_STATE_READY | 表示SIM卡处于ready状态，即SIM卡在位且工作正常。 | -| SIM_STATE_LOADED | 表示SIM卡处于loaded状态，即SIM卡在位且所有卡文件加载完毕。 | \ No newline at end of file +| SIM_STATE_LOADED | 表示SIM卡处于loaded状态，即SIM卡在位且所有卡文件加载完毕。 | + +## CardType + +卡类型。 + +| 变量 | 值 | 说明 | +| ----- | ----- | ----- | +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_CARD | 60 | 单一ISIM卡类型 | \ No newline at end of file -- Gitee From 1c78c4deb026b2bde63248a85f3942be0df77dd2 Mon Sep 17 00:00:00 2001 From: maosiping Date: Mon, 7 Mar 2022 17:00:38 +0800 Subject: [PATCH 2/4] =?UTF-8?q?SIM=E5=8D=A1=E7=AE=A1=E7=90=86=E8=B5=84?= =?UTF-8?q?=E6=96=99=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: maosiping --- .../reference/apis/js-apis-sim.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-sim.md b/zh-cn/application-dev/reference/apis/js-apis-sim.md index be20dadb898..e0b6edcb493 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sim.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sim.md @@ -16,7 +16,7 @@ isSimActive\(slotId: number, callback: AsyncCallback\): void 获取指定卡槽SIM卡的是否激活，使用callback方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -40,7 +40,7 @@ isSimActive\(slotId: number\): Promise 获取指定卡槽SIM卡的是否激活，使用Promise方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -117,7 +117,7 @@ hasOperatorPrivileges\(slotId: number, callback: AsyncCallback\): void 检查应用是否操作电话服务的权限，使用callback方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -141,7 +141,7 @@ hasOperatorPrivileges\(slotId: number\): Promise 检查应用是否操作电话服务的权限，使用Promise方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -380,7 +380,7 @@ getCardType\(slotId: number, callback: AsyncCallback\): void 获取指定卡槽SIM卡的卡类型，使用callback方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -404,7 +404,7 @@ getCardType\(slotId: number\): Promise 获取指定卡槽SIM卡的卡类型，使用Promise方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -436,7 +436,7 @@ hasSimCard\(slotId: number, callback: AsyncCallback\): void 获取指定卡槽SIM卡的是否插卡，使用callback方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -460,7 +460,7 @@ hasSimCard\(slotId: number\): Promise 获取指定卡槽SIM卡的是否插卡，使用Promise方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **参数：** @@ -492,7 +492,7 @@ getMaxSimCount\(\): number 获取卡槽数量。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。 +**需要权限**：ohos.permission.GET_TELEPHONY_STATE **返回值：** -- Gitee From 60d2951702aaedbeabf8eb969c2d9a20cd0506eb Mon Sep 17 00:00:00 2001 From: maosiping Date: Mon, 7 Mar 2022 17:31:04 +0800 Subject: [PATCH 3/4] =?UTF-8?q?SIM=E5=8D=A1=E7=AE=A1=E7=90=86=E8=B5=84?= =?UTF-8?q?=E6=96=99=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: maosiping --- .../reference/apis/js-apis-sim.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-sim.md b/zh-cn/application-dev/reference/apis/js-apis-sim.md index e0b6edcb493..4315d2ecd6f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sim.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sim.md @@ -14,7 +14,7 @@ import sim from '@ohos.telephony.sim'; isSimActive\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽SIM卡的是否激活，使用callback方式作为异步方法。 +获取指定卡槽SIM卡是否激活，使用callback方式作为异步方法。 **需要权限**：ohos.permission.GET_TELEPHONY_STATE @@ -38,7 +38,7 @@ sim.isSimActive(0, (err, data) => { isSimActive\(slotId: number\): Promise -获取指定卡槽SIM卡的是否激活，使用Promise方式作为异步方法。 +获取指定卡槽SIM卡是否激活，使用Promise方式作为异步方法。 **需要权限**：ohos.permission.GET_TELEPHONY_STATE @@ -52,7 +52,7 @@ isSimActive\(slotId: number\): Promise | 类型 | 说明 | | --------------------- | ---------------------------------- | -| Promise<boolean> | 以Promise形式返回指定卡槽的是否激活，如果激活返回true。 | +| Promise<boolean> | 以Promise形式返回指定卡槽是否激活，如果激活返回true。 | **示例：** @@ -115,7 +115,7 @@ promise.then(data => { hasOperatorPrivileges\(slotId: number, callback: AsyncCallback\): void -检查应用是否操作电话服务的权限，使用callback方式作为异步方法。 +检查应用是否已经被赋予权限，使用callback方式作为异步方法。 **需要权限**：ohos.permission.GET_TELEPHONY_STATE @@ -139,7 +139,7 @@ sim.hasOperatorPrivileges(0, (err, data) => { hasOperatorPrivileges\(slotId: number\): Promise -检查应用是否操作电话服务的权限，使用Promise方式作为异步方法。 +检查应用是否已经被赋予权限，使用Promise方式作为异步方法。 **需要权限**：ohos.permission.GET_TELEPHONY_STATE @@ -434,7 +434,7 @@ promise.then(data => { hasSimCard\(slotId: number, callback: AsyncCallback\): void -获取指定卡槽SIM卡的是否插卡，使用callback方式作为异步方法。 +获取指定卡槽SIM卡是否插卡，使用callback方式作为异步方法。 **需要权限**：ohos.permission.GET_TELEPHONY_STATE @@ -458,7 +458,7 @@ sim.hasSimCard(0, (err, data) => { hasSimCard\(slotId: number\): Promise -获取指定卡槽SIM卡的是否插卡，使用Promise方式作为异步方法。 +获取指定卡槽SIM卡是否插卡，使用Promise方式作为异步方法。 **需要权限**：ohos.permission.GET_TELEPHONY_STATE @@ -472,7 +472,7 @@ hasSimCard\(slotId: number\): Promise | 类型 | 说明 | | --------------------- | ---------------------------------- | -| Promise<boolean> | 以Promise形式返回指定卡槽的是否插卡，如果插卡返回true。 | +| Promise<boolean> | 以Promise形式返回指定卡槽是否插卡，如果插卡返回true。 | **示例：** -- Gitee From 2848ae746dda6a3e63533dc2cda0d1d735b41c42 Mon Sep 17 00:00:00 2001 From: maosiping Date: Mon, 7 Mar 2022 20:08:09 +0800 Subject: [PATCH 4/4] =?UTF-8?q?SIM=E5=8D=A1=E7=AE=A1=E7=90=86=E8=B5=84?= =?UTF-8?q?=E6=96=99=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: maosiping --- .../reference/apis/js-apis-sim.md | 56 ------------------- 1 file changed, 56 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-sim.md b/zh-cn/application-dev/reference/apis/js-apis-sim.md index 4315d2ecd6f..4adc8b442a2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sim.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sim.md @@ -111,62 +111,6 @@ promise.then(data => { ``` -## sim.hasOperatorPrivileges - -hasOperatorPrivileges\(slotId: number, callback: AsyncCallback\): void - -检查应用是否已经被赋予权限，使用callback方式作为异步方法。 - -**需要权限**：ohos.permission.GET_TELEPHONY_STATE - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | --------------------------- | ---- | -------------------------------------- | -| slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | -| callback | AsyncCallback<boolean> | 是 | 回调函数。 | - -**示例：** - -``` -sim.hasOperatorPrivileges(0, (err, data) => { - console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); -}); -``` - - -## sim.hasOperatorPrivileges - -hasOperatorPrivileges\(slotId: number\): Promise - -检查应用是否已经被赋予权限，使用Promise方式作为异步方法。 - -**需要权限**：ohos.permission.GET_TELEPHONY_STATE - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------ | ---- | -------------------------------------- | -| slotId | number | 是 | 卡槽ID。
- 0：卡槽1
- 1：卡槽2 | - -**返回值：** - -| 类型 | 说明 | -| --------------------- | ---------------------------------- | -| Promise<boolean> | 以Promise形式返回指应用是否操作电话服务的权限，如果有返回true。 | - -**示例：** - -``` -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 -- Gitee