react-native-netinfo - Amazon Vega Docs

react-native-netinfo API让您可以访问网络连接信息。该库的Vega移植版本有不同的程序包名称：keplerscript-netmgr-lib。

安装

按照下面的步骤安装keplerscript-netmgr-lib。

在适用于Vega的React Native应用的package.json中添加库依赖项。选择适用于您的React Native版本的选项卡。

    "dependencies": {
        ...
        "@amazon-devices/keplerscript-netmgr-lib": "~2.0.0",
        ...
    }

    "dependencies": {
        ...
        "@amazon-devices/keplerscript-netmgr-lib": "~2.0.20",
        ...
    }

在适用于Vega的React Native应用的manifest.toml中，将com.amazon.network.service添加到[wants.service]。
[[wants.service]] id = "com.amazon.network.service"

在适用于Vega的React Native应用的manifest.toml中，将API权限添加到[wants.privilege]。

     [wants]
     [[wants.privilege]]
     id="com.amazon.network.privilege.net-info"

使用npm install命令重新安装依赖项。

API权限

要访问完整的API功能，您的应用需要com.amazon.network.privilege.net-info权限。此权限必须由用户在运行时授予。没此权限，API响应会受限。要管理权限，请执行以下操作：

使用checkPrivilege("com.amazon.network.privilege.net-info") 检查当前的权限状态。
如果需要，可通过调用requestPrivilege() 请求用户同意。

有关完整详情，请参阅安全管理器API文档。

用法

以下代码片段显示了如何查询网络状态。

import {NetInfoStateType, fetch} from "@amazon-devices/keplerscript-netmgr-lib";
fetch().then(state => {
      console.log("连接状态：" + state.isConnected);
      if (state.type === NetInfoStateType.wifi) {
        console.log("SSID： " + state.details.ssid);
      }
});

支持的方法

方法	描述
`fetch()`	返回缓存的网络信息。
`refresh()`	更新网络状态并返回网络信息。
`addEventListener()`	侦听网络连接的变化。
`useNetInfo()`	从全局实例获取对最新状态的访问权限。

fetch() 和refresh() 方法返回NetInfoState以访问网络连接信息。

属性	描述
`type`	如果连接为Wi-Fi，则为`NetInfoStateType.wifi`。
`isConnected`	如果已连接Wi-Fi，则为`true`；否则为`false`。
`isInternetReachable`	如果可以访问互联网，则为`true`；否则为`false`。
`ssid`中的`details`	所连接访问接入点的SSID。如果`"<unknown ssid>"`权限被拒绝，则返回`com.amazon.network.privilege.net-info`。
`bssid`中的`details`	所连接访问接入点的BSSID。如果`"02:00:00:00:00:00"`权限被拒绝，则返回`com.amazon.network.privilege.net-info`。
`details`中的`strength`	当前Wi-Fi连接的信号强度。
`details`中的`ipAddress`	IP地址。
`details`中的`subnet`	子网掩码。
`details`中的`frequency`	中心频率。
`details`中的`linkspeed`	当前连接的链路速度（以bps为单位）。
`isConnectionExpensive`中的`details`	如果连接开销过高，则为`true`；否则为`false`。

实现详情

在模拟器上测试

您可以通过运行以下命令在Vega虚拟设备上测试网络连接。

vega exec vda shell
ace mw wifi_cli add_network ssid=test psk=test_password
ace mw wifi_cli connect test

支持的版本

NPM程序包版本	Vega SDK版本	Vega OS版本	React Native版本
~2.0.0	0.23及更早版本	`OS 1.1 (1401010009820)`及更早版本	0.72
~2.0.20	0.24	`OS 1.2 (2101020054720)`	0.83

其他资源

有关其他库的信息，请参阅支持的第三方库和服务。

​安装

​API权限

​用法

​支持的方法

​实现详情

​在模拟器上测试

​支持的版本

​其他资源

安装