Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 43889770 编写于 作者: L liuxiyao223
浏览文件
操作

卡账户接口问题资料整改 

Signed-off-by: Nliuxiyao223 <liuxiyao223@huawei.com>
上级 c76e0e4d
隐藏空白更改
内联 并排
Showing with 260 addition and 4 deletion
zh-cn/application-dev/reference/apis/js-apis-observer.md
浏览文件 @ 43889770
......@@ -849,6 +849,85 @@ 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 | 错误信息 |
| -------- | -------------------------------------------- |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300999 | Unknown error code. |
**示例：**
```js
observer.on('iccAccountInfoChange', data => {
console.log("on iccAccountInfoChange, data:" + JSON.stringify(data));
});
```
## 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 | 错误信息 |
| -------- | -------------------------------------------- |
| 401 | Parameter error. |
| 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
浏览文件 @ 43889770
......@@ -687,7 +687,9 @@ getSimAccountInfo\(slotId: number, callback: AsyncCallback\<IccAccountInfo\>\):
获取SIM卡账户信息。使用callback异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -731,7 +733,9 @@ getSimAccountInfo\(slotId: number\): Promise\<IccAccountInfo\>
获取SIM卡账户信息。使用Promise异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -782,7 +786,9 @@ getActiveSimAccountInfoList\(callback: AsyncCallback\<Array\<IccAccountInfo\>\>\
获取活跃SIM卡账户信息列表。使用callback异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -823,7 +829,9 @@ getActiveSimAccountInfoList\(\): Promise\<Array\<IccAccountInfo\>\>;
获取活跃SIM卡账户信息列表。使用Promise异步回调。
**系统接口：** 此接口为系统接口。
>**说明：**
>
>如果没有GET_TELEPHONY_STATE权限，获取到的ICCID和号码信息为空。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE
......@@ -3990,6 +3998,80 @@ try {
}
```
## sim.getDefaultVoiceSimId<sup>10+</sup>
getDefaultVoiceSimId\(callback: AsyncCallback\<number\>\): void
获取默认语音业务的SIM卡ID。使用callback异步回调。
**系统能力**：SystemCapability.Telephony.CoreService
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------- |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。<br/>- 1：SIM卡1<br/>- 2：SIM卡2 |
**错误码：**
以下错误码的详细介绍请参见[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/>- 1：SIM卡1<br/>- 2：SIM卡2 |
**错误码：**
以下错误码的详细介绍请参见[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卡状态。
......
zh-cn/application-dev/reference/apis/js-apis-sms.md
浏览文件 @ 43889770
......@@ -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/>- 1：SIM卡1<br/>- 2：SIM卡2 |
**错误码：**
以下错误码的详细介绍请参见[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/>- 1：SIM卡1<br/>- 2：SIM卡2 |
**错误码：**
以下错误码的详细介绍请参见[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
浏览文件 @ 43889770
......@@ -768,6 +768,26 @@ promise.then(() => {
});
```
## data.getDefaultCellularDataSimId<sup>10+</sup>
getDefaultCellularDataSimId(): number
获取默认移动数据的SIM卡ID
**系统能力**：SystemCapability.Telephony.CellularData
**返回值：**
| 类型 | 说明 |
| ------ | -------------------------------------------------- |
| number | 获取默认移动数据的SIM卡ID。<br />1：SIM卡1。<br />2：SIM卡2。 |
**示例：**
```js
console.log("Result: "+ data.getDefaultCellularDataSimId())
```
## DataFlowType
描述蜂窝数据流类型。
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或