WiFiDirectServiceAdvertiser 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表服務廣告商。 此類別是由公告 Wi-Fi Direct Services 的裝置上的程式碼所使用，以公告服務。
public ref class WiFiDirectServiceAdvertiser sealed/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectServiceAdvertiser final/// [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.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectServiceAdvertiser[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 WiFiDirectServiceAdvertiserfunction WiFiDirectServiceAdvertiser(serviceName)Public NotInheritable Class WiFiDirectServiceAdvertiser- 繼承
- 屬性
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 建構函式中設定。 服務名稱長度不超過 255 個字元的 UTF-8 字串。 建議名稱使用反向功能變數名稱標記法，其中服務擁有者的 DNS 名稱 (例如 「contoso.com」) 會反轉，並用來作為服務名稱開頭 (，例如 「com.contoso.serviceX」) 。 此慣例旨在讓您輕鬆地選擇唯一的服務名稱。 以 「org.wi-fi.wfds」 開頭的服務名稱會保留供 Wi-Fi 聯盟使用，而且您可能不會將這類名稱用於您的服務。
建構函式
| WiFiDirectServiceAdvertiser(String) |
建立 WiFiDirectServiceAdvertiser 類別的實例。 若要開始公告 Wi-Fi Direct Service，請建立此類別的實例、為您的服務適當設定其屬性，然後呼叫其 Start 方法。 |
屬性
| AdvertisementStatus |
取得值，這個值描述公告的目前狀態。 |
| AutoAcceptSession |
取得或設定此服務公告的自動接受屬性。 |
| CustomServiceStatusCode |
取得或設定自訂服務狀態碼。 只有在 ServiceStatus 屬性值為 Custom時才有效。 |
| DeferredSessionInfo |
取得或設定在建立會話時傳遞至會話要求者的服務特定資訊將不會立即完成，例如，服務正在等候使用者輸入完成要求。 當要求者延遲要求時，要求者應該實作 120 秒的逾時。 |
| PreferGroupOwnerMode |
取得或設定值，指出服務是否需要它是 Wi-Fi 直接對等對等 (P2P) 群組擁有者。 「群組擁有者」可讓服務對 P2P 連線設定和連線程式執行更多控制。 如需詳細資訊，請參閱 Wi-Fi 聯盟提供的 Wi-Fi Direct P2P 技術規格。 |
| PreferredConfigurationMethods |
取得清單 (，這個清單會實作慣用會話組態方法的 IVector 介面) 。 您的程式碼會使用清單中的 IVector 作業，從清單中新增或移除元素。 |
| ServiceError |
當 AdvertisementStatus中止時，取得特定的錯誤碼。 |
| ServiceInfo |
取得或設定服務資訊 Blob。 Blob 的格式和內容是由個別服務所決定，而且預定供一位在服務探索期間使用。 |
| ServiceName |
取得服務名稱。 |
| ServiceNamePrefixes |
取得搜尋者使用前置詞搜尋時，應該符合此服務的服務名稱前置詞清單。 您的程式碼會使用 IVector 方法來新增或移除清單中的專案。 |
| ServiceStatus |
取得或設定服務狀態。 |
方法
| ConnectAsync(DeviceInformation) |
接受會話要求，而不需要 PIN。 |
| ConnectAsync(DeviceInformation, String) |
使用指定的 PIN 連線來接受會話要求。 |
| Start() |
啟動廣告服務，使用目前的屬性值來設定廣告的參數。 |
| Stop() |
停止廣告服務。 這不會影響連線至服務的現有會話。 |
事件
| AdvertisementStatusChanged |
當 AdvertisementStatus屬性值變更時引發的事件。 |
| AutoAcceptSessionConnected |
當服務自動接受會話要求時引發的事件。 事件處理常式應該為事件引數物件中列出的端點配對建立通訊端連線。 |
| SessionRequested |
當 Seeker 要求與這個 WiFiDirectServiceAdvertiser 實例相關聯的服務建立會話時引發的事件。 若要接受要求，請在事件處理常式中呼叫 WiFiDirectServiceAdvertiser.ConnectAsync 。 |