WiFiDirectService Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет службу 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)
|
Комментарии
Это один из нескольких классов, которые поддерживают подключение двух устройств с предпочтением того, какое устройство должно быть владельцем группы. См. статью Windows.Devices.WiFiDirect.Service , чтобы обсудить связывание устройств и о том, как это может привести к игнорированию предпочтения владельца группы (и как это исправить).
Код не создает экземпляр этого класса напрямую. Вместо этого код следует этому процессу, чтобы получить экземпляр этого класса и использовать его для создания сеанса Wi-Fi Direct Service.
- Используйте один из методов GetSelector , чтобы получить строку запроса для определенной службы.
- Создайте DeviceWatcher , который следит за рекламодателями, которые соответствуют строке запроса. При обнаружении рекламодателя решите, следует ли использовать этого рекламодателя программным способом или путем запроса у пользователя указать выбор.
- После того как ваш искатель определил нужного рекламодателя службы, вызовите статический метод FromIdAsync с идентификатором устройства выбранного рекламодателя. FromIdAsync извлекает экземпляр WiFiDirectService для запрошенной службы на запрошенном устройстве.
- Перейдите к созданию сеанса, вызвав WiFiDirectService.ConnectAsync.
Свойства
PreferGroupOwnerMode |
Возвращает или задает значение, указывающее, следует ли экземпляру службы выбрать Wi-Fi режиме владельца группы прямого типа "точка — точка" (GO). |
RemoteServiceInfo |
Возвращает большой двоичный объект сведений о службе из этого экземпляра службы. |
ServiceError |
Сведения об ошибке последней попытки подключения к службе. |
SessionInfo |
Возвращает или задает сведения о сеансе для конкретного приложения, передаваемые серверу при инициации сеанса. |
SupportedConfigurationMethods |
Возвращает список поддерживаемых методов конфигурации, упорядоченных по предпочтениям. Код использует операции IVector для изменения содержимого списка. |
Методы
ConnectAsync() |
Инициирует создание сеанса службы с Wi-Fi Direct Service, представленной этим экземпляром. |
ConnectAsync(String) |
Инициирует создание сеанса службы с Wi-Fi Direct Service, представленной этим экземпляром, с помощью ПИН-кода для настройки сеанса. |
FromIdAsync(String) |
Статический метод, который извлекает экземпляр WiFiDirectService для Wi-Fi Direct Service, предлагаемой устройством с заданным идентификатором устройства. |
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod) |
Асинхронно извлекает Wi-Fi сведения о подготовке сеанса direct service. |
GetSelector(String) |
Возвращает строку расширенного синтаксиса запросов (AQS), используемую для поиска Wi-Fi рекламодателей direct service для определенной службы. |
GetSelector(String, IBuffer) |
Возвращает строку расширенного синтаксиса запросов (AQS), используемую для поиска Wi-Fi рекламодателей прямой службы для определенной службы, где указанная последовательность байтов отображается в большом двоичном объекте сведений о службе рекламодателя. |
События
SessionDeferred |
Событие, возникаемое при отложении запроса сеанса. Обратите внимание, что это не означает, что запрос завершился сбоем или отклонен. Это уведомление о том, что сервер выполняет длинную операцию, например ожидание ввода ПИН-кода пользователем. Запрашивающий запрос, получающий это сообщение, должен начать 120-секундное ожидание, прежде чем истечет время ожидания запроса сеанса, чтобы дать серверу время для завершения операции. Аргументы события включают буфер, предоставленный сервером в уведомлении об отсрочке с дополнительными сведениями. |