Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
b5160e59
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
提交
b5160e59
编写于
3月 14, 2022
作者:
C
clevercong
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
format js api docs.
Signed-off-by:
N
clevercong
<
lichunlin2@huawei.com
>
上级
fe8373c5
变更
11
隐藏空白更改
内联
并排
Showing
11 changed file
with
681 addition
and
405 deletion
+681
-405
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+3
-0
zh-cn/application-dev/reference/apis/js-apis-call.md
zh-cn/application-dev/reference/apis/js-apis-call.md
+66
-60
zh-cn/application-dev/reference/apis/js-apis-http.md
zh-cn/application-dev/reference/apis/js-apis-http.md
+45
-27
zh-cn/application-dev/reference/apis/js-apis-net-connection.md
.../application-dev/reference/apis/js-apis-net-connection.md
+31
-13
zh-cn/application-dev/reference/apis/js-apis-observer.md
zh-cn/application-dev/reference/apis/js-apis-observer.md
+74
-70
zh-cn/application-dev/reference/apis/js-apis-radio.md
zh-cn/application-dev/reference/apis/js-apis-radio.md
+114
-100
zh-cn/application-dev/reference/apis/js-apis-sim.md
zh-cn/application-dev/reference/apis/js-apis-sim.md
+129
-51
zh-cn/application-dev/reference/apis/js-apis-sms.md
zh-cn/application-dev/reference/apis/js-apis-sms.md
+44
-40
zh-cn/application-dev/reference/apis/js-apis-socket.md
zh-cn/application-dev/reference/apis/js-apis-socket.md
+99
-12
zh-cn/application-dev/reference/apis/js-apis-telephony-data.md
.../application-dev/reference/apis/js-apis-telephony-data.md
+36
-32
zh-cn/application-dev/reference/apis/js-apis-webSocket.md
zh-cn/application-dev/reference/apis/js-apis-webSocket.md
+40
-0
未找到文件。
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
b5160e59
...
@@ -51,6 +51,9 @@
...
@@ -51,6 +51,9 @@
-
[
蜂窝数据
](
js-apis-telephony-data.md
)
-
[
蜂窝数据
](
js-apis-telephony-data.md
)
-
网络管理
-
网络管理
-
[
网络连接管理
](
js-apis-net-connection.md
)
-
[
网络连接管理
](
js-apis-net-connection.md
)
-
[
Socket连接
](
js-apis-socket.md
)
-
[
WebSocket连接
](
js-apis-webSocket.md
)
-
[
数据请求
](
js-apis-http.md
)
-
通信与连接
-
通信与连接
-
[
WLAN
](
js-apis-wifi.md
)
-
[
WLAN
](
js-apis-wifi.md
)
-
[
Bluetooth
](
js-apis-bluetooth.md
)
-
[
Bluetooth
](
js-apis-bluetooth.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-call.md
浏览文件 @
b5160e59
...
@@ -11,7 +11,7 @@
...
@@ -11,7 +11,7 @@
import call from '@ohos.telephony.call';
import call from '@ohos.telephony.call';
```
```
## call.dial
<a name=call.dial-callback1></a>
## call.dial
dial
\(
phoneNumber: string, callback: AsyncCallback<boolean
\>\)
: void
dial
\(
phoneNumber: string, callback: AsyncCallback<boolean
\>\)
: void
...
@@ -23,7 +23,7 @@ dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
...
@@ -23,7 +23,7 @@ dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | ------------------------------------------------- |
| ----------- | ---------------------------- | ---- | ------------------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数:
<br/>
- true:成功。
<br/>
- false:失败。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数:
<br/>
- true:成功。
<br/>
- false:失败。 |
...
@@ -37,7 +37,7 @@ call.dial("138xxxxxxxx", (err, data) => {
...
@@ -37,7 +37,7 @@ call.dial("138xxxxxxxx", (err, data) => {
```
```
## call.dial
<a name=call.dial-callback2></a>
## call.dial
dial
\(
phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean
\>\)
: void
dial
\(
phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean
\>\)
: void
...
@@ -49,10 +49,10 @@ dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean
...
@@ -49,10 +49,10 @@ dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | ------------------------------------------------- |
| ----------- | ---------------------------- | ---- | ------------------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| options | DialOptions | 是 | 通话参数,参考
[
DialOptions
](
#
DialO
ptions
)
。 |
| options | DialOptions | 是 | 通话参数,参考
[
DialOptions
](
#
dialo
ptions
)
。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数:
<br/>
- true:成功。
<br/>
- false:失败。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数:
<br/>
- true:成功。
<br/>
- false:失败。 |
**示例:**
**示例:**
...
@@ -66,7 +66,7 @@ call.dial("138xxxxxxxx", {
...
@@ -66,7 +66,7 @@ call.dial("138xxxxxxxx", {
```
```
## call.dial
<a name=call.dial-promise></a>
## call.dial
dial
\(
phoneNumber: string, options?: DialOptions
\)
: Promise<boolean
\>
dial
\(
phoneNumber: string, options?: DialOptions
\)
: Promise<boolean
\>
...
@@ -78,10 +78,10 @@ dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
...
@@ -78,10 +78,10 @@ dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ----------- | ---- | ------------------------------------------- |
| ----------- | ----------- | ---- | ------------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| options | DialOptions | 是 | 通话参数,参考
[
DialOptions
](
#
DialO
ptions
)
。 |
| options | DialOptions | 是 | 通话参数,参考
[
DialOptions
](
#
dialo
ptions
)
。 |
**返回值:**
**返回值:**
...
@@ -102,17 +102,19 @@ promise.then(data => {
...
@@ -102,17 +102,19 @@ promise.then(data => {
});
});
```
```
## call.makeCall<sup>7+</sup>
<a name=call.makeCall-callback></a>
## call.makeCall<sup>7+</sup>
makeCall(phoneNumber: string, callback: AsyncCallback
<void
>
): void
makeCall(phoneNumber: string, callback: AsyncCallback
\<
void
\
>
): void
跳转到拨号界面,并显示拨号的号码,使用callback方式作为异步方法。
跳转到拨号界面,并显示拨号的号码,使用callback方式作为异步方法。
**系统能力**
:SystemCapability.Telephony.CallManager
本接口在Openharmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Applications.Contacts
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ------------------------- | ---- | ------------------------------------------ |
| ----------- | ------------------------- | ---- | ------------------------------------------ |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| callback | AsyncCallback
<
void
>
| 是 | 以callback形式异步返回跳转拨号界面的结果。 |
| callback | AsyncCallback
<
void
>
| 是 | 以callback形式异步返回跳转拨号界面的结果。 |
...
@@ -126,17 +128,19 @@ call.makeCall("138xxxxxxxx", err => {
...
@@ -126,17 +128,19 @@ call.makeCall("138xxxxxxxx", err => {
```
```
## call.makeCall<sup>7+</sup>
<a name=call.makeCall-promise></a>
## call.makeCall<sup>7+</sup>
makeCall(phoneNumber: string): Promise
<void
>
makeCall(phoneNumber: string): Promise
\<
void
\
>
跳转到拨号界面,并显示拨号的号码,使用Promise方式作为异步方法。
跳转到拨号界面,并显示拨号的号码,使用Promise方式作为异步方法。
**系统能力**
:SystemCapability.Telephony.CallManager
本接口在Openharmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Applications.Contacts
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------- |
| ----------- | ------ | ---- | ---------- |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
...
@@ -157,7 +161,7 @@ promise.then(() => {
...
@@ -157,7 +161,7 @@ promise.then(() => {
});
});
```
```
## call.hasCall
<a name=call.hasCall-callback></a>
## call.hasCall
hasCall
\(
callback: AsyncCallback<boolean
\>\)
: void
hasCall
\(
callback: AsyncCallback<boolean
\>\)
: void
...
@@ -167,7 +171,7 @@ hasCall\(callback: AsyncCallback<boolean\>\): void
...
@@ -167,7 +171,7 @@ hasCall\(callback: AsyncCallback<boolean\>\): void
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数:
<br/>
- true:当前存在通话。
<br/>
- false:当前不存在通话。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数:
<br/>
- true:当前存在通话。
<br/>
- false:当前不存在通话。 |
...
@@ -180,7 +184,7 @@ call.hasCall((err, data) => {
...
@@ -180,7 +184,7 @@ call.hasCall((err, data) => {
```
```
## call.hasCall
<a name=call.hasCall-promise></a>
## call.hasCall
hasCall
\(\)
: Promise<boolean
\>
hasCall
\(\)
: Promise<boolean
\>
...
@@ -206,7 +210,7 @@ promise.then(data => {
...
@@ -206,7 +210,7 @@ promise.then(data => {
```
```
## call.getCallState
<a name=call.getCallState-callback></a>
## call.getCallState
getCallState
\(
callback: AsyncCallback<CallState
\>\)
: void
getCallState
\(
callback: AsyncCallback<CallState
\>\)
: void
...
@@ -216,9 +220,9 @@ getCallState\(callback: AsyncCallback<CallState\>\): void
...
@@ -216,9 +220,9 @@ getCallState\(callback: AsyncCallback<CallState\>\): void
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| -------- | -------------------------------------------- | ---- | ------------------------------------ |
| -------- | -------------------------------------------- | ---- | ------------------------------------ |
| callback | AsyncCallback
<
[CallState](#
CallS
tate)
>
| 是 | 回调函数:异步返回获取到的通话状态。 |
| callback | AsyncCallback
<
[CallState](#
calls
tate)
>
| 是 | 回调函数:异步返回获取到的通话状态。 |
**示例:**
**示例:**
...
@@ -229,7 +233,7 @@ call.getCallState((err, data) => {
...
@@ -229,7 +233,7 @@ call.getCallState((err, data) => {
```
```
## call.getCallState
<a name="call.getCallState-promise"></a>
## call.getCallState
getCallState
\(\)
: Promise<CallState
\>
getCallState
\(\)
: Promise<CallState
\>
...
@@ -241,7 +245,7 @@ getCallState\(\): Promise<CallState\>
...
@@ -241,7 +245,7 @@ getCallState\(\): Promise<CallState\>
| 类型 | 说明 |
| 类型 | 说明 |
| -------------------------------------- | ----------------------------------------- |
| -------------------------------------- | ----------------------------------------- |
| Promise
<
[CallState](#
CallS
tate)
>
| 以Promise形式异步返回获取通话状态的结果。 |
| Promise
<
[CallState](#
calls
tate)
>
| 以Promise形式异步返回获取通话状态的结果。 |
**示例:**
**示例:**
...
@@ -254,7 +258,7 @@ promise.then(data => {
...
@@ -254,7 +258,7 @@ promise.then(data => {
});
});
```
```
## call.hasVoiceCapability<sup>7+</sup>
<a name=call.hasVoiceCapability></a>
## call.hasVoiceCapability<sup>7+</sup>
hasVoiceCapability(): boolean
hasVoiceCapability(): boolean
...
@@ -273,7 +277,7 @@ let result = call.hasVoiceCapability();
...
@@ -273,7 +277,7 @@ let result = call.hasVoiceCapability();
console.log(`hasVoiceCapability: ${JSON.stringify(result)}`);
console.log(`hasVoiceCapability: ${JSON.stringify(result)}`);
```
```
## call.isEmergencyPhoneNumber<sup>7+</sup>
<a name=call.isEmergencyPhoneNumber-callback1></a>
## call.isEmergencyPhoneNumber<sup>7+</sup>
isEmergencyPhoneNumber
\(
phoneNumber: string, callback: AsyncCallback<boolean
\>\)
: void
isEmergencyPhoneNumber
\(
phoneNumber: string, callback: AsyncCallback<boolean
\>\)
: void
...
@@ -283,7 +287,7 @@ isEmergencyPhoneNumber\(phoneNumber: string, callback: AsyncCallback<boolean\>\)
...
@@ -283,7 +287,7 @@ isEmergencyPhoneNumber\(phoneNumber: string, callback: AsyncCallback<boolean\>\)
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| ----------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回判断是否是紧急电话号码的结果:
<br/>
- true:是紧急电话号码。
<br/>
- false:不是紧急电话号码。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回判断是否是紧急电话号码的结果:
<br/>
- true:是紧急电话号码。
<br/>
- false:不是紧急电话号码。 |
...
@@ -297,7 +301,7 @@ call.isEmergencyPhoneNumber("138xxxxxxxx", (err, data) => {
...
@@ -297,7 +301,7 @@ call.isEmergencyPhoneNumber("138xxxxxxxx", (err, data) => {
```
```
## call.isEmergencyPhoneNumber<sup>7+</sup>
<a name=call.isEmergencyPhoneNumber-callback2></a>
## call.isEmergencyPhoneNumber<sup>7+</sup>
isEmergencyPhoneNumber
\(
phoneNumber: string, options: EmergencyNumberOptions, callback: AsyncCallback<boolean
\>\)
: void
isEmergencyPhoneNumber
\(
phoneNumber: string, options: EmergencyNumberOptions, callback: AsyncCallback<boolean
\>\)
: void
...
@@ -307,10 +311,10 @@ isEmergencyPhoneNumber\(phoneNumber: string, options: EmergencyNumberOptions, ca
...
@@ -307,10 +311,10 @@ isEmergencyPhoneNumber\(phoneNumber: string, options: EmergencyNumberOptions, ca
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| ----------- | ---------------------------- | ---- | ------------------------------------------------------------ |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| options | EmergencyNumberOptions | 是 | 手机参数,参考
[
EmergencyNumberOptions
](
#
EmergencyNumberOptions
)
。 |
| options | EmergencyNumberOptions | 是 | 手机参数,参考
[
EmergencyNumberOptions
](
#
emergencynumberoptions7
)
。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回判断是否是紧急电话号码的结果:
<br/>
- true:是紧急电话号码。
<br/>
- false:不是紧急电话号码。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回判断是否是紧急电话号码的结果:
<br/>
- true:是紧急电话号码。
<br/>
- false:不是紧急电话号码。 |
**示例:**
**示例:**
...
@@ -322,7 +326,7 @@ call.isEmergencyPhoneNumber("112", {slotId: 1}, (err, value) => {
...
@@ -322,7 +326,7 @@ call.isEmergencyPhoneNumber("112", {slotId: 1}, (err, value) => {
```
```
## call.isEmergencyPhoneNumber<sup>7+</sup>
<a name=call.isEmergencyPhoneNumber-promise></a>
## call.isEmergencyPhoneNumber<sup>7+</sup>
isEmergencyPhoneNumber
\(
phoneNumber: string, options?: EmergencyNumberOptions
\)
: Promise<boolean
\>
isEmergencyPhoneNumber
\(
phoneNumber: string, options?: EmergencyNumberOptions
\)
: Promise<boolean
\>
...
@@ -332,10 +336,10 @@ isEmergencyPhoneNumber\(phoneNumber: string, options?: EmergencyNumberOptions\):
...
@@ -332,10 +336,10 @@ isEmergencyPhoneNumber\(phoneNumber: string, options?: EmergencyNumberOptions\):
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ---------------------- | ---- | ------------------------------------------------------------ |
| ----------- | ---------------------- | ---- | ------------------------------------------------------------ |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| options | EmergencyNumberOptions | 是 | 手机参数,参考
[
EmergencyNumberOptions
](
#
EmergencyNumberOptions
)
。 |
| options | EmergencyNumberOptions | 是 | 手机参数,参考
[
EmergencyNumberOptions
](
#
emergencynumberoptions7
)
。 |
**返回值:**
**返回值:**
...
@@ -354,7 +358,7 @@ promise.then(data => {
...
@@ -354,7 +358,7 @@ promise.then(data => {
});
});
```
```
## call.formatPhoneNumber<sup>7+</sup>
<a name=call.formatPhoneNumber-callback1></a>
## call.formatPhoneNumber<sup>7+</sup>
formatPhoneNumber
\(
phoneNumber: string, callback: AsyncCallback<string
\>\)
: void
formatPhoneNumber
\(
phoneNumber: string, callback: AsyncCallback<string
\>\)
: void
...
@@ -364,7 +368,7 @@ formatPhoneNumber\(phoneNumber: string, callback: AsyncCallback<string\>\): void
...
@@ -364,7 +368,7 @@ formatPhoneNumber\(phoneNumber: string, callback: AsyncCallback<string\>\): void
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | --------------------------- | ---- | ------------------------------------ |
| ----------- | --------------------------- | ---- | ------------------------------------ |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回格式化电话号码的结果。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回格式化电话号码的结果。 |
...
@@ -378,7 +382,7 @@ call.formatPhoneNumber("138xxxxxxxx", (err, data) => {
...
@@ -378,7 +382,7 @@ call.formatPhoneNumber("138xxxxxxxx", (err, data) => {
```
```
## call.formatPhoneNumber<sup>7+</sup>
<a name=call.formatPhoneNumber-callback2></a>
## call.formatPhoneNumber<sup>7+</sup>
formatPhoneNumber
\(
phoneNumber: string, options: NumberFormatOptions, callback: AsyncCallback<string
\>\)
: void
formatPhoneNumber
\(
phoneNumber: string, options: NumberFormatOptions, callback: AsyncCallback<string
\>\)
: void
...
@@ -388,10 +392,10 @@ formatPhoneNumber\(phoneNumber: string, options: NumberFormatOptions, callback:
...
@@ -388,10 +392,10 @@ formatPhoneNumber\(phoneNumber: string, options: NumberFormatOptions, callback:
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | --------------------------- | ---- | ------------------------------------------------------------ |
| ----------- | --------------------------- | ---- | ------------------------------------------------------------ |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| options | NumberFormatOptions | 是 | 格式化参数,参考
[
NumberFormatOptions
](
#
NumberFormatOptions
)
。 |
| options | NumberFormatOptions | 是 | 格式化参数,参考
[
NumberFormatOptions
](
#
numberformatoptions7
)
。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回格式化电话号码的结果。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回格式化电话号码的结果。 |
**示例:**
**示例:**
...
@@ -405,7 +409,7 @@ call.formatPhoneNumber("138xxxxxxxx",{
...
@@ -405,7 +409,7 @@ call.formatPhoneNumber("138xxxxxxxx",{
```
```
## call.formatPhoneNumber<sup>7+</sup>
<a name=call.formatPhoneNumber-promise></a>
## call.formatPhoneNumber<sup>7+</sup>
formatPhoneNumber
\(
phoneNumber: string, options?: NumberFormatOptions
\)
: Promise<string
\>
formatPhoneNumber
\(
phoneNumber: string, options?: NumberFormatOptions
\)
: Promise<string
\>
...
@@ -415,10 +419,10 @@ formatPhoneNumber\(phoneNumber: string, options?: NumberFormatOptions\): Promise
...
@@ -415,10 +419,10 @@ formatPhoneNumber\(phoneNumber: string, options?: NumberFormatOptions\): Promise
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ------------------- | ---- | ------------------------------------------------------------ |
| ----------- | ------------------- | ---- | ------------------------------------------------------------ |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| options | NumberFormatOptions | 是 | 格式化参数,参考
[
NumberFormatOptions
](
#
NumberFormatOptions
)
。 |
| options | NumberFormatOptions | 是 | 格式化参数,参考
[
NumberFormatOptions
](
#
numberformatoptions7
)
。 |
**返回值:**
**返回值:**
...
@@ -439,7 +443,7 @@ promise.then(data => {
...
@@ -439,7 +443,7 @@ promise.then(data => {
});
});
```
```
## call.formatPhoneNumberToE164<sup>7+</sup>
<a name=call.formatPhoneNumberToE164-callback></a>
## call.formatPhoneNumberToE164<sup>7+</sup>
formatPhoneNumberToE164
\(
phoneNumber: string, countryCode: string, callback: AsyncCallback<string
\>\)
: void
formatPhoneNumberToE164
\(
phoneNumber: string, countryCode: string, callback: AsyncCallback<string
\>\)
: void
...
@@ -453,7 +457,7 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string, callback: Asy
...
@@ -453,7 +457,7 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string, callback: Asy
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | --------------------------- | ---- | ----------------------------------------------------- |
| ----------- | --------------------------- | ---- | ----------------------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| countryCode | string | 是 | 国家码,支持所有国家码,如:中国(CN)。 |
| countryCode | string | 是 | 国家码,支持所有国家码,如:中国(CN)。 |
...
@@ -470,7 +474,7 @@ call.formatPhoneNumberToE164("138xxxxxxxx",{
...
@@ -470,7 +474,7 @@ call.formatPhoneNumberToE164("138xxxxxxxx",{
```
```
## call.formatPhoneNumberToE164<sup>7+</sup>
<a name=call.formatPhoneNumberToE164-promise></a>
## call.formatPhoneNumberToE164<sup>7+</sup>
formatPhoneNumberToE164
\(
phoneNumber: string, countryCode: string
\)
: Promise<string
\>
formatPhoneNumberToE164
\(
phoneNumber: string, countryCode: string
\)
: Promise<string
\>
...
@@ -484,7 +488,7 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise<str
...
@@ -484,7 +488,7 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise<str
**参数:**
**参数:**
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------------------- |
| ----------- | ------ | ---- | ---------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| phoneNumber | string | 是 | 电话号码。 |
| countryCode | string | 是 | 国家码,支持所有国家码,如:中国(CN)。 |
| countryCode | string | 是 | 国家码,支持所有国家码,如:中国(CN)。 |
...
@@ -508,43 +512,45 @@ promise.then(data => {
...
@@ -508,43 +512,45 @@ promise.then(data => {
});
});
```
```
## DialOptions
<a name=DialOptions></a>
## DialOptions
拨打电话的可选参数。
拨打电话的可选参数。
**系统能力**
:
SystemCapability.Telephony.CallManager
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ------ | ------- | ---- | ------------------------------------------------------------ |
| ------ | ------- | ---- | ------------------------------------------------------------ |
| extras | boolean | 否 | 根据extras的值判断是否为视频通话,默认为语音通话。
<br/>
- true:视频通话。
<br/>
- fasle:语音通话。 |
| extras | boolean | 否 | 根据extras的值判断是否为视频通话,默认为语音通话。
<br/>
- true:视频通话。
<br/>
- fasle:语音通话。 |
## CallState
<a name=CallState></a>
## CallState
通话状态码。
通话状态码。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。
| 名称 | 值 | 说明 |
| ------------------ | ---- | ------------------------------------------------------------ |
| ------------------ | ---- | ------------------------------------------------------------ |
| CALL_STATE_UNKNOWN | -1 | 无效状态,当获取呼叫状态失败时返回。
<br
/>
**系统能力**
:SystemCapability.Telephony.CallManager
|
| CALL_STATE_UNKNOWN | -1 | 无效状态,当获取呼叫状态失败时返回。
|
| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。
<br
/>
**系统能力**
:SystemCapability.Telephony.CallManager
|
| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。
|
| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。
<br
/>
**系统能力**
:SystemCapability.Telephony.CallManager
|
| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。
|
| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态,并且没有新的来电振铃或等待。
<br
/>
**系统能力**
:SystemCapability.Telephony.CallManager
|
| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态,并且没有新的来电振铃或等待。 |
## EmergencyNumberOptions<sup>7+</sup>
<a name=EmergencyNumberOptions></a>
## EmergencyNumberOptions<sup>7+</sup>
判断是否是紧急电话号码的可选参数。
判断是否是紧急电话号码的可选参数。
**系统能力**
:
SystemCapability.Telephony.CallManager
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------ |
| ------ | ------ | ---- | ------------------------------------------ |
| slotId | number | 否 | 卡槽ID:
<br/>
- 0:卡槽1。
<br/>
- 1:卡槽2。 |
| slotId | number | 否 | 卡槽ID:
<br/>
- 0:卡槽1。
<br/>
- 1:卡槽2。 |
## NumberFormatOptions<sup>7+</sup>
<a name=NumberFormatOptions></a>
## NumberFormatOptions<sup>7+</sup>
格式化号码的可选参数。
格式化号码的可选参数。
**系统能力**
:
SystemCapability.Telephony.CallManager
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.CallManager。
| 参数
| 类型 | 必填 | 说明 |
| 参数
名
| 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------------------------------------- |
| ----------- | ------ | ---- | ---------------------------------------------------------- |
| countryCode | string | 否 | 国家码,支持所有国家的国家码,如:中国(CN)。默认为:CN。 |
| countryCode | string | 否 | 国家码,支持所有国家的国家码,如:中国(CN)。默认为:CN。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-http.md
浏览文件 @
b5160e59
...
@@ -4,7 +4,6 @@
...
@@ -4,7 +4,6 @@
>
>
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
>
>本模块所有接口需要设备具有系统能力:SystemCapability.Communication.NetStack
## 导入模块
## 导入模块
...
@@ -63,6 +62,8 @@ createHttp\(\): HttpRequest
...
@@ -63,6 +62,8 @@ createHttp\(\): HttpRequest
创建一个http,里面包括发起请求、中断请求、订阅/取消订阅HTTP Response Header 事件。每一个HttpRequest对象对应一个Http请求。如需发起多个Http请求,须为每个Http请求创建对应HttpRequest对象。
创建一个http,里面包括发起请求、中断请求、订阅/取消订阅HTTP Response Header 事件。每一个HttpRequest对象对应一个Http请求。如需发起多个Http请求,须为每个Http请求创建对应HttpRequest对象。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -89,6 +90,8 @@ request\(url: string, callback: AsyncCallback\<HttpResponse\>\):void
...
@@ -89,6 +90,8 @@ request\(url: string, callback: AsyncCallback\<HttpResponse\>\):void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -99,7 +102,6 @@ request\(url: string, callback: AsyncCallback\<HttpResponse\>\):void
...
@@ -99,7 +102,6 @@ request\(url: string, callback: AsyncCallback\<HttpResponse\>\):void
**示例:**
**示例:**
```
```
let httpRequest = http.createHttp();
httpRequest.request("EXAMPLE_URL", (err, data) => {
httpRequest.request("EXAMPLE_URL", (err, data) => {
if (!err) {
if (!err) {
console.info('Result:' + data.result);
console.info('Result:' + data.result);
...
@@ -120,6 +122,8 @@ request\(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpR
...
@@ -120,6 +122,8 @@ request\(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpR
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -131,7 +135,6 @@ request\(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpR
...
@@ -131,7 +135,6 @@ request\(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpR
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
httpRequest.request("EXAMPLE_URL",
httpRequest.request("EXAMPLE_URL",
{
{
method: 'GET',
method: 'GET',
...
@@ -165,6 +168,8 @@ request\(url: string, options? : HttpRequestOptions\): Promise<HttpResponse\>
...
@@ -165,6 +168,8 @@ request\(url: string, options? : HttpRequestOptions\): Promise<HttpResponse\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -182,7 +187,6 @@ request\(url: string, options? : HttpRequestOptions\): Promise<HttpResponse\>
...
@@ -182,7 +187,6 @@ request\(url: string, options? : HttpRequestOptions\): Promise<HttpResponse\>
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
let promise = httpRequest.request("EXAMPLE_URL", {
let promise = httpRequest.request("EXAMPLE_URL", {
method: "GET",
method: "GET",
connectTimeout: 60000,
connectTimeout: 60000,
...
@@ -211,22 +215,25 @@ destroy\(\): void
...
@@ -211,22 +215,25 @@ destroy\(\): void
中断请求任务。
中断请求任务。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
httpRequest.destroy();
httpRequest.destroy();
```
```
### on\('headerReceive'\)
### on\('headerReceive'\)
on
\(
type: 'headerReceive', callback: AsyncCallback<Object
\>\)
:void
on
\(
type: 'headerReceive', callback: AsyncCallback<Object
\>\)
:
void
订阅HTTP Response Header 事件。
订阅HTTP Response Header 事件。
> **说明:**
> **说明:**
> 此接口已废弃,建议使用[on\('headersReceive'\)<sup>8+</sup>](#onheadersreceive8)替代。
> 此接口已废弃,建议使用[on\('headersReceive'\)<sup>8+</sup>](#onheadersreceive8)替代。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -237,7 +244,6 @@ on\(type: 'headerReceive', callback: AsyncCallback<Object\>\):void
...
@@ -237,7 +244,6 @@ on\(type: 'headerReceive', callback: AsyncCallback<Object\>\):void
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
httpRequest.on('headerReceive', (err, data) => {
httpRequest.on('headerReceive', (err, data) => {
if (!err) {
if (!err) {
console.info('header: ' + data.header);
console.info('header: ' + data.header);
...
@@ -250,7 +256,7 @@ httpRequest.on('headerReceive', (err, data) => {
...
@@ -250,7 +256,7 @@ httpRequest.on('headerReceive', (err, data) => {
### off\('headerReceive'\)
### off\('headerReceive'\)
off
\(
type: 'headerReceive', callback?: AsyncCallback<Object
\>\)
:void
off
\(
type: 'headerReceive', callback?: AsyncCallback<Object
\>\)
:
void
取消订阅HTTP Response Header 事件。
取消订阅HTTP Response Header 事件。
...
@@ -260,6 +266,8 @@ off\(type: 'headerReceive', callback?: AsyncCallback<Object\>\):void
...
@@ -260,6 +266,8 @@ off\(type: 'headerReceive', callback?: AsyncCallback<Object\>\):void
>
>
>2. 可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>2. 可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -270,7 +278,6 @@ off\(type: 'headerReceive', callback?: AsyncCallback<Object\>\):void
...
@@ -270,7 +278,6 @@ off\(type: 'headerReceive', callback?: AsyncCallback<Object\>\):void
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
httpRequest.on('headerReceive', (err, data) => {
httpRequest.on('headerReceive', (err, data) => {
if (!err) {
if (!err) {
console.info('header: ' + data.header);
console.info('header: ' + data.header);
...
@@ -283,10 +290,12 @@ httpRequest.off('headerReceive');
...
@@ -283,10 +290,12 @@ httpRequest.off('headerReceive');
### on\('headersReceive'\)<sup>8+</sup>
### on\('headersReceive'\)<sup>8+</sup>
on
\(
type: 'headersReceive', callback: Callback<Object
\>\)
:void
on
\(
type: 'headersReceive', callback: Callback<Object
\>\)
:
void
订阅HTTP Response Header 事件。
订阅HTTP Response Header 事件。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -297,7 +306,6 @@ on\(type: 'headersReceive', callback: Callback<Object\>\):void
...
@@ -297,7 +306,6 @@ on\(type: 'headersReceive', callback: Callback<Object\>\):void
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
httpRequest.on('headersReceive', (data) => {
httpRequest.on('headersReceive', (data) => {
console.info('header: ' + data.header);
console.info('header: ' + data.header);
});
});
...
@@ -306,13 +314,15 @@ httpRequest.on('headersReceive', (data) => {
...
@@ -306,13 +314,15 @@ httpRequest.on('headersReceive', (data) => {
### off\('headersReceive'\)<sup>8+</sup>
### off\('headersReceive'\)<sup>8+</sup>
off
\(
type: 'headersReceive', callback?: Callback<Object
\>\)
:void
off
\(
type: 'headersReceive', callback?: Callback<Object
\>\)
:
void
取消订阅HTTP Response Header 事件。
取消订阅HTTP Response Header 事件。
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -323,16 +333,17 @@ off\(type: 'headersReceive', callback?: Callback<Object\>\):void
...
@@ -323,16 +333,17 @@ off\(type: 'headersReceive', callback?: Callback<Object\>\):void
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
httpRequest.off('headersReceive');
httpRequest.off('headersReceive');
```
```
### once\('headersReceive'\)<sup>8+</sup>
### once\('headersReceive'\)<sup>8+</sup>
once
\(
type:
"headersReceive"
, callback: Callback<Object
\>\)
: void
once
\(
type:
'headersReceive'
, callback: Callback<Object
\>\)
: void
订阅HTTP Response Header 事件,但是只触发一次。一旦触发之后,订阅器就会被移除。使用callback方式作为异步方法。
订阅HTTP Response Header 事件,但是只触发一次。一旦触发之后,订阅器就会被移除。使用callback方式作为异步方法。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -343,7 +354,6 @@ once\(type: "headersReceive", callback: Callback<Object\>\): void
...
@@ -343,7 +354,6 @@ once\(type: "headersReceive", callback: Callback<Object\>\): void
**示例:**
**示例:**
```
```
let httpRequest= http.createHttp();
httpRequest.once('headersReceive', (data) => {
httpRequest.once('headersReceive', (data) => {
console.info('header: ' + data.header);
console.info('header: ' + data.header);
});
});
...
@@ -353,7 +363,9 @@ httpRequest.once('headersReceive', (data) => {
...
@@ -353,7 +363,9 @@ httpRequest.once('headersReceive', (data) => {
发起请求可选参数的类型和取值范围。
发起请求可选参数的类型和取值范围。
| 参数 | 类型 | 必填 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------------------------------------ | ---- | ---------------------------------------------------------- |
| -------------- | ------------------------------------ | ---- | ---------------------------------------------------------- |
| method |
[
RequestMethod
](
#requestmethod
)
| 否 | 请求方式。 |
| method |
[
RequestMethod
](
#requestmethod
)
| 否 | 请求方式。 |
| extraData | string
\|
Object
\|
ArrayBuffer
<sup>
8+
</sup>
| 否 | 发送请求的额外数据。
<br
/>
- 当HTTP请求为POST、PUT等方法时,此字段为HTTP请求的content。
<br
/>
- 当HTTP请求为GET、OPTIONS、DELETE、TRACE、CONNECT等方法时,此字段为HTTP请求的参数补充,参数内容会拼接到URL中进行发送。
<sup>
8+
</sup><br
/>
- 开发者传入string对象,开发者需要自行编码,将编码后的string传入。
<sup>
8+
</sup>
|
| extraData | string
\|
Object
\|
ArrayBuffer
<sup>
8+
</sup>
| 否 | 发送请求的额外数据。
<br
/>
- 当HTTP请求为POST、PUT等方法时,此字段为HTTP请求的content。
<br
/>
- 当HTTP请求为GET、OPTIONS、DELETE、TRACE、CONNECT等方法时,此字段为HTTP请求的参数补充,参数内容会拼接到URL中进行发送。
<sup>
8+
</sup><br
/>
- 开发者传入string对象,开发者需要自行编码,将编码后的string传入。
<sup>
8+
</sup>
|
...
@@ -365,22 +377,26 @@ httpRequest.once('headersReceive', (data) => {
...
@@ -365,22 +377,26 @@ httpRequest.once('headersReceive', (data) => {
HTTP 请求方法。
HTTP 请求方法。
|
**method 的合法值**
| 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| :------------------ | :------------------ |
| OPTIONS | HTTP 请求 OPTIONS。 |
| 名称 | 值 | 说明 |
| GET | HTTP 请求 GET。 |
| :------ | ------- | :------------------ |
| HEAD | HTTP 请求 HEAD。 |
| OPTIONS | OPTIONS | HTTP 请求 OPTIONS。 |
| POST | HTTP 请求 POST。 |
| GET | GET | HTTP 请求 GET。 |
| PUT | HTTP 请求 PUT。 |
| HEAD | HEAD | HTTP 请求 HEAD。 |
| DELETE | HTTP 请求 DELETE。 |
| POST | POST | HTTP 请求 POST。 |
| TRACE | HTTP 请求 TRACE。 |
| PUT | PUT | HTTP 请求 PUT。 |
| CONNECT | HTTP 请求 CONNECT。 |
| DELETE | DELETE | HTTP 请求 DELETE。 |
| TRACE | TRACE | HTTP 请求 TRACE。 |
| CONNECT | CONNECT | HTTP 请求 CONNECT。 |
## ResponseCode
## ResponseCode
发起请求返回的响应码。
发起请求返回的响应码。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 名称 | 值 | 说明 |
| ----------------- | ---- | ------------------------------------------------------------ |
| ----------------- | ---- | ------------------------------------------------------------ |
| OK | 200 | 请求成功。一般用于GET与POST请求。 |
| OK | 200 | 请求成功。一般用于GET与POST请求。 |
| CREATED | 201 | 已创建。成功请求并创建了新的资源。 |
| CREATED | 201 | 已创建。成功请求并创建了新的资源。 |
...
@@ -422,6 +438,8 @@ HTTP 请求方法。
...
@@ -422,6 +438,8 @@ HTTP 请求方法。
request方法回调函数的返回值类型。
request方法回调函数的返回值类型。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------------------- | -------------------------------------------- | ---- | ------------------------------------------------------------ |
| -------------------- | -------------------------------------------- | ---- | ------------------------------------------------------------ |
| result | string
\|
Object
\|
ArrayBuffer
<sup>
8+
</sup>
| 是 | Http请求根据响应头中Content-type类型返回对应的响应格式内容:
<br
/>
- application/json:返回JSON格式的字符串,如需Http响应具体内容,需开发者自行解析
<br
/>
- application/octet-stream:ArrayBuffer
<br
/>
- 其他:string |
| result | string
\|
Object
\|
ArrayBuffer
<sup>
8+
</sup>
| 是 | Http请求根据响应头中Content-type类型返回对应的响应格式内容:
<br
/>
- application/json:返回JSON格式的字符串,如需Http响应具体内容,需开发者自行解析
<br
/>
- application/octet-stream:ArrayBuffer
<br
/>
- 其他:string |
...
...
zh-cn/application-dev/reference/apis/js-apis-net-connection.md
浏览文件 @
b5160e59
...
@@ -676,11 +676,13 @@ netConnection.unregister(function (error) {
...
@@ -676,11 +676,13 @@ netConnection.unregister(function (error) {
在调用NetHandle的方法之前,需要先获取NetHandle对象。
在调用NetHandle的方法之前,需要先获取NetHandle对象。
**系统能力**
:SystemCapability.Communication.NetManager.Core
### 属性
### 属性
|
变量
| 类型 | 说明 |
|
参数名
| 类型 | 说明 |
| ----- | ------ | ------------------------- |
| -----
-
| ------ | ------------------------- |
| netId | number | 网络ID,必须大于等于100。 |
| netId
| number | 网络ID,必须大于等于100。 |
### bindSocket
### bindSocket
...
@@ -782,7 +784,7 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -782,7 +784,7 @@ connection.getDefaultNet().then(function (netHandle) {
### getAddressesByName
### getAddressesByName
getAddressesByName(
netHandle: NetHandle
): Promise
\<
Array
\<
NetAddress>>
getAddressesByName(
host: string
): Promise
\<
Array
\<
NetAddress>>
使用对应网络解析主机名以获取所有IP地址,使用Promise方式作为异步方法。
使用对应网络解析主机名以获取所有IP地址,使用Promise方式作为异步方法。
...
@@ -840,7 +842,7 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -840,7 +842,7 @@ connection.getDefaultNet().then(function (netHandle) {
### getAddressByName
### getAddressByName
getAddressByName(
netHandle: NetHandle
): Promise
\<
NetAddress>
getAddressByName(
host: string
): Promise
\<
NetAddress>
使用对应网络解析主机名以获取第一个IP地址,使用Promise方式作为异步方法。
使用对应网络解析主机名以获取第一个IP地址,使用Promise方式作为异步方法。
...
@@ -873,7 +875,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -873,7 +875,9 @@ connection.getDefaultNet().then(function (netHandle) {
提供承载数据网络能力的实例。
提供承载数据网络能力的实例。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 参数名 | 类型 | 说明 |
| ----------------------- | ----------------------------------- | ------------------------------------------------------------ |
| ----------------------- | ----------------------------------- | ------------------------------------------------------------ |
| netCapabilities |
[
NetCapabilities
](
#netcapabilities
)
| 存储数据网络的传输能力和承载类型。 |
| netCapabilities |
[
NetCapabilities
](
#netcapabilities
)
| 存储数据网络的传输能力和承载类型。 |
| bearerPrivateIdentifier | string | 网络标识符,WIFI网络的标识符是"wifi",蜂窝网络的标识符是"slot0"(对应SIM卡1)。 |
| bearerPrivateIdentifier | string | 网络标识符,WIFI网络的标识符是"wifi",蜂窝网络的标识符是"slot0"(对应SIM卡1)。 |
...
@@ -882,7 +886,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -882,7 +886,9 @@ connection.getDefaultNet().then(function (netHandle) {
网络的能力集。
网络的能力集。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 参数名 | 类型 | 说明 |
| --------------------- | ---------------------------------- | ------------------------ |
| --------------------- | ---------------------------------- | ------------------------ |
| linkUpBandwidthKbps | number | 上行(设备到网络)带宽。 |
| linkUpBandwidthKbps | number | 上行(设备到网络)带宽。 |
| linkDownBandwidthKbps | number | 下行(网络到设备)带宽。 |
| linkDownBandwidthKbps | number | 下行(网络到设备)带宽。 |
...
@@ -893,7 +899,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -893,7 +899,9 @@ connection.getDefaultNet().then(function (netHandle) {
网络具体能力。
网络具体能力。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 参数名 | 值 | 说明 |
| ------------------------ | ---- | ---------------------- |
| ------------------------ | ---- | ---------------------- |
| NET_CAPABILITY_MMS | 0 | 表示网络可以访问运营商的MMSC(Multimedia
Message
Service,多媒体短信服务)发送和接收彩信。 |
| NET_CAPABILITY_MMS | 0 | 表示网络可以访问运营商的MMSC(Multimedia
Message
Service,多媒体短信服务)发送和接收彩信。 |
| NET_CAPABILITY_NOT_METERED | 11 | 表示网络流量未被计费。 |
| NET_CAPABILITY_NOT_METERED | 11 | 表示网络流量未被计费。 |
...
@@ -905,7 +913,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -905,7 +913,9 @@ connection.getDefaultNet().then(function (netHandle) {
网络类型。
网络类型。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 名称 | 值 | 说明 |
| --------------- | ---- | ----------- |
| --------------- | ---- | ----------- |
| BEARER_CELLULAR | 0 | 蜂窝网络。 |
| BEARER_CELLULAR | 0 | 蜂窝网络。 |
| BEARER_WIFI | 1 | Wi-Fi网络。 |
| BEARER_WIFI | 1 | Wi-Fi网络。 |
...
@@ -915,7 +925,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -915,7 +925,9 @@ connection.getDefaultNet().then(function (netHandle) {
网络连接信息。
网络连接信息。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 参数名 | 类型 | 说明 |
| ------------- | ---------------------------------- | ---------------- |
| ------------- | ---------------------------------- | ---------------- |
| interfaceName | string | 网卡名称。 |
| interfaceName | string | 网卡名称。 |
| domains | string | 所属域,默认""。 |
| domains | string | 所属域,默认""。 |
...
@@ -928,7 +940,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -928,7 +940,9 @@ connection.getDefaultNet().then(function (netHandle) {
网络链路信息。
网络链路信息。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 参数名 | 类型 | 说明 |
| ------------ | ------------------------- | -------------------- |
| ------------ | ------------------------- | -------------------- |
| address |
[
NetAddress
](
#netaddress
)
| 链路地址。 |
| address |
[
NetAddress
](
#netaddress
)
| 链路地址。 |
| prefixLength | number | 链路地址前缀的长度。 |
| prefixLength | number | 链路地址前缀的长度。 |
...
@@ -937,7 +951,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -937,7 +951,9 @@ connection.getDefaultNet().then(function (netHandle) {
网络路由信息。
网络路由信息。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 参数名 | 类型 | 说明 |
| -------------- | --------------------------- | ---------------- |
| -------------- | --------------------------- | ---------------- |
| interface | string | 网卡名称。 |
| interface | string | 网卡名称。 |
| destination |
[
LinkAddress
](
#linkaddress
)
| 目的地址。 |
| destination |
[
LinkAddress
](
#linkaddress
)
| 目的地址。 |
...
@@ -949,7 +965,9 @@ connection.getDefaultNet().then(function (netHandle) {
...
@@ -949,7 +965,9 @@ connection.getDefaultNet().then(function (netHandle) {
网络地址。
网络地址。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetManager.Core。
| 参数名 | 类型 | 说明 |
| ------- | ------ | ------------------------------ |
| ------- | ------ | ------------------------------ |
| address | string | 地址。 |
| address | string | 地址。 |
| family | number | IPv4 = 1,IPv6 = 2,默认IPv4。 |
| family | number | IPv4 = 1,IPv6 = 2,默认IPv4。 |
...
...
zh-cn/application-dev/reference/apis/js-apis-observer.md
浏览文件 @
b5160e59
...
@@ -11,22 +11,22 @@
...
@@ -11,22 +11,22 @@
import observer from '@ohos.telephony.observer'
import observer from '@ohos.telephony.observer'
```
```
## observer.on('networkStateChange')
<a name=observer.on.networkStateChange-callback></a>
## observer.on('networkStateChange')
on
\(
type:
\'
networkStateChange
\'
, callback: Callback<NetworkState
\>\)
: void;
on
\(
type:
\'
networkStateChange
\'
, callback: Callback<NetworkState
\>\)
: void;
订阅网络状态变化事件,使用callback方式作为异步方法。
订阅网络状态变化事件,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.StateRegistry
**系统能力**
:SystemCapability.Telephony.StateRegistry
**参数:**
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -----------------------------------------
| ---- |
--------------------------------- |
| -------- | -----------------------------------------
---------------- | ---- | ---------------------------
--------------------------------- |
| type | string
| 是 | 网络状态变化事件
|
| type | string
| 是 | 网络状态变化事件
|
| callback | Callback
\<
[
NetworkState
](
js-apis-radio.md#
NetworkState
)
\>
| 是 | 回调函数。参考radio的
[
NetworkState
](
js-apis-radio.md#NetworkS
tate
)
|
| callback | Callback
\<
[
NetworkState
](
js-apis-radio.md#
networkstate
)
\>
| 是 | 回调函数。参考radio的
[
NetworkState
](
js-apis-radio.md#networks
tate
)
|
**示例:**
**示例:**
...
@@ -37,13 +37,13 @@ observer.on('networkStateChange', data =>{
...
@@ -37,13 +37,13 @@ observer.on('networkStateChange', data =>{
```
```
## observer.on('networkStateChange')
<a name=observer.on.networkStateChange.options-callback></a>
## observer.on('networkStateChange')
on
\(
type:
\'
networkStateChange
\'
, options: { slotId: number }, callback: Callback<NetworkState
\>\)
: void;
on
\(
type:
\'
networkStateChange
\'
, options: { slotId: number }, callback: Callback<NetworkState
\>\)
: void;
订阅指定卡槽位的网络状态变化事件,使用callback方式作为异步方法。
订阅指定卡槽位的网络状态变化事件,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.StateRegistry
**系统能力**
:SystemCapability.Telephony.StateRegistry
...
@@ -53,7 +53,7 @@ on\(type: \'networkStateChange\', options: { slotId: number }, callback: Callbac
...
@@ -53,7 +53,7 @@ on\(type: \'networkStateChange\', options: { slotId: number }, callback: Callbac
| ------ | ------ | ---- | -------------------------------------- |
| ------ | ------ | ---- | -------------------------------------- |
| type | string | 是 | 网络状态变化事件 |
| type | string | 是 | 网络状态变化事件 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | Callback
\<
[
NetworkState
](
js-apis-radio.md#
NetworkState
)
\>
| 是 | 回调函数。参考radio的
[
NetworkState
](
js-apis-radio.md#NetworkS
tate
)
|
| callback | Callback
\<
[
NetworkState
](
js-apis-radio.md#
networkstate
)
\>
| 是 | 回调函数。参考radio的
[
NetworkState
](
js-apis-radio.md#networks
tate
)
|
**示例:**
**示例:**
...
@@ -64,13 +64,13 @@ observer.on('networkStateChange', {slotId: 0}, data =>{
...
@@ -64,13 +64,13 @@ observer.on('networkStateChange', {slotId: 0}, data =>{
```
```
## observer.off('networkStateChange')
<a name=observer.off.networkStateChange-callback></a>
## observer.off('networkStateChange')
off
\(
type:
\'
networkStateChange
\'
, callback?: Callback<NetworkState
\>\)
: void;
off
\(
type:
\'
networkStateChange
\'
, callback?: Callback<NetworkState
\>\)
: void;
取消订阅网络状态变化事件,使用callback方式作为异步方法。
取消订阅网络状态变化事件,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
>**说明:**
>**说明:**
>
>
...
@@ -80,10 +80,10 @@ off\(type: \'networkStateChange\', callback?: Callback<NetworkState\>\): void;
...
@@ -80,10 +80,10 @@ off\(type: \'networkStateChange\', callback?: Callback<NetworkState\>\): void;
**参数:**
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | ------------------------
| ---- |
--------------------------------- |
| -------- | ------------------------
--------------------------------- | ---- | ---------------------------
--------------------------------- |
| type | string
| 是 | 网络状态变化事件
|
| type | string
| 是 | 网络状态变化事件
|
| callback | Callback
\<
[
NetworkState
](
js-apis-radio.md#
NetworkState
)
\>
| 否 | 回调函数。参考radio的
[
NetworkState
](
js-apis-radio.md#NetworkS
tate
)
|
| callback | Callback
\<
[
NetworkState
](
js-apis-radio.md#
networkstate
)
\>
| 否 | 回调函数。参考radio的
[
NetworkState
](
js-apis-radio.md#networks
tate
)
|
**示例:**
**示例:**
...
@@ -97,7 +97,7 @@ observer.off('networkStateChange', callback);
...
@@ -97,7 +97,7 @@ observer.off('networkStateChange', callback);
observer.off('networkStateChange');
observer.off('networkStateChange');
```
```
## observer.on('signalInfoChange')
<a name=observer.on.signalInfoChange-callback></a>
## observer.on('signalInfoChange')
on
\(
type:
\'
signalInfoChange
\'
, callback: Callback<Array<SignalInformation
\>\>
): void;
on
\(
type:
\'
signalInfoChange
\'
, callback: Callback<Array<SignalInformation
\>\>
): void;
...
@@ -110,7 +110,7 @@ on\(type: \'signalInfoChange\', callback: Callback<Array<SignalInformation\>\>):
...
@@ -110,7 +110,7 @@ on\(type: \'signalInfoChange\', callback: Callback<Array<SignalInformation\>\>):
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 信号状态变化事件 |
| type | string | 是 | 信号状态变化事件 |
| callback | Callback<Array<
[
SignalInformation
](
js-apis-radio.md#
SignalInformation
)
\>\>
| 是 | 回调函数。参考radio的
[
SignalInformation
](
js-apis-radio.md#SignalI
nformation
)
|
| callback | Callback<Array<
[
SignalInformation
](
js-apis-radio.md#
signalinformation
)
\>\>
| 是 | 回调函数。参考radio的
[
SignalInformation
](
js-apis-radio.md#signali
nformation
)
|
**示例:**
**示例:**
...
@@ -121,7 +121,7 @@ observer.on('signalInfoChange', data =>{
...
@@ -121,7 +121,7 @@ observer.on('signalInfoChange', data =>{
```
```
## observer.on('signalInfoChange')
<a name=observer.on.signalInfoChange.options-callback></a>
## observer.on('signalInfoChange')
on
\(
type:
\'
signalInfoChange
\'
, options: { slotId: number }, callback: Callback<Array<SignalInformation
\>\>
): void;
on
\(
type:
\'
signalInfoChange
\'
, options: { slotId: number }, callback: Callback<Array<SignalInformation
\>\>
): void;
...
@@ -135,7 +135,7 @@ on\(type: \'signalInfoChange\', options: { slotId: number }, callback: Callback<
...
@@ -135,7 +135,7 @@ on\(type: \'signalInfoChange\', options: { slotId: number }, callback: Callback<
| ------ | ------ | ---- | -------------------------------------- |
| ------ | ------ | ---- | -------------------------------------- |
| type | string | 是 | 信号状态变化事件 |
| type | string | 是 | 信号状态变化事件 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | Callback<Array<
[
SignalInformation
](
js-apis-radio.md#
SignalInformation
)
\>\>
| 是 | 回调函数。参考radio的
[
SignalInformation
](
js-apis-radio.md#SignalI
nformation
)
|
| callback | Callback<Array<
[
SignalInformation
](
js-apis-radio.md#
signalinformation
)
\>\>
| 是 | 回调函数。参考radio的
[
SignalInformation
](
js-apis-radio.md#signali
nformation
)
|
**示例:**
**示例:**
...
@@ -146,7 +146,7 @@ observer.on('signalInfoChange', {slotId: 0}, data =>{
...
@@ -146,7 +146,7 @@ observer.on('signalInfoChange', {slotId: 0}, data =>{
```
```
## observer.off('signalInfoChange')
<a name=observer.off.signalInfoChange-callback></a>
## observer.off('signalInfoChange')
off
\(
type:
\'
signalInfoChange
\'
, callback?: Callback<Array<SignalInformation
\>\>
): void;
off
\(
type:
\'
signalInfoChange
\'
, callback?: Callback<Array<SignalInformation
\>\>
): void;
...
@@ -163,7 +163,7 @@ off\(type: \'signalInfoChange\', callback?: Callback<Array<SignalInformation\>\>
...
@@ -163,7 +163,7 @@ off\(type: \'signalInfoChange\', callback?: Callback<Array<SignalInformation\>\>
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 信号状态变化事件 |
| type | string | 是 | 信号状态变化事件 |
| callback | Callback<Array<
[
SignalInformation
](
js-apis-radio.md#
SignalInformation
)
\>\>
| 否 | 回调函数。参考radio的
[
SignalInformation
](
js-apis-radio.md#SignalI
nformation
)
|
| callback | Callback<Array<
[
SignalInformation
](
js-apis-radio.md#
signalinformation
)
\>\>
| 否 | 回调函数。参考radio的
[
SignalInformation
](
js-apis-radio.md#signali
nformation
)
|
**示例:**
**示例:**
...
@@ -178,9 +178,9 @@ observer.off('signalInfoChange');
...
@@ -178,9 +178,9 @@ observer.off('signalInfoChange');
```
```
## observer.on('callStateChange')
<a name=observer.on.callStateChange-callback></a>
## observer.on('callStateChange')
on(type: 'callStateChange', callback: Callback
\<
{ state:
[
CallState
](
js-apis-call.md#CallState
)
, number: string }
\>
): void;
on(type: 'callStateChange', callback: Callback
\<
{ state:
CallState
, number: string }
\>
): void;
订阅通话状态变化事件,使用callback方式作为异步方法。
订阅通话状态变化事件,使用callback方式作为异步方法。
...
@@ -193,7 +193,7 @@ on(type: 'callStateChange', callback: Callback\<{ state: [CallState](js-apis-cal
...
@@ -193,7 +193,7 @@ on(type: 'callStateChange', callback: Callback\<{ state: [CallState](js-apis-cal
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 通话状态变化事件 |
| type | string | 是 | 通话状态变化事件 |
| callback | Callback
\<
{ state:
[
CallState
](
js-apis-call.md#
CallState
)
, number: string }
\>
| 是 | 回调函数,参考call的
[
CallState
](
js-apis-call.md#CallS
tate
)
<br
/>
number:电话号码 |
| callback | Callback
\<
{ state:
[
CallState
](
js-apis-call.md#
callstate
)
, number: string }
\>
| 是 | 回调函数,参考call的
[
CallState
](
js-apis-call.md#calls
tate
)
<br
/>
number:电话号码 |
**示例:**
**示例:**
...
@@ -204,9 +204,9 @@ observer.on('callStateChange', value =>{
...
@@ -204,9 +204,9 @@ observer.on('callStateChange', value =>{
```
```
## observer.on('callStateChange')
<a name=observer.on.callStateChange.options-callback></a>
## observer.on('callStateChange')
on(type: 'callStateChange', options: { slotId: number }, callback: Callback
<
{
state:
[
CallState
](
js-apis-call.md#CallState
)
,
number:
string
}
>
): void;
on(type: 'callStateChange', options: { slotId: number }, callback: Callback
<
{
state:
CallState
,
number:
string
}
>
): void;
订阅通话状态变化事件,使用callback方式作为异步方法。
订阅通话状态变化事件,使用callback方式作为异步方法。
...
@@ -220,7 +220,7 @@ on(type: 'callStateChange', options: { slotId: number }, callback: Callback<{ st
...
@@ -220,7 +220,7 @@ on(type: 'callStateChange', options: { slotId: number }, callback: Callback<{ st
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 通话状态变化事件 |
| type | string | 是 | 通话状态变化事件 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | Callback
\<
{ state:
[
CallState
](
js-apis-call.md#
CallState
)
, number: string }
\>
| 是 | 回调函数,参考call的
[
CallState
](
js-apis-call.md#CallS
tate
)
<br
/>
number:电话号码 |
| callback | Callback
\<
{ state:
[
CallState
](
js-apis-call.md#
callstate
)
, number: string }
\>
| 是 | 回调函数,参考call的
[
CallState
](
js-apis-call.md#calls
tate
)
<br
/>
number:电话号码 |
**示例:**
**示例:**
...
@@ -231,9 +231,9 @@ observer.on('callStateChange', {slotId: 0}, value =>{
...
@@ -231,9 +231,9 @@ observer.on('callStateChange', {slotId: 0}, value =>{
```
```
## observer.off('callStateChange')
<a name=observer.off.callStateChange-callback></a>
## observer.off('callStateChange')
off(type: 'callStateChange', callback?: Callback
<
{
state:
[
CallState
](
js-apis-call.md#CallState
)
,
number:
string
}
>
): void;
off(type: 'callStateChange', callback?: Callback
<
{
state:
CallState
,
number:
string
}
>
): void;
取消订阅通话状态变化事件,使用callback方式作为异步方法。
取消订阅通话状态变化事件,使用callback方式作为异步方法。
...
@@ -250,7 +250,7 @@ off(type: 'callStateChange', callback?: Callback<{ state: [CallState](js-apis-ca
...
@@ -250,7 +250,7 @@ off(type: 'callStateChange', callback?: Callback<{ state: [CallState](js-apis-ca
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 通话状态变化事件 |
| type | string | 是 | 通话状态变化事件 |
| callback | Callback
\<
{ state:
[
CallState
](
js-apis-call.md#
CallState
)
, number: string }
\>
| 否 | 回调函数,参考call的
[
CallState
](
js-apis-call.md#CallS
tate
)
<br
/>
number:电话号码 |
| callback | Callback
\<
{ state:
[
CallState
](
js-apis-call.md#
callstate
)
, number: string }
\>
| 否 | 回调函数,参考call的
[
CallState
](
js-apis-call.md#calls
tate
)
<br
/>
number:电话号码 |
**示例:**
**示例:**
...
@@ -265,9 +265,9 @@ observer.off('callStateChange');
...
@@ -265,9 +265,9 @@ observer.off('callStateChange');
```
```
## observer.on('cellularDataConnectionStateChange')<sup>7+</sup>
<a name=observer.on.cellularDataConnectionStateChange-callback></a>
## observer.on('cellularDataConnectionStateChange')<sup>7+</sup>
on
\(
type: 'cellularDataConnectionStateChange', callback: Callback
\<
{ state: DataConnectState, network: Ra
dioTechnology
}
\>\)
: void;
on
\(
type: 'cellularDataConnectionStateChange', callback: Callback
\<
{ state: DataConnectState, network: Ra
tType
}
\>\)
: void;
订阅蜂窝数据链路连接状态,使用callback方式作为异步方法。
订阅蜂窝数据链路连接状态,使用callback方式作为异步方法。
...
@@ -278,7 +278,7 @@ on\(type: 'cellularDataConnectionStateChange', callback: Callback\<{ state: Data
...
@@ -278,7 +278,7 @@ on\(type: 'cellularDataConnectionStateChange', callback: Callback\<{ state: Data
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 蜂窝数据链路连接状态事件 |
| type | string | 是 | 蜂窝数据链路连接状态事件 |
| callback | Callback
\<
{ state:
[
DataConnectState
](
js-apis-telephony-data.md#
DataConnectState
)
, network:
[
RadioTechnology
](
js-apis-radio.md#RadioTechnology
)
}
\>
| 是 | 回调函数,参考data的
[
DataConnectState
](
js-apis-telephony-data.md#DataConnectState
)
,radio的
[
RadioTechnology
](
js-apis-radio.md#RadioT
echnology
)
。 |
| callback | Callback
\<
{ state:
[
DataConnectState
](
js-apis-telephony-data.md#
dataconnectState
)
, network:
[
RatType
](
js-apis-radio.md#radiotechnology
)
}
\>
| 是 | 回调函数,参考data的
[
DataConnectState
](
js-apis-telephony-data.md#dataconnectstate
)
,radio的
[
RadioTechnology
](
js-apis-radio.md#radiot
echnology
)
。 |
**示例:**
**示例:**
...
@@ -289,9 +289,9 @@ observer.on('cellularDataConnectionStateChange', value =>{
...
@@ -289,9 +289,9 @@ observer.on('cellularDataConnectionStateChange', value =>{
```
```
## observer.on('cellularDataConnectionStateChange')<sup>7+</sup>
<a name=observer.on.cellularDataConnectionStateChange.options-callback></a>
## observer.on('cellularDataConnectionStateChange')<sup>7+</sup>
on
\(
type: 'cellularDataConnectionStateChange', options: { slotId: number }, callback: Callback
\<
{ state: DataConnectState, network: Ra
dioTechnology
}
\>\)
: void;
on
\(
type: 'cellularDataConnectionStateChange', options: { slotId: number }, callback: Callback
\<
{ state: DataConnectState, network: Ra
tType
}
\>\)
: void;
订阅指定卡槽位的蜂窝数据链路连接状态,使用callback方式作为异步方法。
订阅指定卡槽位的蜂窝数据链路连接状态,使用callback方式作为异步方法。
...
@@ -303,7 +303,7 @@ on\(type: 'cellularDataConnectionStateChange', options: { slotId: number }, call
...
@@ -303,7 +303,7 @@ on\(type: 'cellularDataConnectionStateChange', options: { slotId: number }, call
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 蜂窝数据链路连接状态事件 |
| type | string | 是 | 蜂窝数据链路连接状态事件 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | Callback
\<
{ state:
[
DataConnectState
](
js-apis-telephony-data.md#
DataConnectState
)
, network:
[
RadioTechnology
](
js-apis-radio.md#RadioTechnology
)
}
\>
| 是 | 回调函数,参考data的
[
DataConnectState
](
js-apis-telephony-data.md#DataConnectState
)
,radio的
[
RadioTechnology
](
js-apis-radio.md#RadioT
echnology
)
。 |
| callback | Callback
\<
{ state:
[
DataConnectState
](
js-apis-telephony-data.md#
dataconnectState
)
, network:
[
RatType
](
js-apis-radio.md#radiotechnology
)
}
\>
| 是 | 回调函数,参考data的
[
DataConnectState
](
js-apis-telephony-data.md#dataconnectstate
)
,radio的
[
RadioTechnology
](
js-apis-radio.md#radiot
echnology
)
。 |
**示例:**
**示例:**
...
@@ -314,9 +314,9 @@ observer.on('cellularDataConnectionStateChange', {slotId: 0}, value =>{
...
@@ -314,9 +314,9 @@ observer.on('cellularDataConnectionStateChange', {slotId: 0}, value =>{
```
```
## observer.off('cellularDataConnectionStateChange')<sup>7+</sup>
<a name=observer.off.cellularDataConnectionStateChange-callback></a>
## observer.off('cellularDataConnectionStateChange')<sup>7+</sup>
off
\(
type: 'cellularDataConnectionStateChange', callback?: Callback
\<
{ state: DataConnectState, network: Ra
dioTechnology
}
\>\)
: void;
off
\(
type: 'cellularDataConnectionStateChange', callback?: Callback
\<
{ state: DataConnectState, network: Ra
tType
}
\>\)
: void;
移除订阅蜂窝数据链路连接状态,使用callback方式作为异步方法。
移除订阅蜂窝数据链路连接状态,使用callback方式作为异步方法。
...
@@ -331,7 +331,7 @@ off\(type: 'cellularDataConnectionStateChange', callback?: Callback\<{ state: D
...
@@ -331,7 +331,7 @@ off\(type: 'cellularDataConnectionStateChange', callback?: Callback\<{ state: D
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 蜂窝数据链路连接状态事件 |
| type | string | 是 | 蜂窝数据链路连接状态事件 |
| callback | Callback
\<
{ state:
[
DataConnectState
](
js-apis-telephony-data.md#
DataConnectState
)
, network:
[
RadioTechnology
](
js-apis-radio.md#RadioTechnology
)
}
\>
| 否 | 回调函数,参考data的
[
DataConnectState
](
js-apis-telephony-data.md#DataConnectState
)
,radio的
[
RadioTechnology
](
js-apis-radio.md#RadioT
echnology
)
。 |
| callback | Callback
\<
{ state:
[
DataConnectState
](
js-apis-telephony-data.md#
dataconnectState
)
, network:
[
RatType
](
js-apis-radio.md#radiotechnology
)
}
\>
| 否 | 回调函数,参考data的
[
DataConnectState
](
js-apis-telephony-data.md#dataconnectstate
)
,radio的
[
RadioTechnology
](
js-apis-radio.md#radiot
echnology
)
。 |
**示例:**
**示例:**
...
@@ -346,7 +346,7 @@ observer.off('cellularDataConnectionStateChange');
...
@@ -346,7 +346,7 @@ observer.off('cellularDataConnectionStateChange');
```
```
## observer.on('cellularDataFlowChange')<sup>7+</sup>
<a name=observer.on.cellularDataFlowChange-callback></a>
## observer.on('cellularDataFlowChange')<sup>7+</sup>
on
\(
type: 'cellularDataFlowChange', callback: Callback
\<
DataFlowType
\>\)
: void;
on
\(
type: 'cellularDataFlowChange', callback: Callback
\<
DataFlowType
\>\)
: void;
...
@@ -358,8 +358,8 @@ on\(type: 'cellularDataFlowChange', callback: Callback\<DataFlowType\>\): void;
...
@@ -358,8 +358,8 @@ on\(type: 'cellularDataFlowChange', callback: Callback\<DataFlowType\>\): void;
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 蜂窝数据业务的上下行数据流状态状态事件
|
| type | string | 是 | 蜂窝数据业务的上下行数据流状态状态事件 |
| callback | Callback
\<
[
DataFlowType
](
js-apis-telephony-data.md#
DataFlowType
)
\>
| 是 | 回调函数,参考data的
[
DataFlowType
](
js-apis-telephony-data.md#DataFlowT
ype
)
。 |
| callback | Callback
\<
[
DataFlowType
](
js-apis-telephony-data.md#
dataflowtype
)
\>
| 是 | 回调函数,参考data的
[
DataFlowType
](
js-apis-telephony-data.md#dataflowt
ype
)
。 |
**示例:**
**示例:**
...
@@ -370,7 +370,7 @@ observer.on('cellularDataFlowChange', data =>{
...
@@ -370,7 +370,7 @@ observer.on('cellularDataFlowChange', data =>{
```
```
## observer.on('cellularDataFlowChange')<sup>7+</sup>
<a name=observer.on.cellularDataFlowChange.options-callback></a>
## observer.on('cellularDataFlowChange')<sup>7+</sup>
on
\(
type: 'cellularDataFlowChange', options: { slotId: number }, callback: Callback
\<
DataFlowType
\>\)
: void;
on
\(
type: 'cellularDataFlowChange', options: { slotId: number }, callback: Callback
\<
DataFlowType
\>\)
: void;
...
@@ -382,9 +382,9 @@ on\(type: 'cellularDataFlowChange', options: { slotId: number }, callback: Call
...
@@ -382,9 +382,9 @@ on\(type: 'cellularDataFlowChange', options: { slotId: number }, callback: Call
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 蜂窝数据业务的上下行数据流状态事件
|
| type | string | 是 | 蜂窝数据业务的上下行数据流状态事件 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | Callback
\<
[
DataFlowType
](
js-apis-telephony-data.md#
DataFlowType
)
\>
| 是 | 回调函数,参考data的
[
DataFlowType
](
js-apis-telephony-data.md#DataFlowT
ype
)
。 |
| callback | Callback
\<
[
DataFlowType
](
js-apis-telephony-data.md#
dataflowtype
)
\>
| 是 | 回调函数,参考data的
[
DataFlowType
](
js-apis-telephony-data.md#dataflowt
ype
)
。 |
**示例:**
**示例:**
...
@@ -395,7 +395,7 @@ observer.on('cellularDataFlowChange', {slotId: 0}, data =>{
...
@@ -395,7 +395,7 @@ observer.on('cellularDataFlowChange', {slotId: 0}, data =>{
```
```
## observer.off('cellularDataFlowChange')<sup>7+</sup>
<a name=observer.off.cellularDataFlowChange-callback></a>
## observer.off('cellularDataFlowChange')<sup>7+</sup>
off
\(
type: 'cellularDataFlowChange', callback?: Callback
\<
DataFlowType
\>\)
: void;
off
\(
type: 'cellularDataFlowChange', callback?: Callback
\<
DataFlowType
\>\)
: void;
...
@@ -411,8 +411,8 @@ off\(type: 'cellularDataFlowChange', callback?: Callback\<DataFlowType\>\): void
...
@@ -411,8 +411,8 @@ off\(type: 'cellularDataFlowChange', callback?: Callback\<DataFlowType\>\): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 蜂窝数据业务的上下行数据流状态事件
|
| type | string | 是 | 蜂窝数据业务的上下行数据流状态事件 |
| callback | Callback
\<
[
DataFlowType
](
js-apis-telephony-data.md#
DataFlowType
)
\>
| 否 | 回调函数,参考data的
[
DataFlowType
](
js-apis-telephony-data.md#DataFlowT
ype
)
。 |
| callback | Callback
\<
[
DataFlowType
](
js-apis-telephony-data.md#
dataflowtype
)
\>
| 否 | 回调函数,参考data的
[
DataFlowType
](
js-apis-telephony-data.md#dataflowt
ype
)
。 |
**示例:**
**示例:**
...
@@ -427,7 +427,7 @@ observer.off('cellularDataFlowChange');
...
@@ -427,7 +427,7 @@ observer.off('cellularDataFlowChange');
```
```
## observer.on('simStateChange')<sup>7+</sup>
<a name=observer.on.simStateChange-callback></a>
## observer.on('simStateChange')<sup>7+</sup>
on
\(
type: 'simStateChange', callback: Callback
\<
SimStateData
\>\)
: void;
on
\(
type: 'simStateChange', callback: Callback
\<
SimStateData
\>\)
: void;
...
@@ -451,7 +451,7 @@ observer.on('simStateChange', data =>{
...
@@ -451,7 +451,7 @@ observer.on('simStateChange', data =>{
```
```
## observer.on('simStateChange')<sup>7+</sup>
<a name=observer.on.simStateChange.options-callback></a>
## observer.on('simStateChange')<sup>7+</sup>
on
\(
type: 'simStateChange', options: { slotId: number }, callback: Callback
\<
SimStateData
\>\)
: void;
on
\(
type: 'simStateChange', options: { slotId: number }, callback: Callback
\<
SimStateData
\>\)
: void;
...
@@ -476,7 +476,7 @@ observer.on('simStateChange', {slotId: 0}, data =>{
...
@@ -476,7 +476,7 @@ observer.on('simStateChange', {slotId: 0}, data =>{
```
```
## observer.off('simStateChange')<sup>7+</sup>
<a name=observer.off.simStateChange-callback></a>
## observer.off('simStateChange')<sup>7+</sup>
off
\(
type: 'simStateChange', callback?: Callback
\<
SimStateData
\>\)
: void;
off
\(
type: 'simStateChange', callback?: Callback
\<
SimStateData
\>\)
: void;
...
@@ -512,30 +512,34 @@ observer.off('simStateChange');
...
@@ -512,30 +512,34 @@ observer.off('simStateChange');
SIM卡锁类型。
SIM卡锁类型。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.StateRegistry。
| ----------- | ---- | ------------------------------------------------------------ |
| SIM_NONE | 0 | 无锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| 名称 | 值 | 说明 |
| SIM_PIN | 1 | PIN锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| ----------- | ---- | ----------------- |
| SIM_PUK | 2 | PUK锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_NONE | 0 | 无锁。 |
| SIM_PN_PIN | 3 | 网络PIN锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PIN | 1 | PIN锁。 |
| SIM_PN_PUK | 4 | 网络PUK锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PUK | 2 | PUK锁。 |
| SIM_PU_PIN | 5 | 子网PIN锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PN_PIN | 3 | 网络PIN锁。 |
| SIM_PU_PUK | 6 | 子网PUK锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PN_PUK | 4 | 网络PUK锁。 |
| SIM_PP_PIN | 7 | 服务提供商PIN锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PU_PIN | 5 | 子网PIN锁。 |
| SIM_PP_PUK | 8 | 服务提供商PUK锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PU_PUK | 6 | 子网PUK锁。 |
| SIM_PC_PIN | 9 | 组织PIN锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PP_PIN | 7 | 服务提供商PIN锁。 |
| SIM_PC_PUK | 10 | 组织PUK锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PP_PUK | 8 | 服务提供商PUK锁。 |
| SIM_SIM_PIN | 11 | SIM PIN锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PC_PIN | 9 | 组织PIN锁。 |
| SIM_SIM_PUK | 12 | SIM PUK锁。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry |
| SIM_PC_PUK | 10 | 组织PUK锁。 |
| SIM_SIM_PIN | 11 | SIM PIN锁。 |
| SIM_SIM_PUK | 12 | SIM PUK锁。 |
## SimStateData<sup>7+</sup>
## SimStateData<sup>7+</sup>
SIM卡类型和状态。
SIM卡类型和状态。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.StateRegistry。
| 名称 | 类型 | 说明 |
| ----------------- | --------------------- | ------------------------------------------------------------ |
| ----------------- | --------------------- | ------------------------------------------------------------ |
| type |
[
CardType
](
js-apis-sim.md#cardtype
)
| SIM卡类型,参考sim的
[
CardType
](
js-apis-sim.md#cardtype
)
。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry
|
| type |
[
CardType
](
js-apis-sim.md#cardtype
)
| SIM卡类型,参考sim的
[
CardType
](
js-apis-sim.md#cardtype
)
。 |
| state |
[
SimState
](
js-apis-sim.md#
SimState
)
| SIM卡状态,参考sim的
[
SimState
](
js-apis-sim.md#SimState
)
。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry
|
| state |
[
SimState
](
js-apis-sim.md#
simstate
)
| SIM卡状态,参考sim的
[
SimState
](
js-apis-sim.md#simstate
)
。
|
| reason
<sup>
8+
</sup>
|
[
LockReason
](
#lockreason8
)
| SIM卡锁类型。
<br/>
**系统能力**
:SystemCapability.Telephony.StateRegistry
|
| reason
<sup>
8+
</sup>
|
[
LockReason
](
#lockreason8
)
| SIM卡锁类型。 |
zh-cn/application-dev/reference/apis/js-apis-radio.md
浏览文件 @
b5160e59
...
@@ -11,13 +11,13 @@
...
@@ -11,13 +11,13 @@
import radio from '@ohos.telephony.radio'
import radio from '@ohos.telephony.radio'
```
```
## radio.getRadioTech
<a name=radio.getRadioTech-callback></a>
## radio.getRadioTech
getRadioTech
\(
slotId: number, callback: AsyncCallback<
\{
psRadioTech: RadioTechnology, csRadioTech: RadioTechnology
\}\>\)
: void
getRadioTech
\(
slotId: number, callback: AsyncCallback<
\{
psRadioTech: RadioTechnology, csRadioTech: RadioTechnology
\}\>\)
: void
获取当前接入的CS域和PS域无线接入技术,使用callback方式作为异步方法。
获取当前接入的CS域和PS域无线接入技术,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -26,7 +26,7 @@ getRadioTech\(slotId: number, callback: AsyncCallback<\{psRadioTech: RadioTechno
...
@@ -26,7 +26,7 @@ getRadioTech\(slotId: number, callback: AsyncCallback<\{psRadioTech: RadioTechno
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- |
| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | AsyncCallback
\<
{psRadioTech:
[
RadioTechnology
](
#
RadioTechnology
)
, csRadioTech:
[
RadioTechnology
](
#RadioT
echnology
)
}
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
{psRadioTech:
[
RadioTechnology
](
#
radiotechnology
)
, csRadioTech:
[
RadioTechnology
](
#radiot
echnology
)
}
\>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -38,13 +38,13 @@ radio.getRadioTech(slotId, (err, data) =>{
...
@@ -38,13 +38,13 @@ radio.getRadioTech(slotId, (err, data) =>{
```
```
## radio.getRadioTech
<a name=radio.getRadioTech-promise></a>
## radio.getRadioTech
getRadioTech
\(
slotId: number
\)
: Promise<
\{
psRadioTech: RadioTechnology, csRadioTech: RadioTechnology
\}\>
getRadioTech
\(
slotId: number
\)
: Promise<
\{
psRadioTech: RadioTechnology, csRadioTech: RadioTechnology
\}\>
获取当前接入的CS域和PS域无线接入技术,使用Promise方式作为异步方法。
获取当前接入的CS域和PS域无线接入技术,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -58,7 +58,7 @@ getRadioTech\(slotId: number\): Promise<\{psRadioTech: RadioTechnology, csRadioT
...
@@ -58,7 +58,7 @@ getRadioTech\(slotId: number\): Promise<\{psRadioTech: RadioTechnology, csRadioT
| 类型 | 说明 |
| 类型 | 说明 |
| ------------------------------------------------------------ | ----------------------------------------------- |
| ------------------------------------------------------------ | ----------------------------------------------- |
| Promise
<
{
psRadioTech:
[
RadioTechnology
](
#
RadioTechnology
),
csRadioTech:
[
RadioTechnology
](
#RadioT
echnology
)}
>
| 以Promise形式返回获取当前接入的CS域和PS域技术。 |
| Promise
<
{
psRadioTech:
[
RadioTechnology
](
#
radiotechnology
),
csRadioTech:
[
RadioTechnology
](
#radiot
echnology
)}
>
| 以Promise形式返回获取当前接入的CS域和PS域技术。 |
**示例:**
**示例:**
...
@@ -73,13 +73,13 @@ promise.then(data => {
...
@@ -73,13 +73,13 @@ promise.then(data => {
```
```
## radio.getNetworkState
<a name=radio.getNetworkState-callback1></a>
## radio.getNetworkState
getNetworkState
\(
callback: AsyncCallback<NetworkState
\>\)
: void
getNetworkState
\(
callback: AsyncCallback<NetworkState
\>\)
: void
获取网络状态,使用callback方式作为异步方法。
获取网络状态,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -87,7 +87,7 @@ getNetworkState\(callback: AsyncCallback<NetworkState\>\): void
...
@@ -87,7 +87,7 @@ getNetworkState\(callback: AsyncCallback<NetworkState\>\): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------------- | ---- | ---------- |
| -------- | ---------------------------------------------- | ---- | ---------- |
| callback | AsyncCallback
\<
[
NetworkState
](
#
NetworkS
tate
)
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
[
NetworkState
](
#
networks
tate
)
\>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -98,13 +98,13 @@ radio.getNetworkState((err, data) =>{
...
@@ -98,13 +98,13 @@ radio.getNetworkState((err, data) =>{
```
```
## radio.getNetworkState
<a name=radio.getNetworkState-callback2></a>
## radio.getNetworkState
getNetworkState
\(
slotId: number, callback: AsyncCallback<NetworkState
\>\)
: void
getNetworkState
\(
slotId: number, callback: AsyncCallback<NetworkState
\>\)
: void
获取网络状态,使用callback方式作为异步方法。
获取网络状态,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -113,7 +113,7 @@ getNetworkState\(slotId: number, callback: AsyncCallback<NetworkState\>\): void
...
@@ -113,7 +113,7 @@ getNetworkState\(slotId: number, callback: AsyncCallback<NetworkState\>\): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------------- | ---- | -------------------------------------- |
| -------- | ---------------------------------------------- | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | AsyncCallback
\<
[
NetworkState
](
#
NetworkS
tate
)
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
[
NetworkState
](
#
networks
tate
)
\>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -125,13 +125,13 @@ radio.getNetworkState(slotId, (err, data) => {
...
@@ -125,13 +125,13 @@ radio.getNetworkState(slotId, (err, data) => {
```
```
## radio.getNetworkState
<a name=radio.getNetworkState-promise></a>
## radio.getNetworkState
getNetworkState
\(
slotId?: number
\)
: Promise<NetworkState
\>
getNetworkState
\(
slotId?: number
\)
: Promise<NetworkState
\>
获取网络状态,使用Promise方式作为异步方法。
获取网络状态,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -145,7 +145,7 @@ getNetworkState\(slotId?: number\): Promise<NetworkState\>
...
@@ -145,7 +145,7 @@ getNetworkState\(slotId?: number\): Promise<NetworkState\>
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------------------------- | --------------------------- |
| ---------------------------------------- | --------------------------- |
| Promise
\<
[
NetworkState
](
#
NetworkS
tate
)
\>
| 以Promise形式返回网络状态。 |
| Promise
\<
[
NetworkState
](
#
networks
tate
)
\>
| 以Promise形式返回网络状态。 |
**示例:**
**示例:**
...
@@ -160,7 +160,7 @@ promise.then(data => {
...
@@ -160,7 +160,7 @@ promise.then(data => {
```
```
## radio.getNetworkSelectionMode
<a name=radio.getNetworkSelectionMode-callback></a>
## radio.getNetworkSelectionMode
getNetworkSelectionMode
\(
slotId: number, callback: AsyncCallback<NetworkSelectionMode
\>\)
: void
getNetworkSelectionMode
\(
slotId: number, callback: AsyncCallback<NetworkSelectionMode
\>\)
: void
...
@@ -173,7 +173,7 @@ getNetworkSelectionMode\(slotId: number, callback: AsyncCallback<NetworkSelectio
...
@@ -173,7 +173,7 @@ getNetworkSelectionMode\(slotId: number, callback: AsyncCallback<NetworkSelectio
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- |
| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | AsyncCallback
\<
[
NetworkSelectionMode
](
#
NetworkS
electionMode
)
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
[
NetworkSelectionMode
](
#
networks
electionMode
)
\>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -185,7 +185,7 @@ radio.getNetworkSelectionMode(slotId, (err, data) => {
...
@@ -185,7 +185,7 @@ radio.getNetworkSelectionMode(slotId, (err, data) => {
```
```
## radio.getNetworkSelectionMode
<a name=radio.getNetworkSelectionMode-promise></a>
## radio.getNetworkSelectionMode
getNetworkSelectionMode
\(
slotId: number
\)
: Promise<NetworkSelectionMode
\>
getNetworkSelectionMode
\(
slotId: number
\)
: Promise<NetworkSelectionMode
\>
...
@@ -203,7 +203,7 @@ getNetworkSelectionMode\(slotId: number\): Promise<NetworkSelectionMode\>
...
@@ -203,7 +203,7 @@ getNetworkSelectionMode\(slotId: number\): Promise<NetworkSelectionMode\>
| 类型 | 说明 |
| 类型 | 说明 |
| -------------------------------------------------------- | ------------------------------- |
| -------------------------------------------------------- | ------------------------------- |
| Promise
\<
[
NetworkSelectionMode
](
#
NetworkSelectionM
ode
)
\>
| 以Promise形式返回当前选网模式。 |
| Promise
\<
[
NetworkSelectionMode
](
#
networkselectionm
ode
)
\>
| 以Promise形式返回当前选网模式。 |
**示例:**
**示例:**
...
@@ -218,7 +218,7 @@ promise.then(data => {
...
@@ -218,7 +218,7 @@ promise.then(data => {
```
```
## radio.getISOCountryCodeForNetwork<sup>7+</sup>
<a name=radio.getISOCountryCodeForNetwork-callback></a>
## radio.getISOCountryCodeForNetwork<sup>7+</sup>
getISOCountryCodeForNetwork
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
getISOCountryCodeForNetwork
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
...
@@ -243,7 +243,7 @@ radio.getISOCountryCodeForNetwork(slotId, (err, data) => {
...
@@ -243,7 +243,7 @@ radio.getISOCountryCodeForNetwork(slotId, (err, data) => {
```
```
## radio.getISOCountryCodeForNetwork<sup>7+</sup>
<a name=radio.getISOCountryCodeForNetwork-promise></a>
## radio.getISOCountryCodeForNetwork<sup>7+</sup>
getISOCountryCodeForNetwork
\(
slotId: number
\)
: Promise<string
\>
getISOCountryCodeForNetwork
\(
slotId: number
\)
: Promise<string
\>
...
@@ -276,7 +276,7 @@ promise.then(data => {
...
@@ -276,7 +276,7 @@ promise.then(data => {
```
```
## radio.getPrimarySlotId<sup>7+</sup>
<a name=radio.getPrimarySlotId-callback></a>
## radio.getPrimarySlotId<sup>7+</sup>
getPrimarySlotId
\(
callback: AsyncCallback
\<
number
\>\)
: void
getPrimarySlotId
\(
callback: AsyncCallback
\<
number
\>\)
: void
...
@@ -299,7 +299,7 @@ radio.getPrimarySlotId((err, data) => {
...
@@ -299,7 +299,7 @@ radio.getPrimarySlotId((err, data) => {
```
```
## radio.getPrimarySlotId<sup>7+</sup>
<a name=radio.getPrimarySlotId-promise></a>
## radio.getPrimarySlotId<sup>7+</sup>
getPrimarySlotId
\(\)
: Promise
\<
number
\>
getPrimarySlotId
\(\)
: Promise
\<
number
\>
...
@@ -325,7 +325,7 @@ promise.then(data => {
...
@@ -325,7 +325,7 @@ promise.then(data => {
```
```
## radio.getSignalInformation<sup>7+</sup>
<a name=radio.getSignalInformation-callback></a>
## radio.getSignalInformation<sup>7+</sup>
getSignalInformation
\(
slotId: number, callback: AsyncCallback<Array<SignalInformation
\>\>\)
: void
getSignalInformation
\(
slotId: number, callback: AsyncCallback<Array<SignalInformation
\>\>\)
: void
...
@@ -338,7 +338,7 @@ getSignalInformation\(slotId: number, callback: AsyncCallback<Array<SignalInform
...
@@ -338,7 +338,7 @@ getSignalInformation\(slotId: number, callback: AsyncCallback<Array<SignalInform
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | AsyncCallback
\<
Array
\<
[
SignalInformation
](
#
SignalInformation
)
\>\>
| 是 | 回调函数,返回
[
SignalInformation
](
#SignalI
nformation
)
对象的数组。 |
| callback | AsyncCallback
\<
Array
\<
[
SignalInformation
](
#
signalinformation
)
\>\>
| 是 | 回调函数,返回
[
SignalInformation
](
#signali
nformation
)
对象的数组。 |
**示例:**
**示例:**
...
@@ -350,7 +350,7 @@ radio.getSignalInformation(slotId, (err, data) => {
...
@@ -350,7 +350,7 @@ radio.getSignalInformation(slotId, (err, data) => {
```
```
## radio.getSignalInformation<sup>7+</sup>
<a name=radio.getSignalInformation-promise></a>
## radio.getSignalInformation<sup>7+</sup>
getSignalInformation
\(
slotId: number
\)
: Promise<Array<SignalInformation
\>\>
getSignalInformation
\(
slotId: number
\)
: Promise<Array<SignalInformation
\>\>
...
@@ -368,7 +368,7 @@ getSignalInformation\(slotId: number\): Promise<Array<SignalInformation\>\>
...
@@ -368,7 +368,7 @@ getSignalInformation\(slotId: number\): Promise<Array<SignalInformation\>\>
| 类型 | 说明 |
| 类型 | 说明 |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| Promise
\<
Array
\<
[
SignalInformation
](
#
SignalInformation
)
\>\>
| 以Promise形式返回网络信号强度
[
SignalInformation
](
#SignalI
nformation
)
对象的数组。 |
| Promise
\<
Array
\<
[
SignalInformation
](
#
signalinformation
)
\>\>
| 以Promise形式返回网络信号强度
[
SignalInformation
](
#signali
nformation
)
对象的数组。 |
**示例:**
**示例:**
...
@@ -383,7 +383,7 @@ promise.then(data => {
...
@@ -383,7 +383,7 @@ promise.then(data => {
```
```
## radio.isNrSupported<sup>8+</sup>
<a name=radio.isNrSupported.slot></a>
## radio.isNrSupported<sup>8+</sup>
isNrSupported
\(
slotId: number
\)
: boolean
isNrSupported
\(
slotId: number
\)
: boolean
...
@@ -412,13 +412,13 @@ console.log(result);
...
@@ -412,13 +412,13 @@ console.log(result);
```
```
## radio.isRadioOn<sup>7+</sup>
<a name=radio.isRadioOn-callback></a>
## radio.isRadioOn<sup>7+</sup>
isRadioOn
\(
callback: AsyncCallback<boolean
\>\)
: void
isRadioOn
\(
callback: AsyncCallback<boolean
\>\)
: void
判断主卡的Radio是否打开,使用callback方式作为异步方法。
判断主卡的Radio是否打开,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -437,13 +437,13 @@ radio.isRadioOn((err, data) => {
...
@@ -437,13 +437,13 @@ radio.isRadioOn((err, data) => {
```
```
## radio.isRadioOn<sup>7+</sup>
<a name=radio.isRadioOn.slot-callback></a>
## radio.isRadioOn<sup>7+</sup>
isRadioOn
\(
slotId: number, callback: AsyncCallback<boolean
\>\)
: void
isRadioOn
\(
slotId: number, callback: AsyncCallback<boolean
\>\)
: void
判断指定卡槽位的Radio是否打开,使用callback方式作为异步方法。
判断指定卡槽位的Radio是否打开,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -464,13 +464,13 @@ radio.isRadioOn(slotId, (err, data) => {
...
@@ -464,13 +464,13 @@ radio.isRadioOn(slotId, (err, data) => {
```
```
## radio.isRadioOn<sup>7+</sup>
<a name=radio.isRadioOn.slot-promise></a>
## radio.isRadioOn<sup>7+</sup>
isRadioOn
\(
slotId?: number
\)
: Promise<boolean
\>
isRadioOn
\(
slotId?: number
\)
: Promise<boolean
\>
判断Radio是否打开,使用Promise方式作为异步方法。
判断Radio是否打开,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
。
**需要权限**
:ohos.permission.GET_NETWORK_INFO
**系统能力**
:SystemCapability.Telephony.CoreService
**系统能力**
:SystemCapability.Telephony.CoreService
...
@@ -499,7 +499,7 @@ promise.then(data => {
...
@@ -499,7 +499,7 @@ promise.then(data => {
```
```
## radio.getOperatorName<sup>7+</sup>
<a name=radio.getOperatorName-callback></a>
## radio.getOperatorName<sup>7+</sup>
getOperatorName
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
getOperatorName
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
...
@@ -524,7 +524,7 @@ radio.getOperatorName(slotId, (err, data) => {
...
@@ -524,7 +524,7 @@ radio.getOperatorName(slotId, (err, data) => {
```
```
## radio.getOperatorName<sup>7+</sup>
<a name=radio.getOperatorName-promise></a>
## radio.getOperatorName<sup>7+</sup>
getOperatorName
\(
slotId: number
\)
: Promise<string
\>
getOperatorName
\(
slotId: number
\)
: Promise<string
\>
...
@@ -557,101 +557,115 @@ promise.then(data => {
...
@@ -557,101 +557,115 @@ promise.then(data => {
```
```
## RadioTechnology
<a name=RadioTechnology></a>
## RadioTechnology
无线接入技术。
无线接入技术。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| 名称 | 值 | 说明 |
| ------------------------- | ---- | ------------------------------------------------------------ |
| ------------------------- | ---- | ------------------------------------------------------------ |
| RADIO_TECHNOLOGY_UNKNOWN | 0 | 未知无线接入技术(RAT)。
<br>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_UNKNOWN | 0 | 未知无线接入技术(RAT)。
|
| RADIO_TECHNOLOGY_GSM | 1 | 无线接入技术GSM(Global System For Mobile Communication)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_GSM | 1 | 无线接入技术GSM(Global System For Mobile Communication)。
|
| RADIO_TECHNOLOGY_1XRTT | 2 | 无线接入技术1XRTT(Single-Carrier Radio Transmission Technology)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_1XRTT | 2 | 无线接入技术1XRTT(Single-Carrier Radio Transmission Technology)。 |
| RADIO_TECHNOLOGY_WCDMA | 3 | 无线接入技术WCDMA(Wideband Code Division Multiple Access)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_WCDMA | 3 | 无线接入技术WCDMA(Wideband Code Division Multiple Access)。 |
| RADIO_TECHNOLOGY_HSPA | 4 | 无线接入技术HSPA(High Speed Packet Access)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_HSPA | 4 | 无线接入技术HSPA(High Speed Packet Access)。
|
| RADIO_TECHNOLOGY_HSPAP | 5 | 无线接入技术HSPAP(High Speed packet access (HSPA+) )。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_HSPAP | 5 | 无线接入技术HSPAP(High Speed packet access (HSPA+) )。
|
| RADIO_TECHNOLOGY_TD_SCDMA | 6 | 无线接入技术TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_TD_SCDMA | 6 | 无线接入技术TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。 |
| RADIO_TECHNOLOGY_EVDO | 7 | 无线接入技术EVDO(Evolution、Data Only)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_EVDO | 7 | 无线接入技术EVDO(Evolution、Data Only)。
|
| RADIO_TECHNOLOGY_EHRPD | 8 | 无线接入技术EHRPD(Evolved High Rate Package Data)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_EHRPD | 8 | 无线接入技术EHRPD(Evolved High Rate Package Data)。
|
| RADIO_TECHNOLOGY_LTE | 9 | 无线接入技术LTE(Long Term Evolution)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_LTE | 9 | 无线接入技术LTE(Long Term Evolution)。
|
| RADIO_TECHNOLOGY_LTE_CA | 10 | 无线接入技术LTE_CA(Long Term Evolution_Carrier Aggregation)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_LTE_CA | 10 | 无线接入技术LTE_CA(Long Term Evolution_Carrier Aggregation)。 |
| RADIO_TECHNOLOGY_IWLAN | 11 | 无线接入技术IWLAN(Industrial Wireless LAN)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_IWLAN | 11 | 无线接入技术IWLAN(Industrial Wireless LAN)。
|
| RADIO_TECHNOLOGY_NR | 12 | 无线接入技术NR(New Radio)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| RADIO_TECHNOLOGY_NR | 12 | 无线接入技术NR(New Radio)。
|
## SignalInformation
<a name=SignalInformation></a>
## SignalInformation
网络信号强度信息对象。
网络信号强度信息对象。
| 属性名 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| ----------- | --------------------------- | ------------------------------------------------------------ |
| signalType |
[
NetworkType
](
#NetworkType
)
| 网络信号强度类型。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| 参数名 | 类型 | 说明 |
| signalLevel | number | 网络信号强度等级。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| ----------- | --------------------------- | ------------------ |
| signalType |
[
NetworkType
](
#networktype
)
| 网络信号强度类型。 |
| signalLevel | number | 网络信号强度等级。 |
## NetworkType
<a name=NetworkType></a>
## NetworkType
网络类型。
网络类型。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| 名称 | 值 | 说明 |
| -------------------- | ---- | ------------------------------------------------------------ |
| -------------------- | ---- | ------------------------------------------------------------ |
| NETWORK_TYPE_UNKNOWN | 0 | 未知网络类型。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| NETWORK_TYPE_UNKNOWN | 0 | 未知网络类型。
|
| NETWORK_TYPE_GSM | 1 | 网络类型为GSM(Global System For Mobile Communication)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| NETWORK_TYPE_GSM | 1 | 网络类型为GSM(Global System For Mobile Communication)。
|
| NETWORK_TYPE_CDMA | 2 | 网络类型为CDMA(Code Division Multiple Access)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| NETWORK_TYPE_CDMA | 2 | 网络类型为CDMA(Code Division Multiple Access)。
|
| NETWORK_TYPE_WCDMA | 3 | 网络类型为WCDMA(Wideband Code Division Multiple Access)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| NETWORK_TYPE_WCDMA | 3 | 网络类型为WCDMA(Wideband Code Division Multiple Access)。
|
| NETWORK_TYPE_TDSCDMA | 4 | 网络类型为TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| NETWORK_TYPE_TDSCDMA | 4 | 网络类型为TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。 |
| NETWORK_TYPE_LTE | 5 | 网络类型为LTE(Long Term Evolution)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| NETWORK_TYPE_LTE | 5 | 网络类型为LTE(Long Term Evolution)。
|
| NETWORK_TYPE_NR | 6 | 网络类型为5G NR(New Radio)。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| NETWORK_TYPE_NR | 6 | 网络类型为5G NR(New Radio)。
|
## NetworkState
<a name=NetworkState></a>
## NetworkState
网络注册状态。
网络注册状态。
| 变量 | 类型 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| 名称 | 类型 | 说明 |
| ----------------- | --------------------- | ------------------------------------------------------------ |
| ----------------- | --------------------- | ------------------------------------------------------------ |
| longOperatorName | string | 注册网络的长运营商名称。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| longOperatorName | string | 注册网络的长运营商名称。 |
| shortOperatorName | string | 注册网络的短运营商名称。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| shortOperatorName | string | 注册网络的短运营商名称。 |
| plmnNumeric | string | 注册网络的PLMN码。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| plmnNumeric | string | 注册网络的PLMN码。 |
| isRoaming | boolean | 是否处于漫游状态。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| isRoaming | boolean | 是否处于漫游状态。 |
| regState |
[
RegState
](
#
RegState
)
| 设备的网络注册状态。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| regState |
[
RegState
](
#
regstate
)
| 设备的网络注册状态。
|
| cfgTech
<sup>
8+
</sup>
|
[
RadioTechnology
](
#
RadioTechnology
)
| 设备的无线接入技术。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| cfgTech
<sup>
8+
</sup>
|
[
RadioTechnology
](
#
radiotechnology
)
| 设备的无线接入技术。
|
| nsaState |
[
NsaState
](
#
NsaState
)
| 设备的NSA网络注册状态。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| nsaState |
[
NsaState
](
#
nsaState
)
| 设备的NSA网络注册状态。
|
| isCaActive | boolean | CA的状态。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| isCaActive | boolean | CA的状态。 |
| isEmergency | boolean | 此设备是否只允许拨打紧急呼叫。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService
|
| isEmergency | boolean | 此设备是否只允许拨打紧急呼叫。 |
## RegState
<a name=RegState></a>
## RegState
网络注册状态。
网络注册状态。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| ----------------------------- | ---- | ------------------------------------------------------------ |
| REG_STATE_NO_SERVICE | 0 | 设备不能使用任何服务。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| REG_STATE_IN_SERVICE | 1 | 设备可以正常使用业务。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| REG_STATE_EMERGENCY_CALL_ONLY | 2 | 设备只能使用紧急呼叫业务。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| REG_STATE_POWER_OFF | 3 | 蜂窝无线电已关闭。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| 名称 | 值 | 说明 |
| ----------------------------- | ---- | -------------------------- |
| REG_STATE_NO_SERVICE | 0 | 设备不能使用任何服务。 |
| REG_STATE_IN_SERVICE | 1 | 设备可以正常使用业务。 |
| REG_STATE_EMERGENCY_CALL_ONLY | 2 | 设备只能使用紧急呼叫业务。 |
| REG_STATE_POWER_OFF | 3 | 蜂窝无线电已关闭。 |
## NsaState<a name=NsaState></a>
## NsaState
非独立组网状态。
非独立组网状态。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| -------------------------- | ---- | ------------------------------------------------------------ |
| NSA_STATE_NOT_SUPPORT | 1 | 设备在不支持NSA的LTE小区下处于空闲状态或连接状态。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| 名称 | 值 | 说明 |
| NSA_STATE_NO_DETECT | 2 | 在支持NSA但不支持NR覆盖检测的LTE小区下,设备处于空闲状态。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| -------------------------- | ---- | ---------------------------------------------------------- |
| NSA_STATE_CONNECTED_DETECT | 3 | 设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| NSA_STATE_NOT_SUPPORT | 1 | 设备在不支持NSA的LTE小区下处于空闲状态或连接状态。 |
| NSA_STATE_IDLE_DETECT | 4 | 支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| NSA_STATE_NO_DETECT | 2 | 在支持NSA但不支持NR覆盖检测的LTE小区下,设备处于空闲状态。 |
| NSA_STATE_DUAL_CONNECTED | 5 | 设备在支持NSA的LTE小区下连接到LTE + NR网络。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| NSA_STATE_CONNECTED_DETECT | 3 | 设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。 |
| NSA_STATE_SA_ATTACHED | 6 | 设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| NSA_STATE_IDLE_DETECT | 4 | 支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。 |
| NSA_STATE_DUAL_CONNECTED | 5 | 设备在支持NSA的LTE小区下连接到LTE + NR网络。 |
| NSA_STATE_SA_ATTACHED | 6 | 设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。 |
## NetworkSelectionMode
<a name=NetworkSelectionMode></a>
## NetworkSelectionMode
选网模式。
选网模式。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| --------------------------- | ---- | ------------------------------------------------------------ |
| NETWORK_SELECTION_UNKNOWN | 0 | 未知选网模式。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| 名称 | 值 | 说明 |
| NETWORK_SELECTION_AUTOMATIC | 1 | 自动选网模式。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| --------------------------- | ---- | -------------- |
| NETWORK_SELECTION_MANUAL | 2 | 手动选网模式。
<br/>
**系统能力**
:SystemCapability.Telephony.CoreService |
| NETWORK_SELECTION_UNKNOWN | 0 | 未知选网模式。 |
| NETWORK_SELECTION_AUTOMATIC | 1 | 自动选网模式。 |
| NETWORK_SELECTION_MANUAL | 2 | 手动选网模式。 |
zh-cn/application-dev/reference/apis/js-apis-sim.md
浏览文件 @
b5160e59
...
@@ -3,6 +3,7 @@
...
@@ -3,6 +3,7 @@
>**说明:**
>**说明:**
>
>
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
## 导入模块
## 导入模块
...
@@ -10,13 +11,13 @@
...
@@ -10,13 +11,13 @@
import sim from '@ohos.telephony.sim';
import sim from '@ohos.telephony.sim';
```
```
## sim.isSimActive<
a name=sim.isSimActive-callback></a
>
## sim.isSimActive<
sup>7+</sup
>
isSimActive
\(
slotId: number, callback: AsyncCallback<boolean
\>\)
: void
isSimActive
\(
slotId: number, callback: AsyncCallback<boolean
\>\)
: void
获取指定卡槽SIM卡是否激活,使用callback方式作为异步方法。
获取指定卡槽SIM卡是否激活,使用callback方式作为异步方法。
**
需要权限**
:ohos.permission.GET_TELEPHONY_STATE
**
系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
...
@@ -34,13 +35,13 @@ sim.isSimActive(0, (err, data) => {
...
@@ -34,13 +35,13 @@ sim.isSimActive(0, (err, data) => {
```
```
## sim.isSimActive<
a name=sim.isSimActive-promise></a
>
## sim.isSimActive<
sup>7+</sup
>
isSimActive
\(
slotId: number
\)
: Promise<
string
\>
isSimActive
\(
slotId: number
\)
: Promise<
boolean
\>
获取指定卡槽SIM卡是否激活,使用Promise方式作为异步方法。
获取指定卡槽SIM卡是否激活,使用Promise方式作为异步方法。
**
需要权限**
:ohos.permission.GET_TELEPHONY_STATE
**
系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
...
@@ -66,12 +67,14 @@ promise.then(data => {
...
@@ -66,12 +67,14 @@ promise.then(data => {
```
```
## sim.getDefaultVoiceSlotId<sup>7+</sup>
<a name= sim.getDefaultVoiceSlotId-callback></a>
## sim.getDefaultVoiceSlotId<sup>7+</sup>
getDefaultVoiceSlotId
\(
callback: AsyncCallback<number
\>\)
: void
getDefaultVoiceSlotId
\(
callback: AsyncCallback<number
\>\)
: void
获取默认语音业务的卡槽ID,使用callback方式作为异步方法。
获取默认语音业务的卡槽ID,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -87,12 +90,14 @@ sim.getDefaultVoiceSlotId((err, data) => {
...
@@ -87,12 +90,14 @@ sim.getDefaultVoiceSlotId((err, data) => {
```
```
## sim.getDefaultVoiceSlotId<sup>7+</sup>
<a name=sim.getDefaultVoiceSlotId-promise></a>
## sim.getDefaultVoiceSlotId<sup>7+</sup>
getDefaultVoiceSlotId
\(\)
: Promise<number
\>
getDefaultVoiceSlotId
\(\)
: Promise<number
\>
获取默认语音业务的卡槽ID,使用Promise方式作为异步方法。
获取默认语音业务的卡槽ID,使用Promise方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -110,13 +115,68 @@ promise.then(data => {
...
@@ -110,13 +115,68 @@ promise.then(data => {
});
});
```
```
## sim.hasOperatorPrivileges<sup>7+</sup>
hasOperatorPrivileges(slotId: number, callback: AsyncCallback
\<
boolean
\>
): void
检查应用(调用者)是否已被授予运营商权限,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | ---------------------------------------- |
| slotId | number | 是 | 卡槽ID。
<br
/>
- 0:卡槽1
<br
/>
- 1:卡槽2 |
| callback | AsyncCallback
\<
boolean
\>
| 是 | 回调函数。 |
**示例:**
```
sim.hasOperatorPrivileges(0, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## sim.hasOperatorPrivileges<sup>7+</sup>
hasOperatorPrivileges(slotId: number): Promise
<boolean>
检查应用(调用者)是否已被授予运营商权限,使用Promise方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------------------------------- |
| slotId | number | 是 | 卡槽ID。
<br
/>
- 0:卡槽1
<br
/>
- 1:卡槽2 |
**返回值:**
| 类型 | 说明 |
| :----------------- | :---------------------------------------------------------- |
| Promise
\<
boolean
\>
| 以Promise形式返回检查应用(调用者)是否已被授予运营商权限。 |
**示例:**
```
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
<a name=sim.getISOCountryCodeForSim-callback></a>
## sim.getISOCountryCodeForSim
getISOCountryCodeForSim
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
getISOCountryCodeForSim
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
获取指定卡槽SIM卡的ISO国家码,使用callback方式作为异步方法。
获取指定卡槽SIM卡的ISO国家码,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -133,12 +193,14 @@ sim.getISOCountryCodeForSim(0, (err, data) => {
...
@@ -133,12 +193,14 @@ sim.getISOCountryCodeForSim(0, (err, data) => {
```
```
## sim.getISOCountryCodeForSim
<a name=sim.getISOCountryCodeForSim-promise></a>
## sim.getISOCountryCodeForSim
getISOCountryCodeForSim
\(
slotId: number
\)
: Promise<string
\>
getISOCountryCodeForSim
\(
slotId: number
\)
: Promise<string
\>
获取指定卡槽SIM卡的ISO国家码,使用Promise方式作为异步方法。
获取指定卡槽SIM卡的ISO国家码,使用Promise方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -163,12 +225,14 @@ promise.then(data => {
...
@@ -163,12 +225,14 @@ promise.then(data => {
```
```
## sim.getSimOperatorNumeric
<a name=sim.getSimOperatorNumeric-callback></a>
## sim.getSimOperatorNumeric
getSimOperatorNumeric
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
getSimOperatorNumeric
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用callback方式作为异步方法。
获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -185,12 +249,14 @@ sim.getSimOperatorNumeric(0, (err, data) => {
...
@@ -185,12 +249,14 @@ sim.getSimOperatorNumeric(0, (err, data) => {
```
```
## sim.getSimOperatorNumeric
<a name=sim.getSimOperatorNumeric-promise></a>
## sim.getSimOperatorNumeric
getSimOperatorNumeric
\(
slotId: number
\)
: Promise<string
\>
getSimOperatorNumeric
\(
slotId: number
\)
: Promise<string
\>
获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用Promise方式作为异步方法。
获取指定卡槽SIM卡的归属PLMN(Public Land Mobile Network)号,使用Promise方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -215,12 +281,14 @@ promise.then(data => {
...
@@ -215,12 +281,14 @@ promise.then(data => {
```
```
## sim.getSimSpn
<a name=sim.getSimSpn-callback></a>
## sim.getSimSpn
getSimSpn
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
getSimSpn
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用callback方式作为异步方法。
获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -237,12 +305,14 @@ sim.getSimSpn(0, (err, data) => {
...
@@ -237,12 +305,14 @@ sim.getSimSpn(0, (err, data) => {
```
```
## sim.getSimSpn
<a name=sim.getSimSpn-promise></a>
## sim.getSimSpn
getSimSpn
\(
slotId: number
\)
: Promise<string
\>
getSimSpn
\(
slotId: number
\)
: Promise<string
\>
获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用Promise方式作为异步方法。
获取指定卡槽SIM卡的服务提供商名称(Service Provider Name,SPN),使用Promise方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -267,18 +337,20 @@ promise.then(data => {
...
@@ -267,18 +337,20 @@ promise.then(data => {
```
```
## sim.getSimState
<a name=sim.getSimState-callback></a>
## sim.getSimState
getSimState
\(
slotId: number, callback: AsyncCallback<SimState
\>\)
: void
getSimState
\(
slotId: number, callback: AsyncCallback<SimState
\>\)
: void
获取指定卡槽的SIM卡状态,使用callback方式作为异步方法。
获取指定卡槽的SIM卡状态,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | -------------------------------------- |
| -------- | -------------------------------------- | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | AsyncCallback
\<
[
SimState
](
#
SimState
)
\>
| 是 | 回调函数。参考
[
SimState
](
#S
imState
)
。 |
| callback | AsyncCallback
\<
[
SimState
](
#
simState
)
\>
| 是 | 回调函数。参考
[
SimState
](
#s
imState
)
。 |
**示例:**
**示例:**
...
@@ -289,12 +361,14 @@ sim.getSimState(0, (err, data) => {
...
@@ -289,12 +361,14 @@ sim.getSimState(0, (err, data) => {
```
```
## sim.getSimState
<a name=sim.getSimState-promise></a>
## sim.getSimState
getSimState
\(
slotId: number
\)
: Promise<SimState
\>
getSimState
\(
slotId: number
\)
: Promise<SimState
\>
获取指定卡槽的SIM卡状态,使用Promise方式作为异步方法。
获取指定卡槽的SIM卡状态,使用Promise方式作为异步方法。
**系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -305,7 +379,7 @@ getSimState\(slotId: number\): Promise<SimState\>
...
@@ -305,7 +379,7 @@ getSimState\(slotId: number\): Promise<SimState\>
| 类型 | 说明 |
| 类型 | 说明 |
| -------------------------------- | ------------------------------------------ |
| -------------------------------- | ------------------------------------------ |
| Promise
\<
[
SimState
](
#
S
imState
)
\>
| 以Promise形式返回获取指定卡槽的SIM卡状态。 |
| Promise
\<
[
SimState
](
#
s
imState
)
\>
| 以Promise形式返回获取指定卡槽的SIM卡状态。 |
**示例:**
**示例:**
...
@@ -318,20 +392,20 @@ promise.then(data => {
...
@@ -318,20 +392,20 @@ promise.then(data => {
});
});
```
```
## sim.getCardType<
a name=sim.getCardType-callback></a
>
## sim.getCardType<
sup>7+</sup
>
getCardType
\(
slotId: number, callback: AsyncCallback<CardType
\>\)
: void
getCardType
\(
slotId: number, callback: AsyncCallback<CardType
\>\)
: void
获取指定卡槽SIM卡的卡类型,使用callback方式作为异步方法。
获取指定卡槽SIM卡的卡类型,使用callback方式作为异步方法。
**
需要权限**
:ohos.permission.GET_TELEPHONY_STATE
**
系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | -------------------------------------- |
| -------- | ----------------------- | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| slotId | number | 是 | 卡槽ID。
<br/>
- 0:卡槽1
<br/>
- 1:卡槽2 |
| callback | AsyncCallback
\<
[
CardType
](
#cardtype
)
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
[
CardType
](
#cardtype
7
)
\>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -342,13 +416,13 @@ sim.getCardType(0, (err, data) => {
...
@@ -342,13 +416,13 @@ sim.getCardType(0, (err, data) => {
```
```
## sim.getCardType<
a name=sim.getCardType-promise></a
>
## sim.getCardType<
sup>7+</sup
>
getCardType
\(
slotId: number
\)
: Promise<CardType
\>
getCardType
\(
slotId: number
\)
: Promise<CardType
\>
获取指定卡槽SIM卡的卡类型,使用Promise方式作为异步方法。
获取指定卡槽SIM卡的卡类型,使用Promise方式作为异步方法。
**
需要权限**
:ohos.permission.GET_TELEPHONY_STATE
**
系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
...
@@ -360,7 +434,7 @@ getCardType\(slotId: number\): Promise<CardType\>
...
@@ -360,7 +434,7 @@ getCardType\(slotId: number\): Promise<CardType\>
| 类型 | 说明 |
| 类型 | 说明 |
| ----------------- | ------------------------------------------------------------ |
| ----------------- | ------------------------------------------------------------ |
| Promise
\<
[
CardType
](
#cardtype
)
\>
| 以Promise形式返回指定卡槽SIM卡的卡类型。 |
| Promise
\<
[
CardType
](
#cardtype
7
)
\>
| 以Promise形式返回指定卡槽SIM卡的卡类型。 |
**示例:**
**示例:**
...
@@ -374,13 +448,13 @@ promise.then(data => {
...
@@ -374,13 +448,13 @@ promise.then(data => {
```
```
## sim.hasSimCard<
a name=sim.hasSimCard-callback></a
>
## sim.hasSimCard<
sup>7+</sup
>
hasSimCard
\(
slotId: number, callback: AsyncCallback<boolean
\>\)
: void
hasSimCard
\(
slotId: number, callback: AsyncCallback<boolean
\>\)
: void
获取指定卡槽SIM卡是否插卡,使用callback方式作为异步方法。
获取指定卡槽SIM卡是否插卡,使用callback方式作为异步方法。
**
需要权限**
:ohos.permission.GET_TELEPHONY_STATE
**
系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
...
@@ -398,13 +472,13 @@ sim.hasSimCard(0, (err, data) => {
...
@@ -398,13 +472,13 @@ sim.hasSimCard(0, (err, data) => {
```
```
## sim.hasSimCard<
a name=sim.hasSimCard-promise></a
>
## sim.hasSimCard<
sup>7+</sup
>
hasSimCard
\(
slotId: number
\)
: Promise<
string
\>
hasSimCard
\(
slotId: number
\)
: Promise<
boolean
\>
获取指定卡槽SIM卡是否插卡,使用Promise方式作为异步方法。
获取指定卡槽SIM卡是否插卡,使用Promise方式作为异步方法。
**
需要权限**
:ohos.permission.GET_TELEPHONY_STATE
**
系统能力:**
SystemCapability.Communication.CoreService
**参数:**
**参数:**
...
@@ -430,13 +504,13 @@ promise.then(data => {
...
@@ -430,13 +504,13 @@ promise.then(data => {
```
```
## sim.getMaxSimCount
## sim.getMaxSimCount
<sup>7+</sup>
getMaxSimCount
\(\)
: number
getMaxSimCount
\(\)
: number
获取卡槽数量。
获取卡槽数量。
**
需要权限**
:ohos.permission.GET_TELEPHONY_STATE
**
系统能力:**
SystemCapability.Communication.CoreService
**返回值:**
**返回值:**
...
@@ -451,32 +525,36 @@ console.log(sim.getMaxSimCount())
...
@@ -451,32 +525,36 @@ console.log(sim.getMaxSimCount())
```
```
## SimState
<a name=SimState></a>
## SimState
SIM卡状态。
SIM卡状态。
| 变量 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| --------------------- | ---------------------------------------------------------- |
| SIM_STATE_UNKNOWN | SIM卡状态未知,即无法获取准确的状态。 |
| SIM_STATE_NOT_PRESENT | 表示SIM卡处于not present状态,即卡槽中没有插入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卡在位且所有卡文件加载完毕。 |
## CardType
| 名称 | 值 | 说明 |
| --------------------- | ---- | ---------------------------------------------------------- |
| SIM_STATE_UNKNOWN | 0 | SIM卡状态未知,即无法获取准确的状态。 |
| SIM_STATE_NOT_PRESENT | 1 | 表示SIM卡处于not present状态,即卡槽中没有插入SIM卡。 |
| SIM_STATE_LOCKED | 2 | 表示SIM卡处于locked状态,即SIM卡被PIN、PUK或网络锁锁定。 |
| SIM_STATE_NOT_READY | 3 | 表示SIM卡处于not ready状态,即SIM卡在位但无法正常工作。 |
| SIM_STATE_READY | 4 | 表示SIM卡处于ready状态,即SIM卡在位且工作正常。 |
| SIM_STATE_LOADED | 5 | 表示SIM卡处于loaded状态,即SIM卡在位且所有卡文件加载完毕。 |
## CardType<sup>7+</sup>
卡类型。
卡类型。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
| 名称 | 值 | 说明 |
| ----- | ----- | ----- |
| ----- | ----- | ----- |
UNKNOWN_CARD | -1 | 未知类型 |
|UNKNOWN_CARD | -1 | 未知类型 |
SINGLE_MODE_SIM_CARD | 10 | 单SIM卡 |
|SINGLE_MODE_SIM_CARD | 10 | 单SIM卡 |
SINGLE_MODE_USIM_CARD | 20 | 单USIM卡 |
|SINGLE_MODE_USIM_CARD | 20 | 单USIM卡 |
SINGLE_MODE_RUIM_CARD | 30 | 单RUIM卡 |
|SINGLE_MODE_RUIM_CARD | 30 | 单RUIM卡 |
DUAL_MODE_CG_CARD | 40 | 双卡模式C+G |
|DUAL_MODE_CG_CARD | 40 | 双卡模式C+G |
CT_NATIONAL_ROAMING_CARD | 41 | 中国电信内部漫游卡 |
|CT_NATIONAL_ROAMING_CARD | 41 | 中国电信内部漫游卡 |
CU_DUAL_MODE_CARD | 42 | 中国联通双模卡 |
|CU_DUAL_MODE_CARD | 42 | 中国联通双模卡 |
DUAL_MODE_TELECOM_LTE_CARD | 43 | 双模式电信LTE卡 |
|DUAL_MODE_TELECOM_LTE_CARD | 43 | 双模式电信LTE卡 |
DUAL_MODE_UG_CARD | 50 | 双模式UG卡 |
|DUAL_MODE_UG_CARD | 50 | 双模式UG卡 |
SINGLE_MODE_ISIM_CARD | 60 | 单一ISIM卡类型 |
|SINGLE_MODE_ISIM_CARD | 60 | 单一ISIM卡类型 |
\ No newline at end of file
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-sms.md
浏览文件 @
b5160e59
...
@@ -10,7 +10,7 @@
...
@@ -10,7 +10,7 @@
import sms from '@ohos.telephony.sms';
import sms from '@ohos.telephony.sms';
```
```
## sms.createMessage
<a name=sms.createMessage-callback></a>
## sms.createMessage
createMessage
\(
pdu: Array<number
\>
, specification: string, callback: AsyncCallback<ShortMessage
\>\)
: void
createMessage
\(
pdu: Array<number
\>
, specification: string, callback: AsyncCallback<ShortMessage
\>\)
: void
...
@@ -24,7 +24,7 @@ createMessage\(pdu: Array<number\>, specification: string, callback: AsyncCallba
...
@@ -24,7 +24,7 @@ createMessage\(pdu: Array<number\>, specification: string, callback: AsyncCallba
| ------------- | -------------------------------------------------- | ---- | ------------------------------------------------------------ |
| ------------- | -------------------------------------------------- | ---- | ------------------------------------------------------------ |
| pdu | Array
<
number
>
| 是 | 协议数据单元,从收到的信息中获取。 |
| pdu | Array
<
number
>
| 是 | 协议数据单元,从收到的信息中获取。 |
| specification | string | 是 | 短信协议类型。
<br/>
- 3gpp表示GSM/UMTS/LTE SMS
<br/>
- 3gpp2表示CDMA SMS |
| specification | string | 是 | 短信协议类型。
<br/>
- 3gpp表示GSM/UMTS/LTE SMS
<br/>
- 3gpp2表示CDMA SMS |
| callback | AsyncCallback
<
[ShortMessage](#
ShortM
essage)
>
| 是 | 回调函数。 |
| callback | AsyncCallback
<
[ShortMessage](#
shortm
essage)
>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -38,7 +38,7 @@ sms.createMessage(pdu, specification, (err, data) => {
...
@@ -38,7 +38,7 @@ sms.createMessage(pdu, specification, (err, data) => {
```
```
## sms.createMessage
<a name=sms.createMessage-promise></a>
## sms.createMessage
createMessage
\(
pdu: Array<number
\>
, specification: string
\)
: Promise<ShortMessage
\>
createMessage
\(
pdu: Array<number
\>
, specification: string
\)
: Promise<ShortMessage
\>
...
@@ -57,7 +57,7 @@ createMessage\(pdu: Array<number\>, specification: string\): Promise<ShortMessag
...
@@ -57,7 +57,7 @@ createMessage\(pdu: Array<number\>, specification: string\): Promise<ShortMessag
| 类型 | 说明 |
| 类型 | 说明 |
| -------------------------------------------- | --------------------------------- |
| -------------------------------------------- | --------------------------------- |
| Promise
<
[ShortMessage](#
ShortM
essage)
>
| 以Promise形式返回创建的短信实例。 |
| Promise
<
[ShortMessage](#
shortm
essage)
>
| 以Promise形式返回创建的短信实例。 |
**示例:**
**示例:**
...
@@ -87,7 +87,7 @@ sendMessage(options: SendMessageOptions): void
...
@@ -87,7 +87,7 @@ sendMessage(options: SendMessageOptions): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------------------------------- | ---- | ------------------------------------------------------------ |
| ------- | ----------------------------------------- | ---- | ------------------------------------------------------------ |
| options |
[
SendMessageOptions
](
#
SendMessageOptions
)
| 是 | 发送短信的参数和回调,参考
[
SendMessageOptions
](
#SendMessageO
ptions
)
。 |
| options |
[
SendMessageOptions
](
#
sendmessageoptions
)
| 是 | 发送短信的参数和回调,参考
[
SendMessageOptions
](
#sendmessageo
ptions
)
。 |
**示例:**
**示例:**
...
@@ -108,7 +108,7 @@ sms.sendMessage(options);
...
@@ -108,7 +108,7 @@ sms.sendMessage(options);
```
```
## sms.getDefaultSmsSlotId<sup>7+</sup>
<a name=sms.getDefaultSmsSlotId-callback></a>
## sms.getDefaultSmsSlotId<sup>7+</sup>
getDefaultSmsSlotId
\(
callback: AsyncCallback<number
\>\)
: void
getDefaultSmsSlotId
\(
callback: AsyncCallback<number
\>\)
: void
...
@@ -131,7 +131,7 @@ sms.getDefaultSmsSlotId((err, data) => {
...
@@ -131,7 +131,7 @@ sms.getDefaultSmsSlotId((err, data) => {
```
```
## sms.getDefaultSmsSlotId<sup>7+</sup>
<a name=sms.getDefaultSmsSlotId-promise></a>
## sms.getDefaultSmsSlotId<sup>7+</sup>
getDefaultSmsSlotId
\(\)
: Promise<number
\>
getDefaultSmsSlotId
\(\)
: Promise<number
\>
...
@@ -157,7 +157,7 @@ promise.then(data => {
...
@@ -157,7 +157,7 @@ promise.then(data => {
```
```
## sms.setSmscAddr<sup>7+</sup>
<a name=sms.setSmscAddr-callback></a>
## sms.setSmscAddr<sup>7+</sup>
setSmscAddr
\(
slotId: number, smscAddr: string, callback: AsyncCallback<void
\>\)
: void
setSmscAddr
\(
slotId: number, smscAddr: string, callback: AsyncCallback<void
\>\)
: void
...
@@ -167,6 +167,8 @@ setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback<void\>\):
...
@@ -167,6 +167,8 @@ setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback<void\>\):
**系统能力**
:SystemCapability.Telephony.SmsMms
**系统能力**
:SystemCapability.Telephony.SmsMms
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -186,7 +188,7 @@ sms.setSmscAddr(slotId, smscAddr, (err,data) => {
...
@@ -186,7 +188,7 @@ sms.setSmscAddr(slotId, smscAddr, (err,data) => {
```
```
## sms.setSmscAddr<sup>7+</sup>
<a name=sms.setSmscAddr-promise></a>
## sms.setSmscAddr<sup>7+</sup>
setSmscAddr
\(
slotId: number, smscAddr: string
\)
: Promise<void
\>
setSmscAddr
\(
slotId: number, smscAddr: string
\)
: Promise<void
\>
...
@@ -196,6 +198,8 @@ setSmscAddr\(slotId: number, smscAddr: string\): Promise<void\>
...
@@ -196,6 +198,8 @@ setSmscAddr\(slotId: number, smscAddr: string\): Promise<void\>
**系统能力**
:SystemCapability.Telephony.SmsMms
**系统能力**
:SystemCapability.Telephony.SmsMms
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -223,7 +227,7 @@ promise.then(data => {
...
@@ -223,7 +227,7 @@ promise.then(data => {
```
```
## sms.getSmscAddr<sup>7+</sup>
<a name=sms.getSmscAddr-callback></a>
## sms.getSmscAddr<sup>7+</sup>
getSmscAddr
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
getSmscAddr
\(
slotId: number, callback: AsyncCallback<string
\>\)
: void
...
@@ -233,7 +237,7 @@ getSmscAddr\(slotId: number, callback: AsyncCallback<string\>\): void
...
@@ -233,7 +237,7 @@ getSmscAddr\(slotId: number, callback: AsyncCallback<string\>\): void
**系统能力**
:SystemCapability.Telephony.SmsMms
**系统能力**
:SystemCapability.Telephony.SmsMms
**
补充说明**
:该接口为systemapi,仅供系统应用使用
**
系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
**参数:**
...
@@ -252,7 +256,7 @@ sms.getSmscAddr(slotId, (err, data) => {
...
@@ -252,7 +256,7 @@ sms.getSmscAddr(slotId, (err, data) => {
```
```
## sms.getSmscAddr<sup>7+</sup>
<a name=sms.getSmscAddr-promise></a>
## sms.getSmscAddr<sup>7+</sup>
getSmscAddr
\(
slotId: number
\)
: Promise<string
\>
getSmscAddr
\(
slotId: number
\)
: Promise<string
\>
...
@@ -262,7 +266,7 @@ getSmscAddr\(slotId: number\): Promise<string\>
...
@@ -262,7 +266,7 @@ getSmscAddr\(slotId: number\): Promise<string\>
**系统能力**
:SystemCapability.Telephony.SmsMms
**系统能力**
:SystemCapability.Telephony.SmsMms
**
补充说明**
:该接口为systemapi,仅供系统应用使用
**
系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
**参数:**
...
@@ -288,7 +292,7 @@ promise.then(data => {
...
@@ -288,7 +292,7 @@ promise.then(data => {
});
});
```
```
## sms.hasSmsCapability<sup>7+</sup>
<a name=sms.hasSmsCapability></a>
## sms.hasSmsCapability<sup>7+</sup>
hasSmsCapability(): boolean
hasSmsCapability(): boolean
...
@@ -307,18 +311,18 @@ let result = sms.hasSmsCapability();
...
@@ -307,18 +311,18 @@ let result = sms.hasSmsCapability();
console.log(`hasSmsCapability: ${JSON.stringify(result)}`);
console.log(`hasSmsCapability: ${JSON.stringify(result)}`);
```
```
## ShortMessage
<a name=ShortMessage></a>
## ShortMessage
短信实例。
短信实例。
**系统能力**
:
SystemCapability.Telephony.SmsMms
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。
|
变量
| 类型 | 说明 |
|
参数名
| 类型 | 说明 |
| ------------------------ | --------------------------------------- | ------------------------------------------------------------ |
| ------------------------ | --------------------------------------- | ------------------------------------------------------------ |
| hasReplyPath | boolean | 收到的短信是否包含“TP-Reply-Path”,默认为false。
<br/>
“TP-Reply-Path”:移动电话根据发送SMS消息的短消息中心进行回复。 |
| hasReplyPath | boolean | 收到的短信是否包含“TP-Reply-Path”,默认为false。
<br/>
“TP-Reply-Path”:移动电话根据发送SMS消息的短消息中心进行回复。 |
| isReplaceMessage | boolean | 收到的短信是否为“替换短信”,默认为false。
<br/>
“替换短信”有关详细信息,参见 “3GPP TS 23.040 9.2.3.9”。 |
| isReplaceMessage | boolean | 收到的短信是否为“替换短信”,默认为false。
<br/>
“替换短信”有关详细信息,参见 “3GPP TS 23.040 9.2.3.9”。 |
| isSmsStatusReportMessage | boolean | 当前消息是否为“短信状态报告”,默认为false。
<br/>
“短信状态报告”是一种特定格式的短信,被用来从Service Center到Mobile Station传送状态报告。 |
| isSmsStatusReportMessage | boolean | 当前消息是否为“短信状态报告”,默认为false。
<br/>
“短信状态报告”是一种特定格式的短信,被用来从Service Center到Mobile Station传送状态报告。 |
| messageClass |
[
ShortMessageClass
](
#
ShortMessageC
lass
)
| 短信类型。 |
| messageClass |
[
ShortMessageClass
](
#
shortmessagec
lass
)
| 短信类型。 |
| pdu | Array
<
number
>
| SMS消息中的协议数据单元 (PDU)。 |
| pdu | Array
<
number
>
| SMS消息中的协议数据单元 (PDU)。 |
| protocolId | number | 发送短信时使用的协议标识。 |
| protocolId | number | 发送短信时使用的协议标识。 |
| scAddress | string | 短消息服务中心(SMSC)地址。 |
| scAddress | string | 短消息服务中心(SMSC)地址。 |
...
@@ -328,26 +332,26 @@ console.log(`hasSmsCapability: ${JSON.stringify(result)}`);
...
@@ -328,26 +332,26 @@ console.log(`hasSmsCapability: ${JSON.stringify(result)}`);
| visibleRawAddress | string | 发送者地址。 |
| visibleRawAddress | string | 发送者地址。 |
## ShortMessageClass
<a name=ShortMessageClass></a>
## ShortMessageClass
短信类型。
短信类型。
| 变量 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。
| ---------------- | ---- | ------------------------------------------------------------ |
| UNKNOWN | 0 | 未知类型。
<br
/>
**系统能力**
:SystemCapability.Telephony.SmsMms |
| INSTANT_MESSAGE | 1 | 即时消息,收到后立即显示。
<br
/>
**系统能力**
:SystemCapability.Telephony.SmsMms |
| OPTIONAL_MESSAGE | 2 | 存储在设备或SIM卡上的短信。
<br
/>
**系统能力**
:SystemCapability.Telephony.SmsMms |
| SIM_MESSAGE | 3 | 包含SIM卡信息的短信,需要存储在SIM卡中。
<br
/>
**系统能力**
:SystemCapability.Telephony.SmsMms |
| FORWARD_MESSAGE | 4 | 要转发到另一台设备的短信。
<br
/>
**系统能力**
:SystemCapability.Telephony.SmsMms |
| 名称 | 值 | 说明 |
| ---------------- | ---- | ---------------------------------------- |
| UNKNOWN | 0 | 未知类型。 |
| INSTANT_MESSAGE | 1 | 即时消息,收到后立即显示。 |
| OPTIONAL_MESSAGE | 2 | 存储在设备或SIM卡上的短信。 |
| SIM_MESSAGE | 3 | 包含SIM卡信息的短信,需要存储在SIM卡中。 |
| FORWARD_MESSAGE | 4 | 要转发到另一台设备的短信。 |
## SendMessageOptions<a name=SendMessageOptions></a>
发送短信的参数和回调。
## SendMessageOptions
根据SendMessageOptions中的可选参数content的值判断短信类型。
发送短信的参数和回调。
根据SendMessageOptions中的可选参数content的值判断短信类型。
**系统能力**
:
SystemCapability.Telephony.SmsMms
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| ---------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
...
@@ -356,41 +360,41 @@ console.log(`hasSmsCapability: ${JSON.stringify(result)}`);
...
@@ -356,41 +360,41 @@ console.log(`hasSmsCapability: ${JSON.stringify(result)}`);
| content | string
\|
Array
<
number
>
| 是 | 如果内容是字符串,则这是一条文本短信。如果内容是字节数组,则这是一条数据短信。 |
| content | string
\|
Array
<
number
>
| 是 | 如果内容是字符串,则这是一条文本短信。如果内容是字节数组,则这是一条数据短信。 |
| serviceCenter | string | 否 | 短信中心地址。默认使用SIM卡中的短信中心地址。 |
| serviceCenter | string | 否 | 短信中心地址。默认使用SIM卡中的短信中心地址。 |
| destinationPort | number | 否 | 如果发送数据消息,destinationPort 是必需的。否则是可选的。 |
| destinationPort | number | 否 | 如果发送数据消息,destinationPort 是必需的。否则是可选的。 |
| sendCallback | AsyncCallback
<
[ISendShortMessageCallback](#
ISendShortMessageCallback)
>
| 否 | 短信发送结果回调,返回短信发送的结果,参考
[
ISendShortMessageCallback
](
#ISendShortMessageC
allback
)
。 |
| sendCallback | AsyncCallback
<
[ISendShortMessageCallback](#
isendshortmessagecallback)
>
| 否 | 短信发送结果回调,返回短信发送的结果,参考
[
ISendShortMessageCallback
](
#isendshortmessagec
allback
)
。 |
| deliveryCallback | AsyncCallback
<
[IDeliveryShortMessageCallback](#
IDeliveryShortMessageCallback)
>
| 否 | 短信送达结果回调,返回短信递送报告,参考
[
IDeliveryShortMessageCallback
](
#IDeliveryShortMessageC
allback
)
。 |
| deliveryCallback | AsyncCallback
<
[IDeliveryShortMessageCallback](#
ideliveryshortmessagecallback)
>
| 否 | 短信送达结果回调,返回短信递送报告,参考
[
IDeliveryShortMessageCallback
](
#ideliveryshortmessagec
allback
)
。 |
## ISendShortMessageCallback
<a name=ISendShortMessageCallback></a>
## ISendShortMessageCallback
回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。
回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。
**系统能力**
:
SystemCapability.Telephony.SmsMms
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------- | ---- | ------------------------------------------------------------ |
| ---------- | ------------------------------- | ---- | ------------------------------------------------------------ |
| isLastPart | boolean | 否 | 指定这是否是长短信的最后一部分。true表示这是长短信的最后一部分,false表示不是。默认为false。 |
| isLastPart | boolean | 否 | 指定这是否是长短信的最后一部分。true表示这是长短信的最后一部分,false表示不是。默认为false。 |
| result |
[
SendSmsResult
](
#
SendSmsR
esult
)
| 是 | 短信发送结果。 |
| result |
[
SendSmsResult
](
#
sendsmsr
esult
)
| 是 | 短信发送结果。 |
| url | string | 是 | 存储发送短信的URI。 |
| url | string | 是 | 存储发送短信的URI。 |
## IDeliveryShortMessageCallback
<a name=IDeliveryShortMessageCallback></a>
## IDeliveryShortMessageCallback
回调实例。返回短信送达报告。
回调实例。返回短信送达报告。
**系统能力**
:
SystemCapability.Telephony.SmsMms
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------- | ---- | -------------- |
| ------ | ------------------- | ---- | -------------- |
| pdu | Array
<
number
>
| 是 | 短信送达报告。 |
| pdu | Array
<
number
>
| 是 | 短信送达报告。 |
## SendSmsResult
<a name=SendSmsResult></a>
## SendSmsResult
短信发送结果。
短信发送结果。
**系统能力**
:
SystemCapability.Telephony.SmsMms
**系统能力**
:
以下各项对应的系统能力均为SystemCapability.Telephony.SmsMms。
|
参数名
| 值 | 说明 |
|
名称
| 值 | 说明 |
| ------------------------------------ | ---- | ------------------------------------------------------ |
| ------------------------------------ | ---- | ------------------------------------------------------ |
| SEND_SMS_SUCCESS | 0 | 发送短信成功。 |
| SEND_SMS_SUCCESS | 0 | 发送短信成功。 |
| SEND_SMS_FAILURE_UNKNOWN | 1 | 发送短信失败,原因未知。 |
| SEND_SMS_FAILURE_UNKNOWN | 1 | 发送短信失败,原因未知。 |
...
...
zh-cn/application-dev/reference/apis/js-apis-socket.md
浏览文件 @
b5160e59
...
@@ -4,7 +4,6 @@
...
@@ -4,7 +4,6 @@
>
>
>本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
>
>本模块所有接口需要设备具有系统能力:SystemCapability.Communication.NetStack
## 导入模块
## 导入模块
...
@@ -12,16 +11,14 @@
...
@@ -12,16 +11,14 @@
import socket from '@ohos.net.socket';
import socket from '@ohos.net.socket';
```
```
## 权限列表
ohos.permission.INTERNET
## socket.constructUDPSocketInstance
## socket.constructUDPSocketInstance
constructUDPSocketInstance
\(\)
: UDPSocket
constructUDPSocketInstance
\(\)
: UDPSocket
创建一个UDPSocket对象。
创建一个UDPSocket对象。
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -48,6 +45,8 @@ bind\(address: NetAddress, callback: AsyncCallback<void\>\): void
...
@@ -48,6 +45,8 @@ bind\(address: NetAddress, callback: AsyncCallback<void\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -77,6 +76,8 @@ bind\(address: NetAddress\): Promise<void\>
...
@@ -77,6 +76,8 @@ bind\(address: NetAddress\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -111,6 +112,8 @@ send\(options: UDPSendOptions, callback: AsyncCallback<void\>\): void
...
@@ -111,6 +112,8 @@ send\(options: UDPSendOptions, callback: AsyncCallback<void\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -147,6 +150,8 @@ send\(options: UDPSendOptions\): Promise<void\>
...
@@ -147,6 +150,8 @@ send\(options: UDPSendOptions\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -187,6 +192,8 @@ close\(callback: AsyncCallback<void\>\): void
...
@@ -187,6 +192,8 @@ close\(callback: AsyncCallback<void\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -215,6 +222,8 @@ close\(\): Promise<void\>
...
@@ -215,6 +222,8 @@ close\(\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -245,6 +254,8 @@ getState\(callback: AsyncCallback<SocketStateBase\>\): void
...
@@ -245,6 +254,8 @@ getState\(callback: AsyncCallback<SocketStateBase\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -283,6 +294,8 @@ getState\(\): Promise<SocketStateBase\>
...
@@ -283,6 +294,8 @@ getState\(\): Promise<SocketStateBase\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -320,6 +333,8 @@ setExtraOptions\(options: UDPExtraOptions, callback: AsyncCallback<void\>\): voi
...
@@ -320,6 +333,8 @@ setExtraOptions\(options: UDPExtraOptions, callback: AsyncCallback<void\>\): voi
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -366,6 +381,8 @@ setExtraOptions\(options: UDPExtraOptions\): Promise<void\>
...
@@ -366,6 +381,8 @@ setExtraOptions\(options: UDPExtraOptions\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -409,6 +426,8 @@ on\(type: 'message', callback: Callback<\{message: ArrayBuffer, remoteInfo: Sock
...
@@ -409,6 +426,8 @@ on\(type: 'message', callback: Callback<\{message: ArrayBuffer, remoteInfo: Sock
订阅UDPSocket连接的接收消息事件。使用callback方式作为异步方法。
订阅UDPSocket连接的接收消息事件。使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -421,7 +440,7 @@ on\(type: 'message', callback: Callback<\{message: ArrayBuffer, remoteInfo: Sock
...
@@ -421,7 +440,7 @@ on\(type: 'message', callback: Callback<\{message: ArrayBuffer, remoteInfo: Sock
```
```
let udp = socket.constructUDPSocketInstance();
let udp = socket.constructUDPSocketInstance();
udp.on('message', value => {
udp.on('message', value => {
console.log("on message, message:" + value.message
)
+ ", remoteInfo:" + value.remoteInfo);
console.log("on message, message:" + value.message + ", remoteInfo:" + value.remoteInfo);
});
});
```
```
...
@@ -435,6 +454,8 @@ off\(type: 'message', callback?: Callback<\{message: ArrayBuffer, remoteInfo: So
...
@@ -435,6 +454,8 @@ off\(type: 'message', callback?: Callback<\{message: ArrayBuffer, remoteInfo: So
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -447,7 +468,7 @@ off\(type: 'message', callback?: Callback<\{message: ArrayBuffer, remoteInfo: So
...
@@ -447,7 +468,7 @@ off\(type: 'message', callback?: Callback<\{message: ArrayBuffer, remoteInfo: So
```
```
let udp = socket.constructUDPSocketInstance();
let udp = socket.constructUDPSocketInstance();
let callback = value =>{
let callback = value =>{
console.log("on message, message:" + value.message
)
+ ", remoteInfo:" + value.remoteInfo);
console.log("on message, message:" + value.message + ", remoteInfo:" + value.remoteInfo);
}
}
udp.on('message', callback);
udp.on('message', callback);
// 可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
// 可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
...
@@ -462,6 +483,8 @@ on\(type: 'listening' | 'close', callback: Callback<void\>\): void
...
@@ -462,6 +483,8 @@ on\(type: 'listening' | 'close', callback: Callback<void\>\): void
订阅UDPSocket连接的数据包消息事件或关闭事件。使用callback方式作为异步方法。
订阅UDPSocket连接的数据包消息事件或关闭事件。使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -474,7 +497,7 @@ on\(type: 'listening' | 'close', callback: Callback<void\>\): void
...
@@ -474,7 +497,7 @@ on\(type: 'listening' | 'close', callback: Callback<void\>\): void
```
```
let udp = socket.constructUDPSocketInstance();
let udp = socket.constructUDPSocketInstance();
udp.on('listening', () => {
udp.on('listening', () => {
console.log("on listening success")
)
;
console.log("on listening success");
});
});
udp.on('close', () => {
udp.on('close', () => {
console.log("on close success" );
console.log("on close success" );
...
@@ -491,6 +514,8 @@ off\(type: 'listening' | 'close', callback?: Callback<void\>\): void
...
@@ -491,6 +514,8 @@ off\(type: 'listening' | 'close', callback?: Callback<void\>\): void
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -525,6 +550,8 @@ on\(type: 'error', callback: ErrorCallback\): void
...
@@ -525,6 +550,8 @@ on\(type: 'error', callback: ErrorCallback\): void
订阅UDPSocket连接的error事件。使用callback方式作为异步方法。
订阅UDPSocket连接的error事件。使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -552,6 +579,8 @@ off\(type: 'error', callback?: ErrorCallback\): void
...
@@ -552,6 +579,8 @@ off\(type: 'error', callback?: ErrorCallback\): void
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -577,6 +606,8 @@ udp.off('error');
...
@@ -577,6 +606,8 @@ udp.off('error');
目标地址信息。
目标地址信息。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------------------------------------------------------ |
| ------- | ------ | ---- | ------------------------------------------------------------ |
| address | string | 是 | 本地绑定的ip地址。 |
| address | string | 是 | 本地绑定的ip地址。 |
...
@@ -587,6 +618,8 @@ udp.off('error');
...
@@ -587,6 +618,8 @@ udp.off('error');
UDPSocket发送参数。
UDPSocket发送参数。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------- | ---- | -------------- |
| ------- | ---------------------------------- | ---- | -------------- |
| data | string | 是 | 发送的数据。 |
| data | string | 是 | 发送的数据。 |
...
@@ -596,6 +629,8 @@ UDPSocket发送参数。
...
@@ -596,6 +629,8 @@ UDPSocket发送参数。
UDPSocket连接的其他属性。
UDPSocket连接的其他属性。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------------- | ------- | ---- | -------------------------------- |
| ----------------- | ------- | ---- | -------------------------------- |
| broadcast | boolean | 否 | 是否可以发送广播。默认为false。 |
| broadcast | boolean | 否 | 是否可以发送广播。默认为false。 |
...
@@ -608,6 +643,8 @@ UDPSocket连接的其他属性。
...
@@ -608,6 +643,8 @@ UDPSocket连接的其他属性。
Socket的状态信息。
Socket的状态信息。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------- | ---- | ---------- |
| ----------- | ------- | ---- | ---------- |
| isBound | boolean | 是 | 是否绑定。 |
| isBound | boolean | 是 | 是否绑定。 |
...
@@ -618,6 +655,8 @@ Socket的状态信息。
...
@@ -618,6 +655,8 @@ Socket的状态信息。
Socket的连接信息。
Socket的连接信息。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------------------------------------------------------ |
| ------- | ------ | ---- | ------------------------------------------------------------ |
| address | string | 是 | 本地绑定的ip地址。 |
| address | string | 是 | 本地绑定的ip地址。 |
...
@@ -631,6 +670,8 @@ constructTCPSocketInstance\(\): TCPSocket
...
@@ -631,6 +670,8 @@ constructTCPSocketInstance\(\): TCPSocket
创建一个TCPSocket对象。
创建一个TCPSocket对象。
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -656,6 +697,8 @@ bind\(address: NetAddress, callback: AsyncCallback<void\>\): void
...
@@ -656,6 +697,8 @@ bind\(address: NetAddress, callback: AsyncCallback<void\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -680,12 +723,14 @@ tcp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
...
@@ -680,12 +723,14 @@ tcp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
### bind
### bind
bind
\(
address NetAddress
\)
: Promise<void
\>
bind
\(
address
:
NetAddress
\)
: Promise<void
\>
绑定IP地址和端口,端口可以指定或由系统随机分配。使用Promise方法作为异步方法。
绑定IP地址和端口,端口可以指定或由系统随机分配。使用Promise方法作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -719,6 +764,8 @@ connect\(options: TCPConnectOptions, callback: AsyncCallback<void\>\): void
...
@@ -719,6 +764,8 @@ connect\(options: TCPConnectOptions, callback: AsyncCallback<void\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -748,6 +795,8 @@ connect\(options: TCPConnectOptions\): Promise<void\>
...
@@ -748,6 +795,8 @@ connect\(options: TCPConnectOptions\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -784,6 +833,8 @@ send\(options: TCPSendOptions, callback: AsyncCallback<void\>\): void
...
@@ -784,6 +833,8 @@ send\(options: TCPSendOptions, callback: AsyncCallback<void\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -824,6 +875,8 @@ send\(options: TCPSendOptions\): Promise<void\>
...
@@ -824,6 +875,8 @@ send\(options: TCPSendOptions\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -865,6 +918,8 @@ close\(callback: AsyncCallback<void\>\): void
...
@@ -865,6 +918,8 @@ close\(callback: AsyncCallback<void\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -894,6 +949,8 @@ close\(\): Promise<void\>
...
@@ -894,6 +949,8 @@ close\(\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -924,6 +981,8 @@ getRemoteAddress\(callback: AsyncCallback<NetAddress\>\): void
...
@@ -924,6 +981,8 @@ getRemoteAddress\(callback: AsyncCallback<NetAddress\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -961,6 +1020,8 @@ getRemoteAddress\(\): Promise<NetAddress\>
...
@@ -961,6 +1020,8 @@ getRemoteAddress\(\): Promise<NetAddress\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -997,6 +1058,8 @@ getState\(callback: AsyncCallback<SocketStateBase\>\): void
...
@@ -997,6 +1058,8 @@ getState\(callback: AsyncCallback<SocketStateBase\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1035,6 +1098,8 @@ getState\(\): Promise<SocketStateBase\>
...
@@ -1035,6 +1098,8 @@ getState\(\): Promise<SocketStateBase\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -1072,6 +1137,8 @@ setExtraOptions\(options: TCPExtraOptions, callback: AsyncCallback<void\>\): voi
...
@@ -1072,6 +1137,8 @@ setExtraOptions\(options: TCPExtraOptions, callback: AsyncCallback<void\>\): voi
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1090,7 +1157,7 @@ promise.then(() => {
...
@@ -1090,7 +1157,7 @@ promise.then(() => {
keepAlive: true,
keepAlive: true,
OOBInline: true,
OOBInline: true,
TCPNoDelay: true,
TCPNoDelay: true,
socketLinger: { on:true, linger:10 }
socketLinger: { on:true, linger:10 }
,
receiveBufferSize: 1000,
receiveBufferSize: 1000,
sendBufferSize: 1000,
sendBufferSize: 1000,
reuseAddress: true,
reuseAddress: true,
...
@@ -1119,6 +1186,8 @@ setExtraOptions\(options: TCPExtraOptions\): Promise<void\>
...
@@ -1119,6 +1186,8 @@ setExtraOptions\(options: TCPExtraOptions\): Promise<void\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1143,7 +1212,7 @@ promise.then(() => {
...
@@ -1143,7 +1212,7 @@ promise.then(() => {
keepAlive: true,
keepAlive: true,
OOBInline: true,
OOBInline: true,
TCPNoDelay: true,
TCPNoDelay: true,
socketLinger: { on:true, linger:10 }
socketLinger: { on:true, linger:10 }
,
receiveBufferSize: 1000,
receiveBufferSize: 1000,
sendBufferSize: 1000,
sendBufferSize: 1000,
reuseAddress: true,
reuseAddress: true,
...
@@ -1166,6 +1235,8 @@ on\(type: 'message', callback: Callback<\{message: ArrayBuffer, remoteInfo: Sock
...
@@ -1166,6 +1235,8 @@ on\(type: 'message', callback: Callback<\{message: ArrayBuffer, remoteInfo: Sock
订阅TCPSocket连接的接收消息事件。使用callback方式作为异步方法。
订阅TCPSocket连接的接收消息事件。使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1192,6 +1263,8 @@ off\(type: 'message', callback?: Callback<\{message: ArrayBuffer, remoteInfo: So
...
@@ -1192,6 +1263,8 @@ off\(type: 'message', callback?: Callback<\{message: ArrayBuffer, remoteInfo: So
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1219,6 +1292,8 @@ on\(type: 'connect' | 'close', callback: Callback<void\>\): void
...
@@ -1219,6 +1292,8 @@ on\(type: 'connect' | 'close', callback: Callback<void\>\): void
订阅TCPSocket的连接事件或关闭事件。使用callback方式作为异步方法。
订阅TCPSocket的连接事件或关闭事件。使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1242,13 +1317,15 @@ tcp.on('close', data => {
...
@@ -1242,13 +1317,15 @@ tcp.on('close', data => {
### off\('connect' | 'close'\)
### off\('connect' | 'close'\)
off
\(
type: 'connect' | 'close', callback: Callback<void
\>\)
: void
off
\(
type: 'connect' | 'close', callback
?
: Callback<void
\>\)
: void
取消订阅TCPSocket的连接事件或关闭事件。使用callback方式作为异步方法。
取消订阅TCPSocket的连接事件或关闭事件。使用callback方式作为异步方法。
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1283,6 +1360,8 @@ on\(type: 'error', callback: ErrorCallback\): void
...
@@ -1283,6 +1360,8 @@ on\(type: 'error', callback: ErrorCallback\): void
订阅TCPSocket连接的error事件。使用callback方式作为异步方法。
订阅TCPSocket连接的error事件。使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1309,6 +1388,8 @@ off\(type: 'error', callback?: ErrorCallback\): void
...
@@ -1309,6 +1388,8 @@ off\(type: 'error', callback?: ErrorCallback\): void
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -1334,6 +1415,8 @@ tcp.off('error');
...
@@ -1334,6 +1415,8 @@ tcp.off('error');
TCPSocket连接的参数。
TCPSocket连接的参数。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------- | ---- | -------------------------- |
| ------- | ---------------------------------- | ---- | -------------------------- |
| address |
[
NetAddress
](
#netaddress
)
| 是 | 绑定的地址以及端口。 |
| address |
[
NetAddress
](
#netaddress
)
| 是 | 绑定的地址以及端口。 |
...
@@ -1343,6 +1426,8 @@ TCPSocket连接的参数。
...
@@ -1343,6 +1426,8 @@ TCPSocket连接的参数。
TCPSocket发送请求的参数。
TCPSocket发送请求的参数。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ------------------------------------------------------------ |
| -------- | ------ | ---- | ------------------------------------------------------------ |
| data | string | 是 | 发送的数据。 |
| data | string | 是 | 发送的数据。 |
...
@@ -1352,6 +1437,8 @@ TCPSocket发送请求的参数。
...
@@ -1352,6 +1437,8 @@ TCPSocket发送请求的参数。
TCPSocket连接的其他属性。
TCPSocket连接的其他属性。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------------- | ------- | ---- | ------------------------------------------------------------ |
| ----------------- | ------- | ---- | ------------------------------------------------------------ |
| keepAlive | boolean | 否 | 是否保持连接。默认为false。 |
| keepAlive | boolean | 否 | 是否保持连接。默认为false。 |
...
...
zh-cn/application-dev/reference/apis/js-apis-telephony-data.md
浏览文件 @
b5160e59
...
@@ -10,7 +10,7 @@
...
@@ -10,7 +10,7 @@
import data from '@ohos.telephony.data';
import data from '@ohos.telephony.data';
```
```
## data.getDefaultCellularDataSlotId
<a name=data.getDefaultCellularDataSlotId-callback></a>
## data.getDefaultCellularDataSlotId
getDefaultCellularDataSlotId(callback: AsyncCallback
\<
number
\>
): void
getDefaultCellularDataSlotId(callback: AsyncCallback
\<
number
\>
): void
...
@@ -34,7 +34,7 @@ data.getDefaultCellularDataSlotId((err, data) => {
...
@@ -34,7 +34,7 @@ data.getDefaultCellularDataSlotId((err, data) => {
});
});
```
```
## data.getDefaultCellularDataSlotId
<a name=data.getDefaultCellularDataSlotId-promise></a>
## data.getDefaultCellularDataSlotId
getDefaultCellularDataSlotId(): Promise
\<
number
\>
getDefaultCellularDataSlotId(): Promise
\<
number
\>
...
@@ -61,7 +61,7 @@ promise.then((data) => {
...
@@ -61,7 +61,7 @@ promise.then((data) => {
});
});
```
```
## data.getCellularDataFlowType
<a name=data.getCellularDataFlowType-callback></a>
## data.getCellularDataFlowType
getCellularDataFlowType(callback: AsyncCallback
\<
DataFlowType
\>
): void
getCellularDataFlowType(callback: AsyncCallback
\<
DataFlowType
\>
): void
...
@@ -73,7 +73,7 @@ getCellularDataFlowType(callback: AsyncCallback\<DataFlowType\>): void
...
@@ -73,7 +73,7 @@ getCellularDataFlowType(callback: AsyncCallback\<DataFlowType\>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------------- | ---- | ---------- |
| -------- | ---------------------------------------------- | ---- | ---------- |
| callback | AsyncCallback
\<
[
DataFlowType
](
#
DataFlowT
ype
)
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
[
DataFlowType
](
#
dataflowt
ype
)
\>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -83,7 +83,7 @@ data.getCellularDataFlowType((err, data) => {
...
@@ -83,7 +83,7 @@ data.getCellularDataFlowType((err, data) => {
});
});
```
```
## data.getCellularDataFlowType
<a name=data.getCellularDataFlowType-promise></a>
## data.getCellularDataFlowType
getCellularDataFlowType(): Promise
\<
DataFlowType
\>
getCellularDataFlowType(): Promise
\<
DataFlowType
\>
...
@@ -95,7 +95,7 @@ getCellularDataFlowType(): Promise\<DataFlowType\>
...
@@ -95,7 +95,7 @@ getCellularDataFlowType(): Promise\<DataFlowType\>
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------------------------- | ----------------------------------------------- |
| ---------------------------------------- | ----------------------------------------------- |
| Promise
\<
[
DataFlowType
](
#
DataFlowT
ype
)
\>
| 以Promise形式返回获取蜂窝数据业务的上下行状态。 |
| Promise
\<
[
DataFlowType
](
#
dataflowt
ype
)
\>
| 以Promise形式返回获取蜂窝数据业务的上下行状态。 |
**示例:**
**示例:**
...
@@ -108,7 +108,7 @@ promise.then((data) => {
...
@@ -108,7 +108,7 @@ promise.then((data) => {
});
});
```
```
## data.getCellularDataState
<a name=data.getCellularDataState-callback></a>
## data.getCellularDataState
getCellularDataState(callback: AsyncCallback
\<
DataConnectState
\>
): void
getCellularDataState(callback: AsyncCallback
\<
DataConnectState
\>
): void
...
@@ -120,7 +120,7 @@ getCellularDataState(callback: AsyncCallback\<DataConnectState\>): void
...
@@ -120,7 +120,7 @@ getCellularDataState(callback: AsyncCallback\<DataConnectState\>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------ | ---- | ---------- |
| -------- | ------------------------------------------------------ | ---- | ---------- |
| callback | AsyncCallback
\<
[
DataConnectState
](
#
DataConnectS
tate
)
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
[
DataConnectState
](
#
dataconnects
tate
)
\>
| 是 | 回调函数。 |
**示例:**
**示例:**
...
@@ -130,7 +130,7 @@ data.getCellularDataState((err, data) => {
...
@@ -130,7 +130,7 @@ data.getCellularDataState((err, data) => {
});
});
```
```
## data.getCellularDataState
<a name=data.getCellularDataState-promise></a>
## data.getCellularDataState
getCellularDataState(): Promise
\<
DataConnectState
\>
getCellularDataState(): Promise
\<
DataConnectState
\>
...
@@ -142,7 +142,7 @@ getCellularDataState(): Promise\<DataConnectState\>
...
@@ -142,7 +142,7 @@ getCellularDataState(): Promise\<DataConnectState\>
| 类型 | 说明 |
| 类型 | 说明 |
| ------------------------------------------------ | ------------------------------------- |
| ------------------------------------------------ | ------------------------------------- |
| Promise
\<
[
DataConnectState
](
#
DataConnectS
tate
)
\>
| 以Promise形式返回获取PS域的连接状态。 |
| Promise
\<
[
DataConnectState
](
#
dataconnects
tate
)
\>
| 以Promise形式返回获取PS域的连接状态。 |
**示例:**
**示例:**
...
@@ -155,7 +155,7 @@ promise.then((data) => {
...
@@ -155,7 +155,7 @@ promise.then((data) => {
});
});
```
```
## data.isCellularDataEnabled
<a name=data.isCellularDataEnabled-callback></a>
## data.isCellularDataEnabled
isCellularDataEnabled(callback: AsyncCallback
\<
boolean
\>
): void
isCellularDataEnabled(callback: AsyncCallback
\<
boolean
\>
): void
...
@@ -179,7 +179,7 @@ data.isCellularDataEnabled((err, data) => {
...
@@ -179,7 +179,7 @@ data.isCellularDataEnabled((err, data) => {
});
});
```
```
## data.isCellularDataEnabled
<a name=data.isCellularDataEnabled-promise></a>
## data.isCellularDataEnabled
isCellularDataEnabled(): Promise
\<
boolean
\>
isCellularDataEnabled(): Promise
\<
boolean
\>
...
@@ -206,7 +206,7 @@ promise.then((data) => {
...
@@ -206,7 +206,7 @@ promise.then((data) => {
});
});
```
```
## data.isCellularDataRoamingEnabled
<a name=data.isCellularDataRoamingEnabled-callback></a>
## data.isCellularDataRoamingEnabled
isCellularDataRoamingEnabled(slotId: number, callback: AsyncCallback
\<
boolean
\>
): void
isCellularDataRoamingEnabled(slotId: number, callback: AsyncCallback
\<
boolean
\>
): void
...
@@ -231,7 +231,7 @@ data.isCellularDataRoamingEnabled(0,(err, data) => {
...
@@ -231,7 +231,7 @@ data.isCellularDataRoamingEnabled(0,(err, data) => {
});
});
```
```
## data.isCellularDataRoamingEnabled
<a name=data.isCellularDataRoamingEnabled-promise></a>
## data.isCellularDataRoamingEnabled
isCellularDataRoamingEnabled(slotId: number): Promise
\<
boolean
\>
isCellularDataRoamingEnabled(slotId: number): Promise
\<
boolean
\>
...
@@ -264,26 +264,30 @@ promise.then((data) => {
...
@@ -264,26 +264,30 @@ promise.then((data) => {
});
});
```
```
## DataFlowType
<a name=DataFlowType></a>
## DataFlowType
描述蜂窝数据流类型。
描述蜂窝数据流类型。
| 参数名 | 值 | 说明 |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CellularData。
| ------ | ---------------------- | ------------------------------------------------------------ |
| 0 | DATA_FLOW_TYPE_NONE | 表示没有上行或下行数据。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| 1 | DATA_FLOW_TYPE_DOWN | 表示只有下行数据。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| 2 | DATA_FLOW_TYPE_UP | 表示只有上行数据。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| 3 | DATA_FLOW_TYPE_UP_DOWN | 表示有上下行数据。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| 4 | DATA_FLOW_TYPE_DORMANT | 表示没有上下行数据,底层链路处于休眠状态。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
## DataConnectState<a name=DataConnectState></a>
| 参数名 | 值 | 说明 |
| ---------------------- | ---- | ------------------------------------------ |
| DATA_FLOW_TYPE_NONE | 0 | 表示没有上行或下行数据。 |
| DATA_FLOW_TYPE_DOWN | 1 | 表示只有下行数据。 |
| DATA_FLOW_TYPE_UP | 2 | 表示只有上行数据。 |
| DATA_FLOW_TYPE_UP_DOWN | 3 | 表示有上下行数据。 |
| DATA_FLOW_TYPE_DORMANT | 4 | 表示没有上下行数据,底层链路处于休眠状态。 |
描述蜂窝数据链路连接状态。
## DataConnectState
| 参数名 | 值 | 说明 |
描述蜂窝数据链路连接状态。
| ------ | ----------------------- | ------------------------------------------------------------ |
| -1 | DATA_STATE_UNKNOWN | 表示蜂窝数据链路未知。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Telephony.CellularData。
| 0 | DATA_STATE_DISCONNECTED | 表示蜂窝数据链路断开。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| 1 | DATA_STATE_CONNECTING | 表示正在连接蜂窝数据链路。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| 参数名 | 值 | 说明 |
| 2 | DATA_STATE_CONNECTED | 表示蜂窝数据链路已连接。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| ----------------------- | ---- | -------------------------- |
| 3 | DATA_STATE_SUSPENDED | 表示蜂窝数据链路被挂起。
<br
/>
**系统能力**
:SystemCapability.Telephony.CellularData |
| DATA_STATE_UNKNOWN | -1 | 表示蜂窝数据链路未知。 |
\ No newline at end of file
| DATA_STATE_DISCONNECTED | 0 | 表示蜂窝数据链路断开。 |
| DATA_STATE_CONNECTING | 1 | 表示正在连接蜂窝数据链路。 |
| DATA_STATE_CONNECTED | 2 | 表示蜂窝数据链路已连接。 |
| DATA_STATE_SUSPENDED | 3 | 表示蜂窝数据链路被挂起。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-webSocket.md
浏览文件 @
b5160e59
...
@@ -68,6 +68,8 @@ createWebSocket\(\): WebSocket
...
@@ -68,6 +68,8 @@ createWebSocket\(\): WebSocket
创建一个WebSocket,里面包括建立连接、关闭连接、发送数据和订阅/取消订阅WebSocket连接的打开事件、接收到服务器消息事件、关闭事件和错误事件。
创建一个WebSocket,里面包括建立连接、关闭连接、发送数据和订阅/取消订阅WebSocket连接的打开事件、接收到服务器消息事件、关闭事件和错误事件。
**系统能力:**
SystemCapability.Communication.NetStack
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
...
@@ -93,6 +95,8 @@ connect\(url: string, callback: AsyncCallback<boolean\>\): void
...
@@ -93,6 +95,8 @@ connect\(url: string, callback: AsyncCallback<boolean\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -124,6 +128,8 @@ connect\(url: string, options: WebSocketRequestOptions, callback: AsyncCallback<
...
@@ -124,6 +128,8 @@ connect\(url: string, options: WebSocketRequestOptions, callback: AsyncCallback<
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -161,6 +167,8 @@ connect\(url: string, options?: WebSocketRequestOptions\): Promise<boolean\>
...
@@ -161,6 +167,8 @@ connect\(url: string, options?: WebSocketRequestOptions\): Promise<boolean\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -196,6 +204,8 @@ send\(data: string | ArrayBuffer, callback: AsyncCallback<boolean\>\): void
...
@@ -196,6 +204,8 @@ send\(data: string | ArrayBuffer, callback: AsyncCallback<boolean\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -228,6 +238,8 @@ send\(data: string | ArrayBuffer\): Promise<boolean\>
...
@@ -228,6 +238,8 @@ send\(data: string | ArrayBuffer\): Promise<boolean\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -264,6 +276,8 @@ close\(callback: AsyncCallback<boolean\>\): void
...
@@ -264,6 +276,8 @@ close\(callback: AsyncCallback<boolean\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -293,6 +307,8 @@ close\(options: WebSocketCloseOptions, callback: AsyncCallback<boolean\>\): void
...
@@ -293,6 +307,8 @@ close\(options: WebSocketCloseOptions, callback: AsyncCallback<boolean\>\): void
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -326,6 +342,8 @@ close\(options?: WebSocketCloseOptions\): Promise<boolean\>
...
@@ -326,6 +342,8 @@ close\(options?: WebSocketCloseOptions\): Promise<boolean\>
**需要权限**
:ohos.permission.INTERNET
**需要权限**
:ohos.permission.INTERNET
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -361,6 +379,8 @@ on\(type: 'open', callback: AsyncCallback<Object\>\): void
...
@@ -361,6 +379,8 @@ on\(type: 'open', callback: AsyncCallback<Object\>\): void
订阅WebSocket的打开事件,使用callback方式作为异步方法。
订阅WebSocket的打开事件,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -388,6 +408,8 @@ off\(type: 'open', callback?: AsyncCallback<Object\>\): void
...
@@ -388,6 +408,8 @@ off\(type: 'open', callback?: AsyncCallback<Object\>\): void
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -417,6 +439,8 @@ on\(type: 'message', callback: AsyncCallback<string | ArrayBuffer\>\): void
...
@@ -417,6 +439,8 @@ on\(type: 'message', callback: AsyncCallback<string | ArrayBuffer\>\): void
> **说明:**
> **说明:**
>AsyncCallback中的数据可以是字符串\(API 6\)或ArrayBuffer\(API 8\)。
>AsyncCallback中的数据可以是字符串\(API 6\)或ArrayBuffer\(API 8\)。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -445,6 +469,8 @@ off\(type: 'message', callback?: AsyncCallback<string | ArrayBuffer\>\): void
...
@@ -445,6 +469,8 @@ off\(type: 'message', callback?: AsyncCallback<string | ArrayBuffer\>\): void
>AsyncCallback中的数据可以是字符串\(API 6\)或ArrayBuffer\(API 8\)。
>AsyncCallback中的数据可以是字符串\(API 6\)或ArrayBuffer\(API 8\)。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -466,6 +492,8 @@ on\(type: 'close', callback: AsyncCallback<\{ code: number, reason: string \}\>\
...
@@ -466,6 +492,8 @@ on\(type: 'close', callback: AsyncCallback<\{ code: number, reason: string \}\>\
订阅WebSocket的关闭事件,使用callback方式作为异步方法。
订阅WebSocket的关闭事件,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -492,6 +520,8 @@ off\(type: 'close', callback?: AsyncCallback<\{ code: number, reason: string \}\
...
@@ -492,6 +520,8 @@ off\(type: 'close', callback?: AsyncCallback<\{ code: number, reason: string \}\
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -514,6 +544,8 @@ on\(type: 'error', callback: ErrorCallback\): void
...
@@ -514,6 +544,8 @@ on\(type: 'error', callback: ErrorCallback\): void
订阅WebSocket的Error事件,使用callback方式作为异步方法。
订阅WebSocket的Error事件,使用callback方式作为异步方法。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -541,6 +573,8 @@ off\(type: 'error', callback?: ErrorCallback\): void
...
@@ -541,6 +573,8 @@ off\(type: 'error', callback?: ErrorCallback\): void
> **说明:**
> **说明:**
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
>可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
**系统能力:**
SystemCapability.Communication.NetStack
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
...
@@ -560,6 +594,8 @@ ws.off('error');
...
@@ -560,6 +594,8 @@ ws.off('error');
建立WebSocket连接时,可选参数的类型和说明。
建立WebSocket连接时,可选参数的类型和说明。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------------------------ |
| ------ | ------ | ---- | ------------------------------------------------------------ |
| header | Object | 否 | 建立WebSocket连接可选参数,代表建立连接时携带的HTTP头信息。参数内容自定义,也可以不指定。 |
| header | Object | 否 | 建立WebSocket连接可选参数,代表建立连接时携带的HTTP头信息。参数内容自定义,也可以不指定。 |
...
@@ -569,6 +605,8 @@ ws.off('error');
...
@@ -569,6 +605,8 @@ ws.off('error');
关闭WebSocket连接时,可选参数的类型和说明。
关闭WebSocket连接时,可选参数的类型和说明。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------------------------ |
| ------ | ------ | ---- | ------------------------------------------------------------ |
| code | number | 否 | 错误码,关闭WebSocket连接时的可选参数,可根据实际情况来填。默认值为1000。 |
| code | number | 否 | 错误码,关闭WebSocket连接时的可选参数,可根据实际情况来填。默认值为1000。 |
...
@@ -578,6 +616,8 @@ ws.off('error');
...
@@ -578,6 +616,8 @@ ws.off('error');
发送给服务端的错误码可以自行定义,下面的列表仅供参考。
发送给服务端的错误码可以自行定义,下面的列表仅供参考。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Communication.NetStack。
| 值 | 说明 |
| 值 | 说明 |
| :-------- | :----------------- |
| :-------- | :----------------- |
| 1000 | 正常关闭 |
| 1000 | 正常关闭 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录