Espruino:Справочник по API/Библиотека WiFi/startAP(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
Строка 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().
Примеры
См.также
Внешние ссылки