react-native-netinfo

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。

react-native-netinfo API让您可以访问网络连接信息。

安装

按照下面的步骤安装react-native-netinfo。

在适用于Vega的React Native应用的package.json中添加库依赖项：

已复制到剪贴板。

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

在适用于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 is " + state.details.ssid);
      }
});

支持的方法

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

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

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

实现详情

在模拟器上测试

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

已复制到剪贴板。

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

支持的版本

程序包版本	@amazon-devices/react-native-kepler版本
2.0.x	2.0.x+rn0.72.0

其他资源

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

Last updated: 2025年10月22日