Поделиться через


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
Наследование
Object Platform::Object IInspectable 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.

  1. Используйте один из методов GetSelector , чтобы получить строку запроса для определенной службы.
  2. Создайте DeviceWatcher , который следит за рекламодателями, которые соответствуют строке запроса. При обнаружении рекламодателя решите, следует ли использовать этого рекламодателя программным способом или путем запроса у пользователя указать выбор.
  3. После того как ваш искатель определил нужного рекламодателя службы, вызовите статический метод FromIdAsync с идентификатором устройства выбранного рекламодателя. FromIdAsync извлекает экземпляр WiFiDirectService для запрошенной службы на запрошенном устройстве.
  4. Перейдите к созданию сеанса, вызвав 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-секундное ожидание, прежде чем истечет время ожидания запроса сеанса, чтобы дать серверу время для завершения операции. Аргументы события включают буфер, предоставленный сервером в уведомлении об отсрочке с дополнительными сведениями.

Применяется к