expo-network

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、リリースノートを参照してください。

@amazon-devices/expo-networkは、IPアドレス、MACアドレス、機内モードのステータスなど、デバイスのネットワークに関する有用な情報を提供します。

インストール
例
APIリファレンス
- メソッド
実装の詳細
- シミュレーターでのテスト
サポートされているバージョン
関連リソース

インストール

package.jsonファイルにJavaScriptライブラリの依存関係を追加します。
クリップボードにコピーしました。
```
 dependencies: {
     ...
     "@amazon-devices/expo-network": "~2.0.0",
 }
```
npm installコマンドを使用して、依存関係を再インストールします。

例

ネットワーク機能をテストするには、デバイスシェルでWi-Fiに接続する必要があります。NETWORKとPASSWORDは適切な認証情報に置き換えてください。

クリップボードにコピーしました。

> ace mw wifi add_network ssid=$NETWORK psk=$PASSWORD
> ace mw wifi connect $NETWORK

クリップボードにコピーしました。

import * as Network from '@amazon-devices/expo-network';
import React, {useEffect, useState} from 'react';
import {StyleSheet, Text, View} from 'react-native';

export const App = () => {
  const [networkState, setNetworkState] = useState<Network.NetworkState>();
  const [ipAddress, setIpAddress] = useState<string>();
  const [airplaneModeEnabled, setAirplaneModeEnabled] = useState<boolean>();

  useEffect(() => {
    (async () => {
      setNetworkState(await Network.getNetworkStateAsync());
      setIpAddress(await Network.getIpAddressAsync());
      setAirplaneModeEnabled(await Network.isAirplaneModeEnabledAsync());
    })();
  }, []);

  return (
    <View style={styles.container}>
      <Text style={styles.text}>
        getNetworkStateAsync().type: {networkState?.type}
      </Text>
      <Text style={styles.text}>
        getNetworkStateAsync().isConnected: {String(networkState?.isConnected)}
      </Text>
      <Text style={styles.text}>
        getNetworkStateAsync().isInternetReachable:{' '}
        {String(networkState?.isInternetReachable)}
      </Text>
      <Text style={styles.text}>getIpAddressAsync(): {ipAddress}</Text>
      <Text style={styles.text}>
        isAirplaneModeEnabledAsync(): {String(airplaneModeEnabled)}
      </Text>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    backgroundColor: 'white',
    flex: 1,
  },
  text: {
    color: 'black',
    fontSize: 32,
  },
});

APIリファレンス

このライブラリの情報、APIリファレンス、その他の詳細については、 Expo公式ドキュメントのexpo-networkのページ（英語のみ）を参照してください。

メソッド

名前	型	説明
`Network.getIpAddressAsync()`	`Promise<string>`	デバイスの現在のIPv4アドレスを取得します。IPアドレスを取得できなかった場合は`0.0.0.0`を返します。
`Network.getNetworkStateAsync()`	`Promise<NetworkState>`	デバイスの現在のネットワーク接続状態を取得します。
`Network.isAirplaneModeEnabledAsync()`	`Promise<boolean>`	デバイスが機内モードになっているかどうかを示します。Keplerでは、常に`false`を返します。

実装の詳細

Network.isAirplaneModeEnabledAsync() - 常にfalseを返します。
Network.getNetworkStateAsync() - isInternetReachableフィールドは常に定義されません。
Network.getNetworkStateAsync() - typeフィールドが取り得る値は、NONEかWIFIのいずれかだけです。

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

以下のコマンドを実行すると、Vega仮想デバイスでネットワーク接続をテストできます。

クリップボードにコピーしました。

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

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

パッケージのバージョン	ベース	@amazon-devices/react-native-kepler version
2.0.x	5.7.0	2.0.x

expo-network

インストール

例

APIリファレンス

メソッド

実装の詳細

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

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

関連リソース