WiFiDirectService 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示 Wi-Fi 直接服務。 此類別是由搜尋使用 Wi-Fi Direct Service 之裝置上的程式碼使用，以建立與服務提供者 Wi-Fi 直接服務會話。
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 WiFiDirectServicePublic 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 引進)
|
備註
這是數個類別之一，可支援連接兩個裝置，其喜好設定應為群組擁有者。 如需裝置配對的討論，請參閱 Windows.Devices.WiFiDirect.Service 主題，以及如何在 (忽略群組擁有者喜好設定，以及如何修正該.)
您的程式碼不會直接具現化此類別。 相反地，您的程式碼會遵循此程式來取得此類別的實例，並用它來建立 Wi-Fi 直接服務會話。
- 使用其中一個 GetSelector 方法來取得特定服務的查詢字串
- 建立 DeviceWatcher ，監看符合查詢字串的廣告商。 找到廣告商時，請決定是否以程式設計方式使用該廣告商，或要求使用者指出選擇。
- 一旦搜尋者識別出所需的服務廣告商，請使用所選廣告商裝置的裝置識別碼呼叫靜態 FromIdAsync 方法。 FromIdAsync 會擷取所要求裝置上所要求服務的 WiFiDirectService 實例。
- 呼叫 WiFiDirectService.ConnectAsync以繼續建立會話。
屬性
| PreferGroupOwnerMode |
取得或設定值，指定服務實例是否應該選擇 Wi-Fi 直接點對點 (P2P) 群組擁有者 (GO) 模式。 |
| RemoteServiceInfo |
從這個服務實例取得服務資訊 Blob。 |
| ServiceError |
連線至服務的最新嘗試錯誤資訊。 |
| SessionInfo |
取得或設定起始會話時傳遞至伺服器的應用程式特定會話資訊。 |
| SupportedConfigurationMethods |
取得依喜好設定排序的支援組態方法清單。 您的程式碼會使用 IVector 作業來修改清單的內容。 |
方法
| ConnectAsync() |
使用此實例所表示的 Wi-Fi Direct Service，起始服務會話的建立。 |
| ConnectAsync(String) |
使用 PIN 來設定會話，以這個實例所表示的 Wi-Fi Direct Service 起始服務會話的建立。 |
| FromIdAsync(String) |
靜態方法，擷取具有指定裝置識別碼之裝置所提供之 Wi-Fi Direct Service 的 WiFiDirectService 實例。 |
| GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod) |
以非同步方式擷取 Wi-Fi 直接服務會話布建資訊。 |
| GetSelector(String) |
取得進階查詢語法 (AQS) 字串，用來尋找特定服務的 Wi-Fi 直接服務廣告商。 |
| GetSelector(String, IBuffer) |
取得進階查詢語法 (AQS) 字串，用來尋找特定服務的 Wi-Fi 直接服務廣告商，其中指定的位元組序列會出現在廣告商的服務資訊 Blob 中。 |
事件
| SessionDeferred |
延遲會話要求時引發的事件。 請注意，這並不表示要求失敗或遭到拒絕。 這是伺服器執行長時間作業的通知，例如等候使用者輸入 PIN。 接收此訊息的搜尋者應該會在逾時會話要求之前開始 120 秒等候，讓伺服器完成其作業。 事件引數包含伺服器在延遲通知中提供的緩衝區，並提供其他資訊。 |