この API を使用すると、デバイスのネットワークの状態を確認し、その情報に基づいて操作を実行できます。多くの場合、この API は、オフラインのスマート デバイス アプリケーションで、同期の実行に最適なタイミングを判断するために使用します。
この API は、ドメイン、プロパティ、およびメソッドから構成されます。
ドメイン
NetworkAPIConnectionType
このドメインは、デバイスの接続タイプを特定するために定義します。
Numeric(1) であり、値は次のとおりです:
|
名前 |
説明 |
値 |
|
None |
なし |
0 |
|
Wifi |
Wi-Fi |
1 |
|
WAN |
WAN |
2 |
プロパティ
ApplicationServerURL
SmartDevices ジェネレーターの [ ServiceURL ] プロパティを設定すると自動的に設定される読み取り専用のプロパティです。
このプロパティは、次に示す複数のメソッドで使用します。
メソッド
IsServerAvailable メソッド
デバイスが指定のサーバーにアクセスできるかどうかに応じて true または false を返します。
サーバーの URL をオプションのパラメーターとして渡すことができます。URL パラメーターがなかった場合、メソッドでは [ ApplicationServerURL ] プロパティのサーバー URL への接続を確認します。
パラメーター
|
名前 |
タイプ |
説明 |
|
URL (オプション) |
Character(200) |
デバイスのアクセスを確認するサーバーの URL。 |
戻り値
|
タイプ |
説明 |
|
Boolean |
true または false でサーバーに接続できるかどうかを示す。 |
Type メソッド
デバイスから特定のサーバーへの接続タイプを取得します。ローカルネットワークのみを使用してアクセスするサーバーもあるので、デバイスにインターネット接続があってもサーバーにアクセスできない場合があります。
パラメーター
|
名前 |
タイプ |
説明 |
|
URL (オプション) |
Character(200) |
デバイスが接続しようとしているサーバーの URL。 |
戻り値
|
タイプ |
説明 |
|
NetworkAPIConnectionType |
このドメインの列挙タイプの 1 つで、デバイスからサーバーへの接続タイプ。 |
TrafficBasedCost メソッド
デバイスとサーバーの間の接続について、デバイスのユーザーにコストが課されるかどうかを示す true または false を返します。
パラメーター
|
名前 |
タイプ |
説明 |
|
URL (オプション) |
Character(200) |
デバイスが接続しようとしているサーバーの URL。 |
戻り値
|
タイプ |
説明 |
|
Boolean |
ネットワーク接続について、デバイスのユーザーにコストが課されるかどうかを示す true または false。 |
参考情報
|