WiFiDirectService 类

定义

命名空间:

Windows.Devices.WiFiDirect.Services

表示 Wi-Fi Direct 服务。 此类由寻求使用 Wi-Fi Direct 服务的设备上的代码用于与服务提供商建立 Wi-Fi Direct 服务会话。

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

继承

Object Platform::Object IInspectable WiFiDirectService

属性

ContractVersionAttribute MarshalingBehaviorAttribute

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 中引入)

注解

这是多个类之一，这些类支持连接两个设备，并优先选择哪些设备应为组所有者。 请参阅 Windows.Devices.WiFiDirect.Service 主题，了解设备配对及其如何导致组所有者首选项被忽略 (以及如何修复此问题。)

代码不会直接实例化此类。 相反，代码会遵循此过程来获取此类的实例，并使用它来建立 Wi-Fi Direct Service 会话。

1. 使用 GetSelector 方法之一获取特定服务的查询字符串
2. 创建 一个 DeviceWatcher ，用于监视与查询字符串匹配的广告商。 找到广告客户后，决定是以编程方式还是要求用户指示选择来使用该广告客户。
3. Seeker 标识所需的服务广告商后，使用所选广告客户设备的设备 ID 调用静态 FromIdAsync 方法。 FromIdAsync 检索所请求设备上的所请求服务的 WiFiDirectService 实例。
4. 通过调用 WiFiDirectService.ConnectAsync 继续建立会话。

属性

PreferGroupOwnerMode	获取或设置一个值，该值指定服务实例是否应选择 Wi-Fi 直接点到点 (P2P) 组所有者 (GO) 模式。
RemoteServiceInfo	从此服务实例获取服务信息 blob。
ServiceError	有关最近尝试连接到服务的错误信息。
SessionInfo	获取或设置在启动会话时传递给服务器的特定于应用的会话信息。
SupportedConfigurationMethods	获取按首选项排序的受支持配置方法的列表。 代码使用 IVector 操作来修改列表的内容。

方法

ConnectAsync()	使用此实例表示的 Wi-Fi Direct 服务启动服务会话的建立。
ConnectAsync(String)	使用 PIN 来配置会话，通过此实例表示的 Wi-Fi Direct 服务启动服务会话的建立。
FromIdAsync(String)	静态方法，用于检索具有给定设备 ID 的设备提供的 Wi-Fi Direct 服务的 WiFiDirectService 实例。
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod)	异步检索 Wi-Fi Direct Service 会话预配信息。
GetSelector(String)	获取高级查询语法 (AQS) 字符串，用于查找特定服务的 Wi-Fi Direct Service 广告商。
GetSelector(String, IBuffer)	获取高级查询语法 (AQS) 字符串，用于查找特定服务的 Wi-Fi Direct Service 广告商，其中给定的字节序列显示在广告商的服务信息 Blob 中。

事件

SessionDeferred

会话请求延迟时引发的事件。 请注意，这并不意味着请求已失败或被拒绝。 这是服务器正在执行长时间操作的通知，例如等待用户输入 PIN。 接收此消息的搜寻器应在超时会话请求之前开始 120 秒的等待，以便为服务器提供完成其操作的时间。 事件参数包括服务器在延迟通知中提供的缓冲区以及其他信息。