Wi-Fi ホットスポット オフロードの非推奨のお知らせ
重要
Windows 10 バージョン 1709 以降では、Wi-Fi ホットスポット オフロード機能は非推奨となっているため、使用しないでください。 代わりに、UWP アプリを作成し、Wi-Fi ホットスポット認証 API (Windows.Networking.NetworkOperators) を使用することをお勧めします。
コード サンプルと詳細については、Wi-Fi ホットスポット認証のサンプルを参照してください。
探索サービスに送信されるホットスポット データは、JavaScript Object Notation (JSON) である必要があり、次の要素を使用する必要があります。
要素 | Type | 説明 |
---|---|---|
BatchId | GUID | プロバイダーは、複数のホットスポットを含む 1 つの送信を複数の送信に分割できます。 各送信には、同じ BatchId GUID が割り当てられます。 |
ProviderId | GUID | プロバイダー ID は、Microsoft によってプロバイダーに割り当てられます。 |
TransactionId | int | バッチ内の各要求の増分番号。 デバッグに使用されます。 |
Hotspots | アップロードするホットスポットのリスト。 | |
add | 完全な住所プロパティ。Address、City、StateOrProvince、PostalCode、CountryOrRegion の各サブ要素が含まれます。 | |
bssids | List<string> | ホットスポットを構成する BSSID のリスト。 各 BSSID は、00:aa:bb:cc:dd:ee の形式の 8 つの 2 桁の 16 進値で構成されます。 |
free | Boolean | ホットスポットが無料かどうかを示すブール値。 |
pub | Boolean | ホットスポットがパブリックかどうかを示すブール値。 |
loc | 完全な場所プロパティ。Latitude、Longitude、RadialUncertainty、Altitude、AltitudeUncertainty の各サブ要素が含まれます。 | |
name | string | ホットスポットのフレンドリ名。 |
phid | string | プロバイダーのホットスポット ID。 デバッグに使用されます。 |
走った | uint | ホットスポットの範囲。 |
ssid | string | ホットスポットの SSID。 |
電話 | string | ホットスポットに関連付けられているすべての電話番号のリスト。 |
注
- ヘッダーとそのサブ要素 (ProviderId、BatchId、TransactionId) は必須です。
- Hotspots リストを空にすることはできません。
- Location 要素が指定されている場合は、Latitude と Longitude が必須となります。
- Location 要素が指定されていない場合は、少なくとも 1 つの BSSID を指定する必要があります。 それ以外の場合は警告が返され、探索サービスはホットスポットを処理できません。
次の例は、1 つのホットスポットの完全なデータを示しています。
{
"Header": {
"BatchId": "BA85A383-5943-4D84-8ACB-B113BDEA3783",
"ProviderId": "AE012377-B0B4-4096-B5D5-D7EFBDC170EC",
"TransactionId": 1
},
"Hotspots":[{
"add": {
"Address": "123 abc street",
"City": "Redmond",
"CountryOrRegion": "USA",
"PostalCode": "98052",
"StateOrProvince": "WA"
},
"bssids":["00:aa:bb:cc:dd:ee"],
"free": true,
"pub": true,
"loc": {
"Latitude": 47.01,
"Longitude": 121.1234,
"RadialUncertainty": 300,
"Altitude": 638.34,
"AltitudeUncertainty": 100.0
},
"name": "Joes Coffee Shop",
"phid": "abcdefg",
"ran": 100,
"ssid": "JoesCoffee",
"phone": ["425-882-8080"]
}
}
探索サービスは、デバッグに使用されるアクティビティ ID と、探索サービスがホットスポット データを検証したときに生成された警告のリストを含む単純な応答を JSON 形式で返します。 探索サービスから返されるすべての文字列は UTF-8 でエンコードされます。
次の表に、探索サービス応答の JSON 要素を示します。
要素 | Type | 説明 |
---|---|---|
ActivityId | string | 必須。 これは、プロバイダーが問題のデバッグに使用できる文字列です。 |
警告 | List<string> | 人間が判読できる警告のリスト。 |
次の例は、ホットスポット データの送信に対する一般的な応答を示しています。
{
"ActivityId": "d2856c06-e4a1-4434-90e8-ced0c9ee6e10",
"Warnings": ["Invalid Latitude: 247.67 – Hotspot Id: abcdefg"]
}