WiFiDirectService クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Wi-Fi Direct サービスを表します。 このクラスは、サービス プロバイダーとの Wi-Fi Direct Service セッションを確立するために、Wi-Fi Direct Service を使用しようとしているデバイス上のコードによって使用されます。
public ref class WiFiDirectService sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectService final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectService
Public NotInheritable Class WiFiDirectService
- 継承
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
これは、グループ所有者であるデバイスを優先して 2 つのデバイスを接続することをサポートするいくつかのクラスの 1 つです。 デバイスのペアリングと、グループ所有者の基本設定が無視される原因 (およびそれを修正する方法) については、 Windows.Devices.WiFiDirect.Service トピックを参照してください。
コードは、このクラスを直接インスタンス化しません。 代わりに、コードはこのプロセスに従ってこのクラスのインスタンスを取得し、それを使用して Wi-Fi Direct Service セッションを確立します。
- GetSelector メソッドのいずれかを使用して、特定のサービスのクエリ文字列を取得します
- クエリ文字列と一致する広告主を監視する DeviceWatcher を作成します。 広告主が見つかったら、その広告主を使用するか、プログラムを使用するか、ユーザーに選択を指示するかを決定します。
- Seeker が目的のサービス広告主を特定したら、選択した広告主デバイスのデバイス ID を使用して静的 な FromIdAsync メソッドを呼び出します。 FromIdAsync は、要求されたデバイスで要求されたサービスの WiFiDirectService のインスタンスを取得します。
- WiFiDirectService.ConnectAsync を呼び出してセッションを確立します。
プロパティ
PreferGroupOwnerMode |
サービス インスタンスが Direct Point to Point (P2P) グループ所有者 (GO) モード Wi-Fi 選択するかどうかを指定する値を取得または設定します。 |
RemoteServiceInfo |
このサービス インスタンスからサービス情報 BLOB を取得します。 |
ServiceError |
サービスへの最新の接続試行に関するエラー情報。 |
SessionInfo |
セッションの開始時にサーバーに渡されるアプリ固有のセッション情報を取得または設定します。 |
SupportedConfigurationMethods |
優先順に並べ替えられた、サポートされている構成方法の一覧を取得します。 コードでは 、IVector 操作を使用してリストの内容を変更します。 |
メソッド
ConnectAsync() |
このインスタンスによって表される Wi-Fi ダイレクト サービスとのサービス セッションの確立を開始します。 |
ConnectAsync(String) |
PIN を使用してセッションを構成し、このインスタンスによって表される Wi-Fi Direct Service を使用してサービス セッションの確立を開始します。 |
FromIdAsync(String) |
特定のデバイス ID を持つデバイスによって提供される Wi-Fi Direct Service の WiFiDirectService インスタンスを取得する静的メソッド。 |
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod) |
Direct Service セッション プロビジョニング情報 Wi-Fi 非同期的に取得します。 |
GetSelector(String) |
特定のサービスの Direct Service 広告主 Wi-Fi 検索するために使用する高度なクエリ構文 (AQS) 文字列を取得します。 |
GetSelector(String, IBuffer) |
特定のサービスの Direct Service 広告主 Wi-Fi 検索するために使用する高度なクエリ構文 (AQS) 文字列を取得します。この文字列は、広告主のサービス情報 BLOB に特定のバイト シーケンスが表示されます。 |
イベント
SessionDeferred |
セッション要求が延期されたときに発生するイベント。 これは、要求が失敗したか拒否されたことを意味するわけではないことに注意してください。 これは、ユーザーが PIN を入力するのを待機するなど、サーバーが長い操作を実行していることを示す通知です。 このメッセージを受信するシーカーは、サーバーに操作を完了する時間を与えるために、セッション要求をタイムアウトする前に 120 秒の待機を開始する必要があります。 イベント引数には、サーバーによって提供されるバッファーが、遅延通知に追加情報と共に含まれます。 |