Android 10(API レベル 29)以降のデバイスでは、新しいピアツーピア API を使用して、Chromecast や Google Home ハードウェアなどのセカンダリ デバイスの構成をブートストラップできます。この機能により、アプリは WifiNetworkSpecifier を使用してリクエストされたネットワークのプロパティを記述することで、デバイスが接続されているアクセス ポイントを変更するようユーザーに求めることができます。
この API を使用する手順は次のとおりです。
WifiNetworkSpecifier.Builderを使用して、Wi-Fi ネットワーク指定子を作成します。接続するネットワークと一致するネットワーク フィルタを、必要な認証情報とともに設定します。
次の要件に従って、各リクエストでネットワーク フィルタを設定するために、
SSID、SSID pattern、BSSID、BSSID patternの組み合わせを決定します。- 各リクエストには、
SSID、SSID pattern、BSSID、BSSID patternのうち少なくとも 1 つを指定する必要があります。 - 各リクエストで設定できるのは、
SSIDまたはSSID patternのいずれか 1 つのみです。 - 各リクエストで設定できるのは、
BSSIDまたはBSSID patternのいずれか 1 つのみです。
- 各リクエストには、
NetworkCallbackインスタンスとともに指定子をネットワーク リクエストに追加して、リクエストのステータスをトラッキングします。ユーザーがリクエストを承認し、ネットワークへの接続が成功した場合、コールバック オブジェクトで
NetworkCallback.onAvailable()が呼び出されます。ユーザーがリクエストを拒否した場合、またはネットワークへの接続が失敗した場合、コールバック オブジェクトでNetworkCallback.onUnavailable()が呼び出されます。
ピアデバイスへの接続リクエストを開始すると、同じデバイスにダイアログが表示され、そのデバイスのユーザーは接続リクエストを承認できます。
ユーザー承認の回避
特定のアプリからのリクエストに応じてユーザーが接続するネットワークを承認すると、デバイスはその特定のアクセス ポイントの承認を保存します。アプリがそのアクセス ポイントに再度接続するよう特定のリクエストを行うと、デバイスはユーザーの承認フェーズをスキップして、ネットワークに自動的に接続します。API によってリクエストされたネットワークに接続しているときに、ユーザーがネットワークを削除することを選択した場合、そのアプリとネットワークの組み合わせに対して保存された承認は削除され、アプリからの今後のリクエストはユーザーが再度承認する必要があります。アプリが SSID や BSSID のパターンなど、特定されていないリクエストを行う場合は、ユーザーがリクエストを承認する必要があります。
コードサンプル
次のコードサンプルは、SSID 接頭辞が "test"、BSSID OUI が "10:03:23" のオープン ネットワークに接続する方法を示しています。
Kotlin
val specifier = WifiNetworkSpecifier.Builder()
.setSsidPattern(PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
.setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
.build()
val request = NetworkRequest.Builder()
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.setNetworkSpecifier(specifier)
.build()
val connectivityManager = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
val networkCallback = object : ConnectivityManager.NetworkCallback() {
...
override fun onAvailable(network: Network?) {
// do success processing here..
}
override fun onUnavailable() {
// do failure processing here..
}
...
}
connectivityManager.requestNetwork(request, networkCallback)
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback)
Java
final NetworkSpecifier specifier =
new WifiNetworkSpecifier.Builder()
.setSsidPattern(new PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
.setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
.build();
final NetworkRequest request =
new NetworkRequest.Builder()
.addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
.removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
.setNetworkSpecifier(specifier)
.build();
final ConnectivityManager connectivityManager = (ConnectivityManager)
context.getSystemService(Context.CONNECTIVITY_SERVICE);
final NetworkCallback networkCallback = new NetworkCallback() {
...
@Override
void onAvailable(...) {
// do success processing here..
}
@Override
void onUnavailable(...) {
// do failure processing here..
}
...
};
connectivityManager.requestNetwork(request, networkCallback);
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback);