Espruino:Справочник по API/Библиотека WiFi/startAP(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[https://www.espruino.com/Reference#l_Wifi_startAP www.espruino.com - require("Wifi").startAP(ssid, options, callback)]</ref>=
=Функция Wifi.startAP()<ref>[https://www.espruino.com/Reference#l_Wifi_startAP www.espruino.com - require("Wifi").startAP(ssid, options, callback)]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
require("Wifi").startAP(ssid, options, callback)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


 
* '''ssid''' – ID сети
* '''options''' – опциональный объект с настройками
* '''callback''' – опциональная функция callback(err), вызываемая после попытки запуска точки доступа. При успешном запуске в err будет null, а при неуспешном – строка с ошибкой


==Возвращаемое значение==
==Возвращаемое значение==
Строка 21: Строка 23:
==Описание==
==Описание==


Создает точку WiFi-доступа, к которой могут подключаться станции. Если в свойстве password будет пустая строка или null, соединение будет открыто, а если нет, то зашифровано. Функция callback(err) вызывается после попытки создания точки доступа: в случае успеха в аргументе err будет null, а в случае неудачи – строка с сообщением об ошибке.
В объекте options содержится следующее:
* '''authMode''' – метод аутентификации. Возможные варианты: "open", "wpa2", "wpa", "wpa_wpa2". По умолчанию точка доступа открыта для подключения ("open"), но оставлять ее открытой не рекомендуется.
* '''password''' – пароль для подключения станций к точке доступа (если в authMode не задано открытое соединение).
* '''channel''' – канал, используемый для точки доступа (1-13). Если устройство в роли станции также подключено к другой точке доступа, то канал будет определяться той другой точкой доступа.
* '''hidden''' – здесь задается, будет ли точка доступа видимой или нет (0 – видима, 1 – скрыта). По умолчанию видима.


'''Примечания:'''
* В будущем в объект options будет добавлено свойство для [[IP-адрес]]а и маски подсети точки доступа.
* Запуск startAP() автоматически включает режим точки доступа. Чтобы отключить его, воспользуйтесь stopAP().


== Примеры ==
== Примеры ==

Версия от 17:50, 28 февраля 2021

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция Wifi.startAP()[1]

Синтаксис

require("Wifi").startAP(ssid, options, callback)

Параметры

  • ssid – ID сети
  • options – опциональный объект с настройками
  • callback – опциональная функция callback(err), вызываемая после попытки запуска точки доступа. При успешном запуске в err будет null, а при неуспешном – строка с ошибкой

Возвращаемое значение

Описание

Создает точку WiFi-доступа, к которой могут подключаться станции. Если в свойстве password будет пустая строка или null, соединение будет открыто, а если нет, то зашифровано. Функция callback(err) вызывается после попытки создания точки доступа: в случае успеха в аргументе err будет null, а в случае неудачи – строка с сообщением об ошибке.

В объекте options содержится следующее:

  • authMode – метод аутентификации. Возможные варианты: "open", "wpa2", "wpa", "wpa_wpa2". По умолчанию точка доступа открыта для подключения ("open"), но оставлять ее открытой не рекомендуется.
  • password – пароль для подключения станций к точке доступа (если в authMode не задано открытое соединение).
  • channel – канал, используемый для точки доступа (1-13). Если устройство в роли станции также подключено к другой точке доступа, то канал будет определяться той другой точкой доступа.
  • hidden – здесь задается, будет ли точка доступа видимой или нет (0 – видима, 1 – скрыта). По умолчанию видима.

Примечания:

  • В будущем в объект options будет добавлено свойство для IP-адреса и маски подсети точки доступа.
  • Запуск startAP() автоматически включает режим точки доступа. Чтобы отключить его, воспользуйтесь stopAP().

Примеры

См.также

Внешние ссылки