network.md 2.1 KB
Newer Older
D
DCloud_LXH 已提交
1
## uni.getNetworkType(OBJECT)
Q
qiang 已提交
2 3
获取网络类型。

D
DCloud_LXH 已提交
4 5
<!-- UNIAPPAPIJSON.getNetworkType.compatibility -->

Q
qiang 已提交
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
**OBJECT 参数说明**

|参数名|类型|必填|说明|
|:-|:-|:-|:-|
|success|Function|是|接口调用成功,返回网络类型 networkType|
|fail|Function|否|接口调用失败的回调函数|
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)|

**success 返回参数说明**

|参数|说明|
|:-|:-|
|networkType|网络类型|

**networkType 有效值**

|值|说明|平台差异说明|
|:-|:-|:-|
|wifi|wifi 网络||
|2g|2g 网络||
|3g|3g 网络||
|4g|4g 网络||
|5g|5g 网络||
|ethernet|有线网络|App|
|unknown|Android 下不常见的网络类型||
|none|无网络|&nbsp;|

**示例**

```javascript
uni.getNetworkType({
	success: function (res) {
		console.log(res.networkType);
	}
});
```

D
DCloud_LXH 已提交
43 44 45
<!-- UNIAPPAPIJSON.getNetworkType.tutorial -->

## uni.onNetworkStatusChange(CALLBACK)
Q
qiang 已提交
46 47
监听网络状态变化。可使用`uni.offNetworkStatusChange`取消监听。

D
DCloud_LXH 已提交
48 49
<!-- UNIAPPAPIJSON.onNetworkStatusChange.compatibility -->

Q
qiang 已提交
50 51 52 53
**CALLBACK 返回参数**

|参数|类型|说明|平台差异说明|
|:-|:-|:-|:-|
54
|isConnected|Boolean|当前是否有网络连接|抖音小程序不支持|
Q
qiang 已提交
55 56 57 58 59 60 61 62 63 64
|networkType|String|网络类型|&nbsp;|

**示例**

```javascript
uni.onNetworkStatusChange(function (res) {
	console.log(res.isConnected);
	console.log(res.networkType);
});
```
study夏羽's avatar
study夏羽 已提交
65

D
DCloud_LXH 已提交
66
## uni.offNetworkStatusChange(CALLBACK)
Q
qiang 已提交
67 68
取消监听网络状态变化。

D
DCloud_LXH 已提交
69 70
<!-- UNIAPPAPIJSON.offNetworkStatusChange.compatibility -->

Q
qiang 已提交
71 72
**平台差异说明**

D
DCloud_LXH 已提交
73 74 75
|App|H5|微信小程序|支付宝小程序|百度小程序|抖音小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|HBuilderX 3.0.1+|HBuilderX 3.0.1+|基础库 2.9.3+|x|x|x|x|√|x|
Q
qiang 已提交
76 77 78 79 80 81 82 83 84 85 86

**Tips**
- `CALLBACK`必须为调用`uni.onNetworkStatusChange`时传入的`CALLBACK`

例如:
```
var CALLBACK = function(res) {
    // ...这里写你的业务逻辑
}
uni.offNetworkStatusChange(CALLBACK)
uni.onNetworkStatusChange(CALLBACK);
D
DCloud_LXH 已提交
87
```