react-native-netinfo - Amazon Vega Docs

With the react-native-netinfo API, you can access network connection information. The Vega-ported version of this library has a different package name: keplerscript-netmgr-lib.

Installation

Follow these steps to install keplerscript-netmgr-lib in your React Native for Vega application.

Add the library dependency to package.json:

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

Add com.amazon.network.service to [wants.service] in your manifest.toml file:

      [[wants.service]]
      id = "com.amazon.network.service"

Add API permission to [wants.privilege] in your manifest.toml file:

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

Reinstall dependencies using the npm install command.

API privileges

To access full API functionality, your app needs the com.amazon.network.privilege.net-info privilege. This privilege must be granted by the user at runtime. Without it, API responses are limited. To manage privileges:

Check the current privilege status using checkPrivilege("com.amazon.network.privilege.net-info").
Request user consent by calling requestPrivilege(), if needed.

For complete details, see the Security Manager API documentation.

Examples

The following code example shows how to query network status:

import {NetInfoStateType, fetch} from "@amazon-devices/keplerscript-netmgr-lib";
fetch().then(state => {
      console.log("is connected? " + state.isConnected);
      if (state.type === NetInfoStateType.wifi) {
        console.log("ssid is " + state.details.ssid);
      }
});

Methods

Method	Description
`fetch()`	Returns cached network information.
`refresh()`	Updates network state and returns network information.
`addEventListener()`	Listens for network connection changes.
`useNetInfo()`	Gets access to the latest state from the global instance.

The fetch() and refresh() methods return NetInfoState to access the network connection information.

Props

Prop	Description
`type`	`NetInfoStateType.wifi` if the connection is Wi-Fi.
`isConnected`	`true` if Wi-Fi is connected; otherwise `false`.
`isInternetReachable`	`true` if the internet is reachable; otherwise `false`.
`ssid` in `details`	The SSID of the connected access point. `"<unknown ssid>"` returned if `com.amazon.network.privilege.net-info` privilege is denied.
`bssid` in `details`	The BSSID of the connected access point.`"02:00:00:00:00:00"` returned if `com.amazon.network.privilege.net-info` privilege is denied.
`strength` in `details`	The signal strength of the current Wi-Fi connection.
`ipAddress` in `details`	The IP address.
`subnet` in `details`	The subnet mask.
`frequency` in `details`	The center frequency.
`linkspeed` in `details`	The link speed in bps of the current connection.
`isConnectionExpensive` in `details`	`true` if the connection is expensive; otherwise `false`.

Test on a simulator

You can test the network connection on the Vega Virtual Device by running the following commands.

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

Supported versions

Package version	@amazon-devices/react-native-kepler version
2.0.x	2.0.x+rn0.72.0

Supported Third-Party Libraries and Services.

​Installation

​API privileges

​Examples

​Methods

​Props

​Test on a simulator

​Supported versions

​Related topics