react-native-netinfo
react-native-netinfo
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。
react-native-netinfo API让您可以访问网络连接信息。该库的Vega移植版本有不同的程序包名称：keplerscript-netmgr-lib。
安装
按照以下步骤在您的适用于Vega的React Native应用程序中安装keplerscript-netmgr-lib。
- 将库依赖项添加到
package.json："dependencies": { ... "@amazon-devices/keplerscript-netmgr-lib": "~2.0.0", ... } - 将
com.amazon.network.service添加到manifest.toml文件中的[wants.service]：[[wants.service]] id = "com.amazon.network.service" - 在
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);
}
});
方法
| 方法 | 描述 |
|---|---|
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虚拟设备上测试网络连接。
vega 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日
