Skip to content

D
Docs

OpenHarmony / Docs
11 个月 前同步成功

通知 159
Star 292
Fork 28
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

未验证 提交 67c2d36e 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!19545 docs-卡账户接口问题资料整改 

Merge pull request !19545 from Aurora/master
上级 2ac78acb 45576551
隐藏空白更改
内联 并排
Showing with 265 addition and 19 deletion
zh-cn/application-dev/reference/apis/js-apis-observer.md
浏览文件 @ 67c2d36e
......@@ -849,6 +849,83 @@ observer.off('simStateChange', callback);
observer.off('simStateChange');
```
## observer.on('iccAccountInfoChange')<sup>10+</sup>
on\(type: 'iccAccountInfoChange', callback: Callback\<void\>\): void;
订阅卡帐户变化事件，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.StateRegistry
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 卡帐户变化事件，参数固定为'iccAccountInfoChange'。 |
| callback | Callback\<void\> | 是 | 回调函数。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300999 | Unknown error code. |
**示例：**
```js
observer.on('iccAccountInfoChange', error => {
console.log("on iccAccountInfoChange, error:" + JSON.stringify(error));
});
```
## observer.off('iccAccountInfoChange')<sup>10+</sup>
off\(type: 'iccAccountInfoChange', callback?: Callback\<void\>\): void;
移除订阅卡帐户变化事件，使用callback方式作为异步方法。
>**说明：**
>
>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
**系统能力**：SystemCapability.Telephony.StateRegistry
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 卡帐户变化事件，参数固定为'iccAccountInfoChange'。 |
| callback | Callback\<void\> | 否 | 回调函数。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300999 | Unknown error code. |
**示例：**
```js
let callback = data => {
console.log("on iccAccountInfoChange, data:" + JSON.stringify(data));
}
observer.on('iccAccountInfoChange', callback);
// 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
observer.off('iccAccountInfoChange', callback);
observer.off('iccAccountInfoChange');
```
## LockReason<sup>8+</sup>
......
zh-cn/application-dev/reference/apis/js-apis-sim.md
浏览文件 @ 67c2d36e
......@@ -685,9 +685,11 @@ promise.then(data => {
getSimAccountInfo\(slotId: number, callback: AsyncCallback\<IccAccountInfo\>\): void
获取SIM卡账户信息。使用callback异步回调。
获取SIM卡帐户信息。使用callback异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -706,8 +708,6 @@ getSimAccountInfo\(slotId: number, callback: AsyncCallback\<IccAccountInfo\>\):
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 201 | Permission denied. |
| 202 | Non-system applications use system APIs. |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
......@@ -729,9 +729,11 @@ sim.getSimAccountInfo(0, (err, data) => {
getSimAccountInfo\(slotId: number\): Promise\<IccAccountInfo\>
获取SIM卡账户信息。使用Promise异步回调。
获取SIM卡帐户信息。使用Promise异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -747,7 +749,7 @@ getSimAccountInfo\(slotId: number\): Promise\<IccAccountInfo\>
| 类型 | 说明 |
| -------------------------------------------- | ------------------------------------------ |
| Promise<[IccAccountInfo](#iccaccountinfo7)\> | 以Promise形式返回指定卡槽SIM卡的账户信息。 |
| Promise<[IccAccountInfo](#iccaccountinfo7)\> | 以Promise形式返回指定卡槽SIM卡的帐户信息。 |
**错误码：**
......@@ -755,8 +757,6 @@ getSimAccountInfo\(slotId: number\): Promise\<IccAccountInfo\>
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 201 | Permission denied. |
| 202 | Non-system applications use system APIs. |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
......@@ -780,9 +780,11 @@ promise.then(data => {
getActiveSimAccountInfoList\(callback: AsyncCallback\<Array\<IccAccountInfo\>\>\): void
获取活跃SIM卡账户信息列表。使用callback异步回调。
获取活跃SIM卡帐户信息列表。使用callback异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -800,8 +802,6 @@ getActiveSimAccountInfoList\(callback: AsyncCallback\<Array\<IccAccountInfo\>\>\
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 201 | Permission denied. |
| 202 | Non-system applications use system APIs. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
......@@ -821,9 +821,11 @@ sim.getActiveSimAccountInfoList((err, data) => {
getActiveSimAccountInfoList\(\): Promise\<Array\<IccAccountInfo\>\>;
获取活跃SIM卡账户信息列表。使用Promise异步回调。
获取活跃SIM卡帐户信息列表。使用Promise异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -833,7 +835,7 @@ getActiveSimAccountInfoList\(\): Promise\<Array\<IccAccountInfo\>\>;
| 类型 | 说明 |
| ---------------------------------------------------- | ---------------------------------------------- |
| Promise<Array<[IccAccountInfo](#iccaccountinfo7)\>\> | 以Promise形式返回活跃卡槽SIM卡的账户信息列表。 |
| Promise<Array<[IccAccountInfo](#iccaccountinfo7)\>\> | 以Promise形式返回活跃卡槽SIM卡的帐户信息列表。 |
**错误码：**
......@@ -841,8 +843,6 @@ getActiveSimAccountInfoList\(\): Promise\<Array\<IccAccountInfo\>\>;
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 201 | Permission denied. |
| 202 | Non-system applications use system APIs. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300004 | Do not have sim card. |
......@@ -3990,6 +3990,80 @@ try {
}
```
## sim.getDefaultVoiceSimId<sup>10+</sup>
getDefaultVoiceSimId\(callback: AsyncCallback\<number\>\): void
获取默认语音业务的SIM卡ID。使用callback异步回调。
**系统能力**：SystemCapability.Telephony.CoreService
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------- |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。<br/>与SIM卡绑定，从1开始递增。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300004 | Do not have sim card. |
| 8300999 | Unknown error code. |
| 8301001 | SIM card is not activated. |
**示例：**
```js
sim.getDefaultVoiceSimId((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.getDefaultVoiceSimId<sup>10+</sup>
getDefaultVoiceSimId\(\): Promise\<number\>
获取默认语音业务的SIM卡ID。使用Promise异步回调。
**系统能力**：SystemCapability.Telephony.CoreService
**返回值：**
| 类型 | 说明 |
| ----------------- | --------------------------------------- |
| Promise\<number\> | 以Promise形式返回默认语音业务的SIM卡ID。<br/>与SIM卡绑定，从1开始递增。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300004 | Do not have sim card. |
| 8300999 | Unknown error code. |
| 8301001 | SIM card is not activated. |
**示例：**
```js
let promise = sim.getDefaultVoiceSimId();
promise.then(data => {
console.log(`getDefaultVoiceSimId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getDefaultVoiceSimId failed, promise: err->${JSON.stringify(err)}`);
});
```
## SimState
SIM卡状态。
......@@ -4113,7 +4187,7 @@ SIM卡状态。
## IccAccountInfo<sup>7+</sup>
Icc账户信息。
Icc帐户信息。
**系统接口：** 此接口为系统接口。
......
zh-cn/application-dev/reference/apis/js-apis-sms.md
浏览文件 @ 67c2d36e
......@@ -1534,6 +1534,81 @@ promise.then(data => {
});
```
## sms.getDefaultSmsSimId<sup>10+</sup>
getDefaultSmsSimId\(callback: AsyncCallback&lt;number&gt;\): void
获取发送短信的默认SIM卡ID。使用callback异步回调。
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------------------------------------- |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。<br/>与SIM卡绑定，从1开始递增。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300004 | Do not have sim card. |
| 8300999 | Unknown error code. |
| 8301001 | SIM card is not activated. |
**示例：**
```js
sms.getDefaultSmsSimId((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sms.getDefaultSmsSimId<sup>10+</sup>
getDefaultSmsSimId\(\): Promise&lt;number&gt;
获取发送短信的默认SIM卡ID。使用Promise异步回调。
**系统能力**：SystemCapability.Telephony.SmsMms
**返回值：**
| 类型 | 说明 |
| --------------- | ------------------------------------------------------------ |
| Promise&lt;number&gt; | 以Promise形式返回发送短信的默认SIM卡ID：<br/>与SIM卡绑定，从1开始递增。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300004 | Do not have sim card. |
| 8300999 | Unknown error code. |
| 8301001 | SIM card is not activated. |
**示例：**
```js
let promise = sms.getDefaultSmsSimId();
promise.then(data => {
console.log(`getDefaultSmsSimId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`getDefaultSmsSimId failed, promise: err->${JSON.stringify(err)}`);
});
```
## ShortMessage
短信实例。
......
zh-cn/application-dev/reference/apis/js-apis-telephony-data.md
浏览文件 @ 67c2d36e
......@@ -768,6 +768,26 @@ promise.then(() => {
});
```
## data.getDefaultCellularDataSimId<sup>10+</sup>
getDefaultCellularDataSimId(): number
获取默认移动数据的SIM卡ID。
**系统能力**：SystemCapability.Telephony.CellularData
**返回值：**
| 类型 | 说明 |
| ------ | -------------------------------------------------- |
| number | 获取默认移动数据的SIM卡ID。<br/>与SIM卡绑定，从1开始递增。 |
**示例：**
```js
console.log("Result: "+ data.getDefaultCellularDataSimId())
```
## DataFlowType
描述蜂窝数据流类型。
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或