WiFiDirectServiceAdvertiser 类

定义

命名空间:

Windows.Devices.WiFiDirect.Services

表示服务广告商。 此类由播发 Wi-Fi Direct Services 的设备上的代码用于播发服务。

public ref class WiFiDirectServiceAdvertiser sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WiFiDirectServiceAdvertiser final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WiFiDirectServiceAdvertiser

function WiFiDirectServiceAdvertiser(serviceName)

Public NotInheritable Class WiFiDirectServiceAdvertiser

继承

Object Platform::Object IInspectable WiFiDirectServiceAdvertiser

属性

ActivatableAttribute 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 主题，了解设备配对及其如何导致组所有者首选项被忽略 (以及如何解决此问题。)

服务名称在 WiFiDirectServiceAdvertiser 构造函数中设置。 服务名称是 UTF-8 字符串，长度不超过 255 个字符。 建议名称使用反向域名表示法，其中服务所有者的 DNS 名称 (（如“contoso.com”) ）将反转并用作服务名称 (的开头，例如“com.contoso.serviceX”) 。 此约定旨在使选择唯一服务名称变得容易。 以“org.wi-fi.wfds”开头的服务名称保留供 Wi-Fi 联盟使用，你不得将此类名称用于服务。

构造函数

WiFiDirectServiceAdvertiser(String)

创建 WiFiDirectServiceAdvertiser 类的实例。 若要开始播发 Wi-Fi 直接服务，请创建此类的实例，为服务适当设置其属性，然后调用其 Start 方法。

属性

AdvertisementStatus	获取一个值，该值描述播发的当前状态。
AutoAcceptSession	获取或设置此服务播发的“自动接受”属性。
CustomServiceStatusCode	获取或设置自定义服务状态代码。 仅当 ServiceStatus 属性值为 Custom 时有效。
DeferredSessionInfo	获取或设置在建立会话时传递给会话请求者的特定于服务的信息不会立即完成，例如，当服务等待用户输入完成请求时。 请求者在请求延迟时应实现 120 秒的超时。
PreferGroupOwnerMode	获取或设置一个值，该值指示服务是否要求它是 Wi-Fi 直接对等方 (P2P) 组所有者。 作为组所有者，服务可以更好地控制 P2P 连接配置和连接过程。 有关详细信息，请参阅 Wi-Fi 联盟提供的 Wi-Fi Direct P2P 技术规范。
PreferredConfigurationMethods	获取实现首选会话配置方法的 IVector 接口) 的列表 (。 代码使用列表中的 IVector 操作在列表中添加或删除元素。
ServiceError	获取播发状态中止时的特定错误代码。
ServiceInfo	获取或设置服务信息 Blob。 Blob 的格式和内容由单个服务确定，并且供寻求者在服务发现期间使用。
ServiceName	获取服务名称。
ServiceNamePrefixes	获取当寻道器使用前缀搜索时应与此服务匹配的服务名称前缀列表。 代码使用 IVector 方法在列表中添加或删除元素。
ServiceStatus	获取或设置服务状态。

方法

ConnectAsync(DeviceInformation)	无需 PIN 即可接受会话请求。
ConnectAsync(DeviceInformation, String)	使用给定 PIN 进行连接来接受会话请求。
Start()	开始播发服务，使用当前属性值设置播发的参数。
Stop()	停止播发服务。 这不会影响连接到服务的现有会话。

事件

AdvertisementStatusChanged	在 AdvertisementStatus 属性值更改时引发的事件。
AutoAcceptSessionConnected	服务自动接受会话请求时引发的事件。 事件处理程序应为事件参数对象中列出的终结点对建立套接字连接。
SessionRequested	当 Seeker 请求与此 WiFiDirectServiceAdvertiser 实例关联的服务建立会话时引发的事件。 若要接受请求，请在事件处理程序中调用 WiFiDirectServiceAdvertiser.ConnectAsync 。