Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
67c2d36e
D
Docs
项目概览
OpenHarmony
/
Docs
11 个月 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
67c2d36e
编写于
6月 15, 2023
作者:
O
openharmony_ci
提交者:
Gitee
6月 15, 2023
浏览文件
操作
浏览文件
下载
差异文件
!19545 docs-卡账户接口问题资料整改
Merge pull request !19545 from Aurora/master
上级
2ac78acb
45576551
变更
4
隐藏空白更改
内联
并排
Showing
4 changed file
with
265 addition
and
19 deletion
+265
-19
zh-cn/application-dev/reference/apis/js-apis-observer.md
zh-cn/application-dev/reference/apis/js-apis-observer.md
+77
-0
zh-cn/application-dev/reference/apis/js-apis-sim.md
zh-cn/application-dev/reference/apis/js-apis-sim.md
+93
-19
zh-cn/application-dev/reference/apis/js-apis-sms.md
zh-cn/application-dev/reference/apis/js-apis-sms.md
+75
-0
zh-cn/application-dev/reference/apis/js-apis-telephony-data.md
.../application-dev/reference/apis/js-apis-telephony-data.md
+20
-0
未找到文件。
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
<
number
>
| 是 | 回调函数。
<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
<
number
>
\)
: void
获取发送短信的默认SIM卡ID。使用callback异步回调。
**系统能力**
:SystemCapability.Telephony.SmsMms
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------------------------------------- |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数。
<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
<
number
>
获取发送短信的默认SIM卡ID。使用Promise异步回调。
**系统能力**
:SystemCapability.Telephony.SmsMms
**返回值:**
| 类型 | 说明 |
| --------------- | ------------------------------------------------------------ |
| 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
=
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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录