react-native-netinfo

react-native-netinfo API（英語のみ）を使用すると、ネットワーク接続情報にアクセスできます。このライブラリのVega移植版には、keplerscript-netmgr-libという異なるパッケージ名が付いています。

インストール

keplerscript-netmgr-libをインストールするには、次の手順に従います。

Vega向けReact Nativeアプリのpackage.jsonにライブラリの依存関係を追加します。

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

Vega向けReact Nativeアプリのmanifest.tomlで、[wants.service]にcom.amazon.network.serviceを追加します。
[[wants.service]] id = "com.amazon.network.service"

Vega向けReact Nativeアプリのmanifest.tomlで、[wants.privilege]にAPI権限を追加します。

     [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

サポートされているバージョン

パッケージのバージョン	@amazon-devices/react-native-keplerバージョン
2.0.x	2.0.x+rn0.72.0

Vegaライブラリとサービス

インストール

API権限

使用方法

サポートされるメソッド

実装の詳細

シミュレーターでのテスト

サポートされているバージョン

関連リソース

​インストール

​API権限

​使用方法

​サポートされるメソッド

​実装の詳細

​シミュレーターでのテスト

​サポートされているバージョン

​関連リソース

インストール

API権限

使用方法

サポートされるメソッド

実装の詳細

シミュレーターでのテスト

サポートされているバージョン

関連リソース