MajorDoMo инфо - Вклад [ru]

Telegram модуль

2020-02-10T09:12:13Z

George2017: /* Пример использования модуля для отправки сообщений в своих скрип… */

[[Category:Модули]]

Автор: Eraser от Чт фев 11, 2016

==Описание==

Модуль для интеграции с '''Telegram'''
Позволяет получать в телеграм сообщения истории, а так же различные уведомления как текстом, так и изображениями, видео и тд

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Взаимодействие''' - '''Telegram bot'''.

==На данный момент умеет==

- регистрировать пользователей

- отправлять сообщения системы (определенного уровня важности)

- принимать команды

- создает в приложении Telegram клавиатуру с шаблонами команд

- прием файлов

- проигрывание голосовых сообщений

- обработчики событий

- сортировка команд

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=38929#p38929 webhook]

- экспорт/импорт команд и событий

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1100#p92922 отправка несколько фотографий (альбом)]

'''Внимание!''' На территории стран, где мессенджер Telegram заблокирован, модуль работает только через зарубежный прокси-сервер или VPN.

'''HOWTO'''

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&p=62657#p62644 Управляем "Online радио"]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=10#p30050 Если бот не запускается и не реагирует на /start]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65034 Отправка изображения с камеры или график pChart]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65005 Отправляем видео с RTSP потока в виде gif]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=100#p31646 Формирование своей клавиатуры]

- [https://www.youtube.com/watch?v=ze0vJOxx-qM Видео по первоначальной настройке бота]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=160#p33476 Постинг новостей из модуля RSS в канал телеграмм]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=580#p65089 Отправка в командах сообщения только пользователю который дал команду]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65152#p65152 Получение изображения с rtsp потока с камеры в linux]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=57110#p57110 Получение изображения с rtsp потока с камеры в Windows]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=280#p38752 Создание меню с отображением статуса]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=290#p38782 Eще одно довольно интересное решение интерактивной клавиатуры]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=530#p61751 Пример использования всплывающего сообщения]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65168#p65168 Вставка в сообщение от бота смайлов]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=75217#p75217 Скрины с онлайн трансляций youtube и других ресурсов онлайн трансляций.]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1120#p94952 Локальный Tor-прокси для модуля]

Варианты меню: '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65295#p65295 меню1]''', '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=390#p40727 меню2]'''

==Регистрация бота==

Для работы модуля необходимо зарегистрировать бота и получить его уникальный id, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather.

Пишем ему /start и получаем список всех его команд.

Первая и главная — /newbot — отправляем ему и бот просит придумать имя нашему новому боту как оно будет отображаться, можно русские буквы, имя не уникальное. После ввода имени предложит ввести уникальный логин боту латиницей и единственное ограничение на имя — в конце оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты, иначе придется поломать голову над именем.

Далее заходим к боту и вводим /start в ответ Вы должны увидеть что бот зарегистрирован, получается не сразу

В настройки модуля вносится токен бота вида "123456780:AAHeВ7UcDWvEovvcFaMfUrUVPupNORHWD_k"

==История изменений==

06.06.2016 Сортировка команд

03.03.2016 Расширенная настройка доступа к командам

01.03.2016 Локализация, помощь

24.02.2016 Отправка сообщений, изображений из пользовательских скриптов

23.02.2016 Отправка сообщений системы определенного уровня важности

16.02.2016 Сохранение файла из сообщения

15.02.2016 Шаблоны команд

13.02.2016 Обработка команд

11.02.2016 Первая альфа версия

==Пример использования модуля для отправки сообщений в своих скрип…==

{{#spoiler:show=show_message|hide=hide_message|}}
include(DIR_MODULES . 'telegram/telegram.class.php');

$telegram_module = new telegram();

$telegram_module->sendMessageToUser(139809588 ,"test message");

$telegram_module->sendMessageToAdmin("test message to admin");

$telegram_module->sendMessageToAll("test message to all");

$telegram_module->sendImageToUser(139809588 ,'/var/www/images/trees.jpg');

$telegram_module->sendImageToAdmin('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendImageToAll('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendVideoToUser(139809588, '/var/www/files/file.mp4', 'Description');

$telegram_module->sendVideoToAdmin('/var/www/files/file.mp4');

$telegram_module->sendVideoToAll('/var/www/files/file.mp4');

'''[https://github.com/Anisan/majordomo-telegram/archive/master.zip Архив с модулем]'''

'''[https://telegram.me/Eraser1981 Связаться с автором]'''

Telegram модуль

2020-02-08T12:03:38Z

George2017: /* Пример использования модуля для отправки сообщений в своих скрип… */

[[Category:Модули]]

Автор: Eraser от Чт фев 11, 2016

==Описание==

Модуль для интеграции с '''Telegram'''
Позволяет получать в телеграм сообщения истории, а так же различные уведомления как текстом, так и изображениями, видео и тд

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Взаимодействие''' - '''Telegram bot'''.

==На данный момент умеет==

- регистрировать пользователей

- отправлять сообщения системы (определенного уровня важности)

- принимать команды

- создает в приложении Telegram клавиатуру с шаблонами команд

- прием файлов

- проигрывание голосовых сообщений

- обработчики событий

- сортировка команд

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=38929#p38929 webhook]

- экспорт/импорт команд и событий

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1100#p92922 отправка несколько фотографий (альбом)]

'''Внимание!''' На территории стран, где мессенджер Telegram заблокирован, модуль работает только через зарубежный прокси-сервер или VPN.

'''HOWTO'''

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&p=62657#p62644 Управляем "Online радио"]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=10#p30050 Если бот не запускается и не реагирует на /start]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65034 Отправка изображения с камеры или график pChart]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65005 Отправляем видео с RTSP потока в виде gif]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=100#p31646 Формирование своей клавиатуры]

- [https://www.youtube.com/watch?v=ze0vJOxx-qM Видео по первоначальной настройке бота]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=160#p33476 Постинг новостей из модуля RSS в канал телеграмм]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=580#p65089 Отправка в командах сообщения только пользователю который дал команду]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65152#p65152 Получение изображения с rtsp потока с камеры в linux]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=57110#p57110 Получение изображения с rtsp потока с камеры в Windows]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=280#p38752 Создание меню с отображением статуса]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=290#p38782 Eще одно довольно интересное решение интерактивной клавиатуры]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=530#p61751 Пример использования всплывающего сообщения]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65168#p65168 Вставка в сообщение от бота смайлов]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=75217#p75217 Скрины с онлайн трансляций youtube и других ресурсов онлайн трансляций.]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1120#p94952 Локальный Tor-прокси для модуля]

Варианты меню: '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65295#p65295 меню1]''', '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=390#p40727 меню2]'''

==Регистрация бота==

Для работы модуля необходимо зарегистрировать бота и получить его уникальный id, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather.

Пишем ему /start и получаем список всех его команд.

Первая и главная — /newbot — отправляем ему и бот просит придумать имя нашему новому боту как оно будет отображаться, можно русские буквы, имя не уникальное. После ввода имени предложит ввести уникальный логин боту латиницей и единственное ограничение на имя — в конце оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты, иначе придется поломать голову над именем.

Далее заходим к боту и вводим /start в ответ Вы должны увидеть что бот зарегистрирован, получается не сразу

В настройки модуля вносится токен бота вида "123456780:AAHeВ7UcDWvEovvcFaMfUrUVPupNORHWD_k"

==История изменений==

06.06.2016 Сортировка команд

03.03.2016 Расширенная настройка доступа к командам

01.03.2016 Локализация, помощь

24.02.2016 Отправка сообщений, изображений из пользовательских скриптов

23.02.2016 Отправка сообщений системы определенного уровня важности

16.02.2016 Сохранение файла из сообщения

15.02.2016 Шаблоны команд

13.02.2016 Обработка команд

11.02.2016 Первая альфа версия

==Пример использования модуля для отправки сообщений в своих скрип…==

{{#spoiler:show=show_message|hide=hide_message|}}
include(DIR_MODULES . 'telegram/telegram.class.php');

$telegram_module = new telegram();

$telegram_module->sendMessageToUser(139809588 ,"test message");

$telegram_module->sendMessageToAdmin("test message to admin");

$telegram_module->sendMessageToAll("test message to all");

$telegram_module->sendImageToUser(139809588 ,'/var/www/images/trees.jpg');

$telegram_module->sendImageToAdmin('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendImageToAll('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendVideoToUser(139809588, '/var/www/files/file.mp4', 'Description');

$telegram_module->sendVideoToAdmin('/var/www/files/file.mp4');

$telegram_module->sendVideoToAll('/var/www/files/file.mp4');}}

'''[https://github.com/Anisan/majordomo-telegram/archive/master.zip Архив с модулем]'''

'''[https://telegram.me/Eraser1981 Связаться с автором]'''

Тест

2020-02-08T11:58:02Z

George2017:

Тест
== Тестовый заголовок ==
Немного текста для проверки редактора 
Теперь новая строка 
'''Теперь пишем жирным'''
Теперь ещё немного текста 

А теперь
#перенаправление [[GetGlobal]]
 
А теперь хеш тег или метка #тест
<ref>реф</ref>

<youtube>ibeKX9A3ZTs</youtube>

проверка
[[Файл:Client1.png|мини|xf]]

{{#spoiler:hide=hide_message|spoiler_text}}

{{#spoiler:show=show_message|spoiler_text}}

{{#spoiler:show=show_message|hide=hide_message|проверка текста spoiler_text}}

{{#spoiler:spoiler_text}}

Тест

2020-02-08T11:57:17Z

George2017:

Broadlink модуль

2020-02-07T22:44:42Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: nick7zmail от Вт янв 03, 2017

==Описание==

Модуль сопряжения '''Broadlink'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Оборудование''' - '''Broadlink (by nick7zmail)'''.

Собрал всё в один модуль, надеюсь - ничего не сломал. После установки можно выбрать API.

[[Файл:Рис. 1.jpg|800px|мини|центр|рис. 1]]

'''О каждом из них по-подробнее:'''

1) '''RM-bridge'''

Кто бы что не говорил - это самый простой способ управления командами. Просто ставите приложение с маркета, вводите ip/port в нужные поля - и готово, записываете, просматриваете команды...

2) '''BroadlinkHTTPBridge'''

Все тот же модуль для http - бриджа...функционал не менял/не урезал/не добавлял...пока все на том же уровне, хотя есть куда улучшать. Работает с той же таблицей, что и предыдущий)

3) '''PHP'''

Самостоятельный PHP модуль, работающий без бриджа.

Собственно сам модуль (на гитхабе) https://github.com/nick7zmail/MajorDoMo-dev_broadlink

'''Поддержать разработку либо поблагодарить разработчика вы можете тут http://connect.smartliving.ru/tasks/5.html'''

'''Обновления:'''

-22.01.17 - Добавлено PHP-api подробнее

-24.01.17 - Добавлена поддержка A1 air и RM3 mini в php подробнее

-02.02.17 - Добавлена поддержка розеток sp2/3/cc/mini в php подробнее

-10.02.17 - Поддержка MP1 в php подробнее

-20.04.17 - Большое обновление функционала подробнее

-25.04.17 - Полная поддержка sp3 (в том числе ночник) подробнее

-28.04.17 - Обновление вызова команд подробнее

-29.04.17 - Интеграция с модулем "Простые устройства" подробнее

-17.06.17 - Поддержка S1/S1c и выключателя SC1 подробнее

-22.06.17 - Сохранение ключей авторизации, расширение функций s1 подробнее

-12.07.17 - Добавлены новые устройства из e-control, исправлена ошибка с температурой 249 на RM подробнее

-19.07.17 - Добавлены функции MS1 и класс в библиотеке для карнизов dooya подробнее

==Полезная информация:==

'''Общее'''

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=43894#p43894 Добавление нового устройства (PHP)]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=44446#p44446 Немного о моделях устройств (PHP)]

'''RM''' (1,2,3,mini,pro,pro+)

==[http://majordomo.smartliving.ru/forum/viewtopic.php?p=43894#p43894 Обучение командам (PHP)]==

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=45727#p45727 Как работать с записанными командами (PHP, через объект.свойство, инструкция с картинками =) )]

==[http://majordomo.smartliving.ru/forum/viewtopic.php?p=54054#p54054 Создание выключателя (Простые устройства, инструкция с картинками)]==

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=51723#p51723 Активация команд кодом]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=50309#p50309 Настройка кондиционера]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=49980#p49980 Про датчик температуры в RM2]

'''А1'''

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=47445#p47445 Данные, которые приходят с А1]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=51858#p51858 Пример сцены А1]

'''MS1'''

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=52257#p52257 Про колонку MS1]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=52297#p52297 Про колонку MS1 (продолжение)]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=56418#p56418 Функции в модуле]

==Проблемы и их решения:==

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=56029#p56029 Не работает сканирование устройств]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=56204#p56204 Перевернут IP]

==Связанные темы:==

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2619 Про модуль RM-bridge]

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=3057 Про httpbridge]

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=14&t=3313 Про подключение без бриджа]

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=8&t=3740 Отдельная тема по выключателям LIVOLO] (для них команды почему-то не
записываются с облачных пультов e-control'а...но решение есть - [http://majordomo.smartliving.ru/forum/viewtopic.php?p=47775#p47775 КОДЫ УПРАВЛЕНИЯ LIVOLO])

Broadlink модуль

2020-02-07T22:42:16Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: nick7zmail от Вт янв 03, 2017

==Описание==

Модуль сопряжения '''Broadlink'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Оборудование''' - '''Broadlink (by nick7zmail)'''.

Собрал всё в один модуль, надеюсь - ничего не сломал. После установки можно выбрать API.

[[Файл:Рис. 1.jpg|800px|мини|центр|рис. 1]]

'''О каждом из них по-подробнее:'''

1) RM-bridge

Кто бы что не говорил - это самый простой способ управления командами. Просто ставите приложение с маркета, вводите ip/port в нужные поля - и готово, записываете, просматриваете команды...

2) BroadlinkHTTPBridge

Все тот же модуль для http - бриджа...функционал не менял/не урезал/не добавлял...пока все на том же уровне, хотя есть куда улучшать. Работает с той же таблицей, что и предыдущий)

3) PHP

Самостоятельный PHP модуль, работающий без бриджа.

Собственно сам модуль (на гитхабе) https://github.com/nick7zmail/MajorDoMo-dev_broadlink

'''Поддержать разработку либо поблагодарить разработчика вы можете тут http://connect.smartliving.ru/tasks/5.html'''

'''Обновления:'''

-22.01.17 - Добавлено PHP-api подробнее

-24.01.17 - Добавлена поддержка A1 air и RM3 mini в php подробнее

-02.02.17 - Добавлена поддержка розеток sp2/3/cc/mini в php подробнее

-10.02.17 - Поддержка MP1 в php подробнее

-20.04.17 - Большое обновление функционала подробнее

-25.04.17 - Полная поддержка sp3 (в том числе ночник) подробнее

-28.04.17 - Обновление вызова команд подробнее

-29.04.17 - Интеграция с модулем "Простые устройства" подробнее

-17.06.17 - Поддержка S1/S1c и выключателя SC1 подробнее

-22.06.17 - Сохранение ключей авторизации, расширение функций s1 подробнее

-12.07.17 - Добавлены новые устройства из e-control, исправлена ошибка с температурой 249 на RM подробнее

-19.07.17 - Добавлены функции MS1 и класс в библиотеке для карнизов dooya подробнее

=='''Полезная информация''':==

'''Общее'''

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=43894#p43894 Добавление нового устройства (PHP)]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=44446#p44446 Немного о моделях устройств (PHP)]

'''RM''' (1,2,3,mini,pro,pro+)

==[http://majordomo.smartliving.ru/forum/viewtopic.php?p=43894#p43894 Обучение командам (PHP)]==

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=45727#p45727 Как работать с записанными командами (PHP, через объект.свойство, инструкция с картинками =) )]

==[http://majordomo.smartliving.ru/forum/viewtopic.php?p=54054#p54054 Создание выключателя (Простые устройства, инструкция с картинками)]==

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=51723#p51723 Активация команд кодом]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=50309#p50309 Настройка кондиционера]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=49980#p49980 Про датчик температуры в RM2]

'''А1'''

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=47445#p47445 Данные, которые приходят с А1]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=51858#p51858 Пример сцены А1]

'''MS1'''

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=52257#p52257 Про колонку MS1]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=52297#p52297 Про колонку MS1 (продолжение)]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=56418#p56418 Функции в модуле]

==Проблемы и их решения:==

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=56029#p56029 Не работает сканирование устройств]

[http://majordomo.smartliving.ru/forum/viewtopic.php?p=56204#p56204 Перевернут IP]

==Связанные темы:==

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2619 Про модуль RM-bridge]

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=3057 Про httpbridge]

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=14&t=3313 Про подключение без бриджа]

[http://majordomo.smartliving.ru/forum/viewtopic.php?f=8&t=3740 Отдельная тема по выключателям LIVOLO] (для них команды почему-то не
записываются с облачных пультов e-control'а...но решение есть - [http://majordomo.smartliving.ru/forum/viewtopic.php?p=47775#p47775 КОДЫ УПРАВЛЕНИЯ LIVOLO])

Файл:Рис. 1.jpg

2020-02-07T22:26:06Z

George2017:

рис.1

Telegram модуль

2020-02-07T22:14:44Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: Eraser от Чт фев 11, 2016

==Описание==

Модуль для интеграции с '''Telegram'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Взаимодействие''' - '''Telegram bot'''.

==На данный момент умеет==

- регистрировать пользователей

- отправлять сообщения системы (определенного уровня важности)

- принимать команды

- создает в приложении Telegram клавиатуру с шаблонами команд

- прием файлов

- проигрывание голосовых сообщений

- обработчики событий

- сортировка команд

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=38929#p38929 webhook]

- экспорт/импорт команд и событий

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1100#p92922 отправка несколько фотографий (альбом)]

'''Внимание!''' На территории стран, где мессенджер Telegram заблокирован, модуль работает только через зарубежный прокси-сервер или VPN.

'''HOWTO'''

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&p=62657#p62644 Управляем "Online радио"]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=10#p30050 Если бот не запускается и не реагирует на /start]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65034 Отправка изображения с камеры или график pChart]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65005 Отправляем видео с RTSP потока в виде gif]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=100#p31646 Формирование своей клавиатуры]

- [https://www.youtube.com/watch?v=ze0vJOxx-qM Видео по первоначальной настройке бота]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=160#p33476 Постинг новостей из модуля RSS в канал телеграмм]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=580#p65089 Отправка в командах сообщения только пользователю который дал команду]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65152#p65152 Получение изображения с rtsp потока с камеры в linux]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=57110#p57110 Получение изображения с rtsp потока с камеры в Windows]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=280#p38752 Создание меню с отображением статуса]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=290#p38782 Eще одно довольно интересное решение интерактивной клавиатуры]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=530#p61751 Пример использования всплывающего сообщения]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65168#p65168 Вставка в сообщение от бота смайлов]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=75217#p75217 Скрины с онлайн трансляций youtube и других ресурсов онлайн трансляций.]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1120#p94952 Локальный Tor-прокси для модуля]

Варианты меню: '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65295#p65295 меню1]''', '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=390#p40727 меню2]'''

==Регистрация бота==

Для работы модуля необходимо зарегистрировать бота и получить его уникальный id, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather.

Пишем ему /start и получаем список всех его команд.

Первая и главная — /newbot — отправляем ему и бот просит придумать имя нашему новому боту как оно будет отображаться, можно русские буквы, имя не уникальное. После ввода имени предложит ввести уникальный логин боту латиницей и единственное ограничение на имя — в конце оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты, иначе придется поломать голову над именем.

Далее заходим к боту и вводим /start в ответ Вы должны увидеть что бот зарегистрирован, получается не сразу

В настройки модуля вносится токен бота вида "123456780:AAHeВ7UcDWvEovvcFaMfUrUVPupNORHWD_k"

==История изменений==

06.06.2016 Сортировка команд

03.03.2016 Расширенная настройка доступа к командам

01.03.2016 Локализация, помощь

24.02.2016 Отправка сообщений, изображений из пользовательских скриптов

23.02.2016 Отправка сообщений системы определенного уровня важности

16.02.2016 Сохранение файла из сообщения

15.02.2016 Шаблоны команд

13.02.2016 Обработка команд

11.02.2016 Первая альфа версия

==Пример использования модуля для отправки сообщений в своих скрип…==

include(DIR_MODULES . 'telegram/telegram.class.php');

$telegram_module = new telegram();

$telegram_module->sendMessageToUser(139809588 ,"test message");

$telegram_module->sendMessageToAdmin("test message to admin");

$telegram_module->sendMessageToAll("test message to all");

$telegram_module->sendImageToUser(139809588 ,'/var/www/images/trees.jpg');

$telegram_module->sendImageToAdmin('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendImageToAll('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendVideoToUser(139809588, '/var/www/files/file.mp4', 'Description');

$telegram_module->sendVideoToAdmin('/var/www/files/file.mp4');

$telegram_module->sendVideoToAll('/var/www/files/file.mp4');

'''[https://github.com/Anisan/majordomo-telegram/archive/master.zip Архив с модулем]'''

'''[https://telegram.me/Eraser1981 Связаться с автором]'''

Telegram модуль

2020-02-07T12:33:53Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: Eraser от Чт фев 11, 2016

==Описание==

Модуль для интеграции с '''Telegram'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Взаимодействие'''- '''Telegram bot'''.

==На данный момент умеет==

- регистрировать пользователей

- отправлять сообщения системы (определенного уровня важности)

- принимать команды

- создает в приложении Telegram клавиатуру с шаблонами команд

- прием файлов

- проигрывание голосовых сообщений

- обработчики событий

- сортировка команд

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=38929#p38929 webhook]

- экспорт/импорт команд и событий

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1100#p92922 отправка несколько фотографий (альбом)]

'''Внимание!''' На территории стран, где мессенджер Telegram заблокирован, модуль работает только через зарубежный прокси-сервер или VPN.

'''HOWTO'''

- [http://majordomo.smartliving.ru/forum/viewtopic.php?f=5&p=62657#p62644 Управляем "Online радио"]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=10#p30050 Если бот не запускается и не реагирует на /start]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65034 Отправка изображения с камеры или график pChart]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65034#p65005 Отправляем видео с RTSP потока в виде gif]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=100#p31646 Формирование своей клавиатуры]

- [https://www.youtube.com/watch?v=ze0vJOxx-qM Видео по первоначальной настройке бота]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=160#p33476 Постинг новостей из модуля RSS в канал телеграмм]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=580#p65089 Отправка в командах сообщения только пользователю который дал команду]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65152#p65152 Получение изображения с rtsp потока с камеры в linux]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=57110#p57110 Получение изображения с rtsp потока с камеры в Windows]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=280#p38752 Создание меню с отображением статуса]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=290#p38782 Eще одно довольно интересное решение интерактивной клавиатуры]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=530#p61751 Пример использования всплывающего сообщения]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65168#p65168 Вставка в сообщение от бота смайлов]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=75217#p75217 Скрины с онлайн трансляций youtube и других ресурсов онлайн трансляций.]

- [https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=1120#p94952 Локальный Tor-прокси для модуля]

Варианты меню: '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&p=65295#p65295 меню1]''', '''[https://majordomo.smartliving.ru/forum/viewtopic.php?f=5&t=2768&start=390#p40727 меню2]'''

==Регистрация бота==

Для работы модуля необходимо зарегистрировать бота и получить его уникальный id, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather.

Пишем ему /start и получаем список всех его команд.

Первая и главная — /newbot — отправляем ему и бот просит придумать имя нашему новому боту как оно будет отображаться, можно русские буквы, имя не уникальное. После ввода имени предложит ввести уникальный логин боту латиницей и единственное ограничение на имя — в конце оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты, иначе придется поломать голову над именем.

Далее заходим к боту и вводим /start в ответ Вы должны увидеть что бот зарегистрирован, получается не сразу

В настройки модуля вносится токен бота вида "123456780:AAHeВ7UcDWvEovvcFaMfUrUVPupNORHWD_k"

==История изменений==

06.06.2016 Сортировка команд

03.03.2016 Расширенная настройка доступа к командам

01.03.2016 Локализация, помощь

24.02.2016 Отправка сообщений, изображений из пользовательских скриптов

23.02.2016 Отправка сообщений системы определенного уровня важности

16.02.2016 Сохранение файла из сообщения

15.02.2016 Шаблоны команд

13.02.2016 Обработка команд

11.02.2016 Первая альфа версия

==Пример использования модуля для отправки сообщений в своих скрип…==

include(DIR_MODULES . 'telegram/telegram.class.php');

$telegram_module = new telegram();

$telegram_module->sendMessageToUser(139809588 ,"test message");

$telegram_module->sendMessageToAdmin("test message to admin");

$telegram_module->sendMessageToAll("test message to all");

$telegram_module->sendImageToUser(139809588 ,'/var/www/images/trees.jpg');

$telegram_module->sendImageToAdmin('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendImageToAll('/var/www/images/htc_hero_wallpaper_01.jpg');

$telegram_module->sendVideoToUser(139809588, '/var/www/files/file.mp4', 'Description');

$telegram_module->sendVideoToAdmin('/var/www/files/file.mp4');

$telegram_module->sendVideoToAll('/var/www/files/file.mp4');

'''[https://github.com/Anisan/majordomo-telegram/archive/master.zip Архив с модулем]'''

'''[https://telegram.me/Eraser1981 Связаться с автором]'''

API.AI модуль

2020-01-27T20:38:45Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: SergeJey от Чт янв 26, 2017

==Описание==

Модуль '''API.AI'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Взаимодействие''' - '''API.AI (by SergeJey)'''.

==Настройка==

Для начала работы модуля необходимо зарегистрироваться на вышеобозначенном сервисе и получить ключ (Client access token), далее ввести ключ в окно настроек:

[[Файл:3GPyUGz.png|800px|мини|центр|Настройка]]

Кроме ключа есть ещё следующие настройки:

Language -- язык

Voice priority level -- голосовой приоритет ответов бота (бот отвечает функцией sayReply, в которую передаётся заданный приоритет)

Process unknown inputs -- да/нет -- озвучивать ответ от бота, если он ответил сообщением типа "правило не найдено"

После ввода настроек '''система''' предоставляет поле для '''ввода текста''' -- его можно использовать для '''тестирования'''.

==Кратко как вообще работает сервис API.AI==

Сервис API.AI служит для перевода человеческих запросов в формальный вид, понятный машине. В качестве обработчиков выступают так называемые агенты -- их пользователь создаёт сам, а так же прописывает правила обработки текста и возможные действия. По сути, те же "шаблоны поведения", только гораздо более навороченные в плане настройки правил, плюс "фишки" типа машинного обучения для возможности нечёткого формулирования запросов. Фактически, на вход подаётся текст, а на выходе получается название функции, которую необходимо выполнить, с параметрами, которые бот выяснил в процессе общения. Модуль к MajorDoMo обеспечивает общение с ботом через все имеющиеся методы, а так же сохраняет процедуры, которые бот возвращает в систему -- возвращается название процедуры и параметры, так что непосредственную реализацию процедуры необходимо задать в панели управления модулем.

[[Файл:3GPyMSo.png|800px|мини|центр|Тест]]

Например, если мы подключили к нашему боту домен alarm clock из примеров и мы говорим боту "alarm 8pm every day", то система автоматически создаст пустую процедуру alarm.set, которая будет вызываться с параметрами $params['date'], $params['recurrence'] и !$params['time']:

[[Файл:3GPyqyc.png|800px|мини|центр|Пример]]

P.S. в альфа версию внесён ряд изменений для улучшения обработки событий, так что в стандартной версии возможны некоторые глюки с работой модуля.

Файл:3GPyqyc.png

2020-01-27T20:38:00Z

George2017:

Пример

Файл:3GPyMSo.png

2020-01-27T20:36:40Z

George2017:

Тест

Файл:3GPyUGz.png

2020-01-27T20:33:22Z

George2017:

Настройка

Auto Diagnostics модуль

2020-01-27T20:24:03Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: SergeJey от 2018-06-05

==Системное имя модуля autodiagnostics==

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Система'''- '''Auto Diagnostics'''.

==Описание модуля==

Автоматическая отправка диагностической информации в сервис CONNECT. Данный модуль является инструментом интегратора для автоматического сбора состояния контролируемых объектов. Модуль периодически отправляет базовую информацию о состоянии различных частей системы на сервер CONNECT, где она автоматически анализируется и, в случае обнаружения явных проблем, создаётся уведомление с информацией о том, что выглядит "подозрительно" и может привести к нестабильной работе системы.

Привязка данных к аккаунту интегратора задаётся в настройке модуля.

Simple Devices addon (Xiaomi Gateway RGB) - Модуль дополнение

2020-01-27T20:13:58Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: Logrus от 2020-01-05

==Описание==

Дополнение Simple Devices addon (Xiaomi Gateway RGB)

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Модификация'''- '''Simple Devices addon (Xiaomi Gateway RGB) '''.

==Общие сведения==

Добавляет в Панель управления/devices новый тип ПУ XiGateway,
позволяет из модуля xiaomihome в дереве классов/объектов SDevices/SControllers/SXiGatewayRGB
привязать метрики rgb в свойство color и brightness в свойство brightness
для управления цветом и яркостью подсветки шлюза.

вызов по требованию/событию:

callMethod('ОБЪЕКТ.action', array('brightness'=>'100','color'=>'0000ff','timer'=>'60'));

callMethod('ОБЪЕКТ.action', array('color'=> '0000ff', 'timer'=> '30')); //установка цвета на определенный интервал, далее в зависимости от свойства actionRGB при 0 - отключится, при 1 - установится в зависимости от состояний режимов:
NobodyHomeMode.active 0 - кто-то дома, color = '00ff00' или в зависимости от состояний System.stateColor при красном color = 'ff0000', System.stateColor или Communication.stateColor при желтом color = 'ffcd00', brightness = 50 или 10 в зависимости от DarknessMode.active

(Темное время суток)

NobodyHomeMode.active 1 - никого нет дома, color = '000000', т.е. отключена

NobodyHomeMode.active 2 - все спят, color = 'cd00ff', brightness = 5

Голосовые команды:

включи|зажги "название ПУ"

выключи|потуши|отключи "название ПУ"

включи|зажги "название ПУ" на "число" секунд|минут|часов

выключи|потуши|отключи "название ПУ" через "число" секунд|минут|часов

яркость "название ПУ" "число"

цвет|свет "название ПУ" белый|перламутровый|фиолетовый|индиго|синий|голубой|зелёный|жёлтый|оранжевый|красный

[[Файл:450 image.png|800px|мини|центр|Панель управления]]

[[Файл:451 image.png|800px|мини|центр|Простые устройства]]

[[Файл:453 image.png|800px|мини|центр|Панель управления (настройки)]]

[[Файл:454 image.png|800px|мини|центр|Панель управления (классы)]]

[[Файл:596 image.png|800px|мини|центр|Как вариант]]

Файл:596 image.png

2020-01-27T20:13:31Z

George2017:

Как вариант

Файл:454 image.png

2020-01-27T20:12:04Z

George2017:

Панель управления (классы)

Файл:453 image.png

2020-01-27T20:10:54Z

George2017:

Панель управления (настройки)

Файл:451 image.png

2020-01-27T20:09:03Z

George2017:

Простые устройства

Файл:450 image.png

2020-01-27T20:07:56Z

George2017:

Панель управления

Rules Простые правила

2020-01-26T09:59:25Z

George2017: создание новой страницы

[[Category:Модули]]

'''Автор''': sergejey от Вт. июл 26, 2016

==Описание==

Данный модуль предназначен для описание человеческим языком правил функционирования системы.

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Система'''- '''Rules'''.

[[Файл:3AAuAMz.png|800px|мини|центр|пример]]

Добавлять правила проще простого -- просто заполняете как хотите два поля: '''ЕСЛИ''' и '''ТОГДА'''. Система создаст черновые записи в разделе '''Условия''' и '''Действия''', которые необходимо в будущем реализовать и активировать, чтобы правило заработало. Условий можно задавать несколько используя в качестве разделителей слова ''"и"/"или"''. Реализованные условия и действия могут использоваться повторно в разных правилах, т.е. одинаковые сущности не создаются. "'''Активатором'''" для правил является изменение связанного ''объекта/свойства'', прописанного у условной части правила. ''Неактивные'' части правил обозначаются ''красным цветом''.

Для чего был сделан этот модуль и зачем такая избыточность, при наличии других средств настройки реакции -- для того, чтобы разделить процесс оформления "''желания''" и процесс реализации. Если вы разрабатываете проект для кого-то на заказ или же хотите запланировать сценарии для себя, но пока не знаете, как их реализовать, то данный модуль может использоваться как наглядный список задач на будущее. Так же вы сможете в дальнейшем изменить любое действие ''и/или'' условие, не меняя связанных с ним правил.

''В качестве бонуса'' -- система начинает учитывать записи из раздела '''Действия''' при обработки текстовых ''(голосовых) команд'', т.е. если вы туда добавили запись '''"включи свет"''', то можете просто дать эту команду в чате ''(или голосом)'' и она будет выполнена без каких-либо условий.

SBoard Модуль

2020-01-26T00:48:08Z

George2017: создание новой страницы

[[Category:Модули]]
Автор: tkasyanov от Март 27, 2019

==Описание==

Модуль '''SBoard'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Модификация'''- '''SBoard'''.

После успешной установки в '''Панели управления''' в разделе '''Приложения''' появится пункт '''SBoard'''.

[[Файл:Screenshot 4.png|800px|мини|центр|Вид 1]]

И оттуда мы попадаем в начальное окно конфигураций модуля. Сначала нам надо добавить новую конфигурацию. Каждая новая конфигурация это отдельный дашборд, что может быть использован Вами в зависимости от потребностей и фантазии. Например, Вы можете использовать несколько конфигураций для каждого устройства что взаимодействует с Вашим умным домом

Чтобы добавить новую конфигурацию - жмем '''Добавить''' и заполняем обязательно свое Название дашборда. Например, '''Планшет''' и жмем '''Добавить'''!

[[Файл:Screenshot 5.png|800px|мини|центр|Вид 2]]

Переходим назад в окно конфигураций и видим список, пока что, только из одной конфигурации. Нажав на имя конфигурации попадаем уже в дашборд.

Дальше начинается самое интересное.

Перед нами собственно сам дашборд, который мы легкими движениями можем менять как нам хочется.

[[Файл:Screenshot 7.png|800px|мини|центр|Вид 3]]

Если нет необходимости использовать несколько конфигураций можно просто зайти по адресу http://ip_address/SBoard/ дефолтная конфигурация создастся автоматически.

[[Файл:Screenshot 8.png|800px|мини|центр|Вид 4]]

Слева меню выбора страниц и кнопка режима редактирования в виде '''карандаша'''.
Правее '''плитки''' – что есть самим основным элементом, на котором отображается информация из вашего Мажордомо, а также располагается элементы управления (кнопки, переключатели и др.)

Файл:Screenshot 8.png

2020-01-26T00:43:02Z

George2017:

Вид 4

Файл:Screenshot 7.png

2020-01-26T00:41:29Z

George2017:

Вид 3

Файл:Screenshot 5.png

2020-01-26T00:40:09Z

George2017:

Вид 2

Файл:Screenshot 4.png

2020-01-26T00:37:42Z

George2017:

Вид 1

Rules Простые правила

2020-01-23T11:43:57Z

George2017: создание новой страницы

[[Category:Модули]]

'''автор''': sergejey от Вт. июл 26, 2016

==Описание==

Данный модуль предназначен для описание человеческим языком правил функционирования системы.

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Система'''- '''Rules'''.

[[Файл:3AAuAMz.png|800px|мини|центр|пример]]

Добавлять правила проще простого -- просто заполняете как хотите два поля: '''ЕСЛИ''' и '''ТОГДА'''. Система создаст черновые записи в разделе '''Условия''' и '''Действия''', которые необходимо в будущем реализовать и активировать, чтобы правило заработало. Условий можно задавать несколько используя в качестве разделителей слова ''"и"/"или"''. Реализованные условия и действия могут использоваться повторно в разных правилах, т.е. одинаковые сущности не создаются. "'''Активатором'''" для правил является изменение связанного ''объекта/свойства'', прописанного у условной части правила. ''Неактивные'' части правил обозначаются ''красным цветом''.

Для чего был сделан этот модуль и зачем такая избыточность, при наличии других средств настройки реакции -- для того, чтобы разделить процесс оформления "''желания''" и процесс реализации. Если вы разрабатываете проект для кого-то на заказ или же хотите запланировать сценарии для себя, но пока не знаете, как их реализовать, то данный модуль может использоваться как наглядный список задач на будущее. Так же вы сможете в дальнейшем изменить любое действие ''и/или'' условие, не меняя связанных с ним правил.

''В качестве бонуса'' -- система начинает учитывать записи из раздела '''Действия''' при обработки текстовых ''(голосовых) команд'', т.е. если вы туда добавили запись '''"включи свет"''', то можете просто дать эту команду в чате ''(или голосом)'' и она будет выполнена без каких-либо условий.

SamsungTV модуль

2020-01-23T15:10:44Z

George2017: создание новой страницы

[[Category:Модули]]

Автор: '''vashal''' от 23.01.2020

==Описание==

Модуль управления телевизорами '''Samsung с TizenOS'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Оборудование''' - '''SamsungTV'''.

==Важно:==
ВНИМАНИЕ!!! Модуль работает с устройствами, выпущенными '''не ранее 2016 года''' и с обновленными прошивками.
'''Если вы ''ограничили загрузку обновлений'' на телевизор для взаимодействия с какими-либо программами, то, скорее всего, модуль ''не будет взаимодействовать'' с вашим устройством.'''

''''''Все действия''', связанные с обновлением вашего устройства, вы делаете ''на свой страх и риск и автор модуля не несет никакой ответственности за это''. Равно как и не гарантирует возможности взаимодействия модуля с вашим устройством после обновления.'''

==Общие сведения==

Модуль предназначен для интеграции смарт-телевизоров '''Samsung''' на платформе '''Tizen'''.

'''Возможности модуля:'''

- ручное добавление ТВ по IP адресу;

- поддержка нескольких ТВ;

- определение доступности ТВ;

- получение громкости ТВ;

- управление ТВ (каналы, источники, приложения, громкость, выключение).
Для добавления телевизора нажмите кнопку +Добавить, введите IP адрес и придумайте название телевизора. После нажатия кнопки Добавить телевизор запросит разрешение на сопряжение с модулем. Отвечаем утвердительно, и после этого телевизор появится в списке устройств в модуле

Так как '''Samsung''' не предоставляет '''открытое API''' для управления своими телевизорами, в модуле собрано несколько типов управления, ''добытых из открытых источников'':

- '''wss'''-соединение(SSL Websocket) на порту 8002 - отправка команд, запрос приложений, открытие сайтов встроенным браузером;

- '''POST''' запросы на порт 8001 для управления(запуск, закрытие, статус) приложениями;

- '''протокол''' SOAP на порту 9197 для считывания уровня громкости, установки громкости;

- '''Wake-on-lan''' для запуска выключенного телевизора (не испытывался на Wi-Fi соединении).

Модуль реализует классическую концепцию MajorDoMo для взаимодействия с пользователем через привязанные к определенным командам или приложениям свойства объекта. Объекты и свойства создаются пользователем самостоятельно. В модуле уже добавлены основные команды управления телевизором, но вы можете добавить свою. Список доступных команд см. ниже

В модуле имеется цикл, который раз в 10 секунд опрашивает состояние ТВ, а именно определяет, какое приложение запущено в данный момент, и запрашивает уровень громкости.

==Список команд==

Список ключей может различаться в зависимости от модели телевизора. Ниже приведены некоторые общие коды и их описания. Не все ключи могут работать конкретно на вашей модели телевизора.
Power keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_POWER||PowerToggle

|}
<hr>
Input keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_SOURCE||Source
|-
|KEY_COMPONENT1||Component1
|-
|KEY_COMPONENT2||Component2
|-
|KEY_AV1||AV1
|-
|KEY_AV2||AV2
|-
|KEY_AV3||AV3
|-
|KEY_SVIDEO1||SVideo1
|-
|KEY_SVIDEO2||SVideo2
|-
|KEY_SVIDEO3||SVideo3
|-
|KEY_HDMI||HDMI
|-
|KEY_HDMI1||HDMI1
|-
|KEY_HDMI2||HDMI2
|-
|KEY_HDMI3||HDMI3
|-
|KEY_HDMI4||HDMI4
|-
|KEY_FM_RADIO||FMRadio
|-
|KEY_DVI||DVI
|-
|KEY_DVR||DVR
|-
|KEY_TV||TV
|-
|KEY_ANTENA||AnalogTV
|-
|KEY_DTV||DigitalTV

|}
<hr>
Number keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_1|| 1
|-
|KEY_2|| 2
|-
|KEY_3|| 3
|-
|KEY_4|| 4
|-
|KEY_5|| 5
|-
|KEY_6|| 6
|-
|KEY_7|| 7
|-
|KEY_8|| 8
|-
|KEY_9|| 9
|-
|KEY_0|| 0

|}
<hr>
Misc keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_PANNEL_CHDOWN||3D
|-
|KEY_ANYNET||AnyNet+
|-
|KEY_ESAVING||EnergySaving
|-
|KEY_SLEEP||SleepTimer
|-
|KEY_DTV_SIGNAL||DTVSignal

|}
<hr>
Channel keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_CHUP||ChannelUp
|-
|KEY_CHDOWN||ChannelDown
|-
|KEY_PRECH||PreviousChannel
|-
|KEY_FAVCH||FavoriteChannels
|-
|KEY_CH_LIST||ChannelList
|-
|KEY_AUTO_PROGRAM||AutoProgram
|-
|KEY_MAGIC_CHANNEL||MagicChannel

|}
<hr>
Volume keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_VOLUP||VolumeUp
|-
|KEY_VOLDOWN||VolumeDown
|-
|KEY_MUTE||Mute

|}
<hr>
Direction keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_UP||NavigationUp
|-
|KEY_DOWN||NavigationDown
|-
|KEY_LEFT||NavigationLeft
|-
|KEY_RIGHT||NavigationRight
|-
|KEY_RETURN||NavigationReturn/Back
|-
|KEY_ENTER||NavigationEnter

|}
<hr>
Media keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_REWIND||Rewind
|-
|KEY_STOP||Stop
|-
|KEY_PLAY||Play
|-
|KEY_FF||FastForward
|-
|KEY_REC||Record
|-
|KEY_PAUSE||Pause
|-
|KEY_LIVE||Live
|-
|KEY_QUICK_REPLAY||fnKEY_QUICK_REPLAY
|-
|KEY_STILL_PICTURE||fnKEY_STILL_PICTURE
|-
|KEY_INSTANT_REPLAY||fnKEY_INSTANT_REPLAY

|}
<hr>
Picture in Picture
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_PIP_ONOFF||PIPOn/Off
|-
|KEY_PIP_SWAP||PIPSwap
|-
|KEY_PIP_SIZE||PIPSize
|-
|KEY_PIP_CHUP||PIPChannelUp
|-
|KEY_PIP_CHDOWN||PIPChannelDown
|-
|KEY_AUTO_ARC_PIP_SMALL||PIPSmall
|-
|KEY_AUTO_ARC_PIP_WIDE||PIPWide
|-
|KEY_AUTO_ARC_PIP_RIGHT_BOTTOM||PIPBottomRight
|-
|KEY_AUTO_ARC_PIP_SOURCE_CHANGE||PIPSourceChange
|-
|KEY_PIP_SCAN||PIPScan

|}
<hr>
Modes
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_VCR_MODE||VCRMode
|-
|KEY_CATV_MODE||CATVMode
|-
|KEY_DSS_MODE||DSSMode
|-
|KEY_TV_MODE||TVMode
|-
|KEY_DVD_MODE||DVDMode
|-
|KEY_STB_MODE||STBMode
|-
|KEY_PCMODE||PCMode

|}
<hr>
Color keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_GREEN||Green
|-
|KEY_YELLOW||Yellow
|-
|KEY_CYAN||Cyan
|-
|KEY_RED||Red

|}
<hr>
Teletext
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_TTX_MIX||TeletextMix
|-
|KEY_TTX_SUBFACE||TeletextSubface

|}
<hr>
AspectRatio
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_ASPECT||AspectRatio
|-
|KEY_PICTURE_SIZE||PictureSize
|-
|KEY_4_3||AspectRatio4:3
|-
|KEY_16_9||AspectRatio16:9
|-
|KEY_EXT14||AspectRatio3:4(Alt)
|-
|KEY_EXT15||AspectRatio16:9(Alt)

|}
<hr>
Picture Mode
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_PMODE||PictureMode
|-
|KEY_PANORAMA||PictureModePanorama
|-
|KEY_DYNAMIC||PictureModeDynamic
|-
|KEY_STANDARD||PictureModeStandard
|-
|KEY_MOVIE1||PictureModeMovie
|-
|KEY_GAME||PictureModeGame
|-
|KEY_CUSTOM||PictureModeCustom
|-
|KEY_EXT9||PictureModeMovie(Alt)
|-
|KEY_EXT10||PictureModeStandard(Alt)

|}
<hr>
Menus
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_MENU||Menu
|-
|KEY_TOPMENU||TopMenu
|-
|KEY_TOOLS||Tools
|-
|KEY_HOME||Home
|-
|KEY_CONTENTS||Contents
|-
|KEY_GUIDE||Guide
|-
|KEY_DISC_MENU||DiscMenu
|-
|KEY_DVR_MENU||DVRMenu
|-
|KEY_HELP||Help

|}
<hr>
OSD
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_INFO||Info
|-
|KEY_CAPTION||Caption
|-
|KEY_CLOCK_DISPLAY||ClockDisplay
|-
|KEY_SETUP_CLOCK_TIMER||SetupClock
|-
|KEY_SUB_TITLE||Subtitle

|}
<hr>
Zoom
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_ZOOM_MOVE||ZoomMove
|-
|KEY_ZOOM_IN||ZoomIn
|-
|KEY_ZOOM_OUT||ZoomOut
|-
|KEY_ZOOM1||Zoom1
|-
|KEY_ZOOM2||Zoom2

|}
<hr>
Other keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_WHEEL_LEFT||WheelLeft
|-
|KEY_WHEEL_RIGHT||WheelRight
|-
|KEY_ADDDEL||Add/Del
|-
|KEY_PLUS100||Plus100
|-
|KEY_AD||AD
|-
|KEY_LINK||Link
|-
|KEY_TURBO||Turbo
|-
|KEY_CONVERGENCE||Convergence
|-
|KEY_DEVICE_CONNECT||DeviceConnect
|-
|KEY_11||KEY11
|-
|KEY_12||KEY12
|-
|KEY_FACTORY||KEYFactory
|-
|KEY_3SPEED||KEY3SPEED
|-
|KEY_RSURF||KEYRSURF
|-
|KEY_FF_||FF_
|-
|KEY_REWIND_||REWIND_
|-
|KEY_ANGLE||Angle
|-
|KEY_RESERVED1||Reserved1
|-
|KEY_PROGRAM||Program
|-
|KEY_BOOKMARK||Bookmark
|-
|KEY_PRINT||Print
|-
|KEY_CLEAR||Clear
|-
|KEY_VCHIP||VChip
|-
|KEY_REPEAT||Repeat
|-
|KEY_DOOR||Door
|-
|KEY_OPEN||Open
|-
|KEY_DMA||DMA
|-
|KEY_MTS||MTS
|-
|KEY_DNIe||DNIe
|-
|KEY_SRS||SRS
|-
|KEY_CONVERT_AUDIO_MAINSUB||ConvertAudioMain/Sub
|-
|KEY_MDC||MDC
|-
|KEY_SEFFECT||SoundEffect
|-
|KEY_PERPECT_FOCUS||PERPECTFocus
|-
|KEY_CALLER_ID||CallerID
|-
|KEY_SCALE||Scale
|-
|KEY_MAGIC_BRIGHT||MagicBright
|-
|KEY_W_LINK||WLink
|-
|KEY_DTV_LINK||DTVLink
|-
|KEY_APP_LIST||ApplicationList
|-
|KEY_BACK_MHP||BackMHP
|-
|KEY_ALT_MHP||AlternateMHP
|-
|KEY_DNSe||DNSe
|-
|KEY_RSS||RSS
|-
|KEY_ENTERTAINMENT||Entertainment
|-
|KEY_ID_INPUT||IDInput
|-
|KEY_ID_SETUP||IDSetup
|-
|KEY_ANYVIEW||AnyView
|-
|KEY_MS||MS
|-
|KEY_MORE||
|-
|KEY_MIC||
|-
|KEY_NINE_SEPERATE||
|-
|KEY_AUTO_FORMAT||AutoFormat
|-
|KEY_DNET||DNET

|}
<hr>
Auto Arc keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_AUTO_ARC_C_FORCE_AGING||
|-
|KEY_AUTO_ARC_CAPTION_ENG||
|-
|KEY_AUTO_ARC_USBJACK_INSPECT||
|-
|KEY_AUTO_ARC_RESET||
|-
|KEY_AUTO_ARC_LNA_ON||
|-
|KEY_AUTO_ARC_LNA_OFF||
|-
|KEY_AUTO_ARC_ANYNET_MODE_OK||
|-
|KEY_AUTO_ARC_ANYNET_AUTO_START||
|-
|KEY_AUTO_ARC_CAPTION_ON||
|-
|KEY_AUTO_ARC_CAPTION_OFF||
|-
|KEY_AUTO_ARC_PIP_DOUBLE||
|-
|KEY_AUTO_ARC_PIP_LARGE||
|-
|KEY_AUTO_ARC_PIP_LEFT_TOP||
|-
|KEY_AUTO_ARC_PIP_RIGHT_TOP||
|-
|KEY_AUTO_ARC_PIP_LEFT_BOTTOM||
|-
|KEY_AUTO_ARC_PIP_CH_CHANGE||
|-
|KEY_AUTO_ARC_AUTOCOLOR_SUCCESS||
|-
|KEY_AUTO_ARC_AUTOCOLOR_FAIL||
|-
|KEY_AUTO_ARC_JACK_IDENT||
|-
|KEY_AUTO_ARC_CAPTION_KOR||
|-
|KEY_AUTO_ARC_ANTENNA_AIR||
|-
|KEY_AUTO_ARC_ANTENNA_CABLE||
|-
|KEY_AUTO_ARC_ANTENNA_SATELLITE||

|}
<hr>
Panel keys
{|class="wikitable"

|-
!Ключ!!Действие
|-
|KEY_PANNEL_POWER||
|-
|KEY_PANNEL_CHUP||
|-
|KEY_PANNEL_VOLUP||
|-
|KEY_PANNEL_VOLDOW||
|-
|KEY_PANNEL_ENTER||
|-
|KEY_PANNEL_MENU||
|-
|KEY_PANNEL_SOURCE||
|-
|KEY_PANNEL_ENTER||

|}
 
<hr>
Extended keys
{|class="wikitable"

|-
!Ключ!!
|-
|KEY_EXT1||
|-
|KEY_EXT2||
|-
|KEY_EXT3||
|-
|KEY_EXT4||
|-
|KEY_EXT5||
|-
|KEY_EXT6||
|-
|KEY_EXT7||
|-
|KEY_EXT8||
|-
|KEY_EXT11||
|-
|KEY_EXT12||
|-
|KEY_EXT13||
|-
|KEY_EXT16||
|-
|KEY_EXT17||
|-
|KEY_EXT18||
|-
|KEY_EXT19||
|-
|KEY_EXT20||
|-
|KEY_EXT21||
|-
|KEY_EXT22||
|-
|KEY_EXT23||
|-
|KEY_EXT24||
|-
|KEY_EXT25||
|-
|KEY_EXT26||
|-
|KEY_EXT27||
|-
|KEY_EXT28||
|-
|KEY_EXT29||
|-
|KEY_EXT30||
|-
|KEY_EXT31||
|-
|KEY_EXT32||
|-
|KEY_EXT33||
|-
|KEY_EXT34||
|-
|KEY_EXT35||
|-
|KEY_EXT36||
|-
|KEY_EXT37||
|-
|KEY_EXT38||
|-
|KEY_EXT39||
|-
|KEY_EXT40||
|-
|KEY_EXT41||

|}

==Управление ТВ==

Отправка ''команд'' на ТВ выполняется с помощью привязанного к ним '''''свойства объекта''''' путем записи в это свойство команды через функцию ''setGlobal()'' или иным способом. Возможные команды приведены в таблице ниже.

'''Пример:'''

setGlobal('TV1.Power', '1');

// Или сокращенная форма setGlobal

sg('TV1.Volume', '-3');

// Открытие сайта в браузере

sg('TV1.URL', 'yandex.ru');

При добавлении в модуль телевизора, с ним автоматически добавляются часто используемые команды. Их описание в таблице ниже.

'''Команда''' '''Описание''' '''Значения'''

'''Команда''' В привязанное к этой команде свойство вы можете написать любую команду из списка выше и она будет передана в чистом виде на телевизор. Любая команда из списка выше

'''ВКЛ/ВЫКЛ''' Выключение и включение ТВ Включение ТВ с помощью WOL (только для подключения ТВ по ethernet).
Поддерживается не всеми моделями ТВ. '''1''' - включить, '''0''' - выключить

'''Управление громкостью''' Управление громкостью. '''Положительное''' число - прибавить на заданное количество пунктов. '''Отрицательное''' число - убавить на заданное количество пунктов. '''0''' - MUTE

'''Установка громкости''' Установка уровня громкости. '''1-100'''

'''Управление каналами''' Переключение каналов. '''1''' - канал вперед, '''0''' - список каналов, '''-1''' - канал назад

'''Навигация''' Управление курсором. '''0''' или '''ENTER''' или '''OK''' - кнопка ENTER, 1 или '''LEFT''' - влево, '''2''' или '''UP''' - вверх, '''3''' или '''RIGHT''' - вправо, '''4''' или '''DOWN''' - вниз.

'''Назад''' Кнопка НАЗАД Любое значение

'''Меню''' Кнопка МЕНЮ Любое значение

'''Домой''' Кнопка ДОМОЙ Любое значение

'''Стоп''' Кнопка СТОП Любое значение

'''Воспроизведение''' Кнопка ПЛЭЙ Любое значение

'''HDMI''' Первый источник HDMI Любое значение

'''HDMI1''' Второй источник HDMI Любое значение

'''Цифровые кнопки''' Ввод цифр. Например, для переключения каналов Любое положительное цифровое значение

'''Цветные кнопки''' Цветные кнопки на пульте '''1''' или '''RED''' - красная кнопка, '''2''' или '''GREEN''' - зеленая кнопка, '''3''' или '''YELLOW''' - желтая кнопка, '''4''' или '''BLUE''' - синяя кнопка.

Аналогично происходит управление приложениями. В привязанном свойстве возможны значения '''1''' - запустить, '''0''' - закрыть.

Первое приложение '''Internet''' - запускает браузер с '''URL''', записанным в значение свойства.

Если вы установили новое приложение, то для того, чтоб оно появилось в модуле, нажмите кнопку '''Обновить''' внизу списка приложений.

==Встроенные функции==

Модулем также можно управлять с помощью встроенных функций. В любой функции в качестве имени устройства можно использовать его '''ID''', '''название''' или '''IP-адрес'''.

'''Функция''' '''Описание''' '''Пример'''

'''STVPowerOn(Имя устройства)''' Включение телевизора. STVPowerOn('Телевизор в зале');

'''STVPowerOff(Имя устройства)''' Включение телевизора STVPowerOff('192.168.0.106');

'''STVVolUp(Имя устройства, значение)''' Прибавить громкость. Если не написать значение, громкость будет прибавлена на 1 STVVolUp('Телевизор в зале');

STVVolUp('192.168.0.106', 4);

'''STVVolDown(Имя устройства, значение)''' Убавить громкость. Если не написать значение, громкость будет убавлена на 1 STVVolDown('Телевизор в зале');

STVVolDown('192.168.0.106', 4);

'''STVGetVol(Имя устройства)''' Запрос текущей громкости ТВ STVGetVol('Телевизор в зале');

'''STVSetVol(Имя устройства, значение)''' Установка громкости на устройстве STVSetVol('192.168.0.106', 15);

'''STVChUp(Имя устройства)''' Переключение канала вперед STVChUp('Телевизор в зале');

'''STVChDown(Имя устройства)''' Переключение канала назад STVChDown('192.168.0.106');

'''STVEnter(Имя устройства)''' Кнопка ENTER STVEnter('Телевизор в зале');

'''STVSendURL(Имя устройства, url)''' Открытие ссылки в браузере STVSendURL('192.168.0.106', 'yandex.ru');

'''STVSendKey(Имя устройства, ключ)''' Отправка любого ключа из списка выше на ТВ STVSendKey('Телевизор в зале', 'KEY_VOLUP');

'''STVStatus(Имя устройства)''' Получение информации о доступности устройства (TRUE/FALSE) STVStatus('192.168.0.106');

Файл:3AAuAMz.png

2020-01-23T11:39:08Z

George2017:

Пример

SamsungTV модуль

2020-01-23T11:06:37Z

George2017: создание новой страницы

[[Category:Модули]]

автор: vashal от 23.01.2020

==Описание==

Модуль управления телевизорами '''Samsung с TizenOS'''

==Установка модуля==

Установка осуществляется через '''Маркет дополнений''' в разделе '''Оборудование'''- '''SamsungTV'''.

==Важно:==
ВНИМАНИЕ!!! Модуль работает с устройствами, выпущенными '''не ранее 2016 года''' и с обновленными прошивками.
'''Если вы ''ограничили загрузку обновлений'' на телевизор для взаимодействия с какими-либо программами, то, скорее всего, модуль ''не будет взаимодействовать'' с вашим устройством.'''

''''''Все действия''', связанные с обновлением вашего устройства, вы делаете ''на свой страх и риск и автор модуля не несет никакой ответственности за это''. Равно как и не гарантирует возможности взаимодействия модуля с вашим устройством после обновления.'''

==Общие сведения==

Модуль предназначен для интеграции смарт-телевизоров '''Samsung''' на платформе '''Tizen'''.

'''Возможности модуля:'''

- ручное добавление ТВ по IP адресу;

- поддержка нескольких ТВ;

- определение доступности ТВ;

- получение громкости ТВ;

- управление ТВ (каналы, источники, приложения, громкость, выключение).
Для добавления телевизора нажмите кнопку +Добавить, введите IP адрес и придумайте название телевизора. После нажатия кнопки Добавить телевизор запросит разрешение на сопряжение с модулем. Отвечаем утвердительно, и после этого телевизор появится в списке устройств в модуле

Так как '''Samsung''' не предоставляет '''открытое API''' для управления своими телевизорами, в модуле собрано несколько типов управления, ''добытых из открытых источников'':

- '''wss'''-соединение(SSL Websocket) на порту 8002 - отправка команд, запрос приложений, открытие сайтов встроенным браузером;

- '''POST''' запросы на порт 8001 для управления(запуск, закрытие, статус) приложениями;

- '''протокол''' SOAP на порту 9197 для считывания уровня громкости, установки громкости;

- '''Wake-on-lan''' для запуска выключенного телевизора (не испытывался на Wi-Fi соединении).

Модуль реализует классическую концепцию MajorDoMo для взаимодействия с пользователем через привязанные к определенным командам или приложениям свойства объекта. Объекты и свойства создаются пользователем самостоятельно. В модуле уже добавлены основные команды управления телевизором, но вы можете добавить свою. Список доступных команд см. ниже

В модуле имеется цикл, который раз в 10 секунд опрашивает состояние ТВ, а именно определяет, какое приложение запущено в данный момент, и запрашивает уровень громкости.

==Список команд==

Список ключей может различаться в зависимости от модели телевизора. Ниже приведены некоторые общие коды и их описания. Не все ключи могут работать конкретно на вашей модели телевизора.

'''Power keys'''

'''Ключ''' '''Действие'''

KEY_POWER PowerToggle

'''Input keys'''

'''Ключ''' '''Действие'''

KEY_SOURCE Source

KEY_COMPONENT1 Component1

KEY_COMPONENT2 Component2

KEY_AV1 AV1

KEY_AV2 AV2

KEY_AV3 AV3

KEY_SVIDEO1 SVideo1

KEY_SVIDEO2 SVideo2

KEY_SVIDEO3 SVideo3

KEY_HDMI HDMI

KEY_HDMI1 HDMI1

KEY_HDMI2 HDMI2

KEY_HDMI3 HDMI3

KEY_HDMI4 HDMI4

KEY_FM_RADIO FMRadio

KEY_DVI DVI

KEY_DVR DVR

KEY_TV TV

KEY_ANTENA AnalogTV

KEY_DTV DigitalTV

'''Number keys'''

'''Ключ''' '''Действие'''

KEY_1 1

KEY_2 2

KEY_3 3

KEY_4 4

KEY_5 5

KEY_6 6

KEY_7 7

KEY_8 8

KEY_9 9

KEY_0 0

'''Misc keys'''

'''Ключ''' '''Действие'''

KEY_PANNEL_CHDOWN 3D

KEY_ANYNET AnyNet+

KEY_ESAVING EnergySaving

KEY_SLEEP SleepTimer

KEY_DTV_SIGNAL DTVSignal

'''Channel keys'''

'''Ключ''' '''Действие'''

KEY_CHUP ChannelUp

KEY_CHDOWN ChannelDown

KEY_PRECH PreviousChannel

KEY_FAVCH FavoriteChannels

KEY_CH_LIST ChannelList

KEY_AUTO_PROGRAM AutoProgram

KEY_MAGIC_CHANNEL MagicChannel

'''Volume keys'''

'''Ключ''' '''Действие'''

KEY_VOLUP VolumeUp

KEY_VOLDOWN VolumeDown

KEY_MUTE Mute

'''Direction keys'''

'''Ключ''' '''Действие'''

KEY_UP NavigationUp

KEY_DOWN NavigationDown

KEY_LEFT NavigationLeft

KEY_RIGHT NavigationRight

KEY_RETURN NavigationReturn/Back

KEY_ENTER NavigationEnter

'''Media keys'''

'''Ключ''' '''Действие'''

KEY_REWIND Rewind

KEY_STOP Stop

KEY_PLAY Play

KEY_FF FastForward

KEY_REC Record

KEY_PAUSE Pause

KEY_LIVE Live

KEY_QUICK_REPLAY fnKEY_QUICK_REPLAY

KEY_STILL_PICTURE fnKEY_STILL_PICTURE

KEY_INSTANT_REPLAY fnKEY_INSTANT_REPLAY

'''Picture in Picture'''

'''Ключ''' '''Действие'''

KEY_PIP_ONOFF PIPOn/Off

KEY_PIP_SWAP PIPSwap

KEY_PIP_SIZE PIPSize

KEY_PIP_CHUP PIPChannelUp

KEY_PIP_CHDOWN PIPChannelDown

KEY_AUTO_ARC_PIP_SMALL PIPSmall

KEY_AUTO_ARC_PIP_WIDE PIPWide

KEY_AUTO_ARC_PIP_RIGHT_BOTTOM PIPBottomRight

KEY_AUTO_ARC_PIP_SOURCE_CHANGE PIPSourceChange

KEY_PIP_SCAN PIPScan

'''Modes'''

'''Ключ''' '''Действие'''

KEY_VCR_MODE VCRMode

KEY_CATV_MODE CATVMode

KEY_DSS_MODE DSSMode

KEY_TV_MODE TVMode

KEY_DVD_MODE DVDMode

KEY_STB_MODE STBMode

KEY_PCMODE PCMode

'''Color keys'''

'''Ключ''' '''Действие'''

KEY_GREEN Green

KEY_YELLOW Yellow

KEY_CYAN Cyan

KEY_RED Red

'''Teletext'''

'''Ключ''' '''Действие'''

KEY_TTX_MIX TeletextMix

KEY_TTX_SUBFACE TeletextSubface

'''AspectRatio'''

'''Ключ''' '''Действие'''

KEY_ASPECT AspectRatio

KEY_PICTURE_SIZE PictureSize

KEY_4_3 AspectRatio4:3

KEY_16_9 AspectRatio16:9

KEY_EXT14 AspectRatio3:4(Alt)

KEY_EXT15 AspectRatio16:9(Alt)

'''Picture Mode'''

'''Ключ''' '''Действие'''

KEY_PMODE PictureMode

KEY_PANORAMA PictureModePanorama

KEY_DYNAMIC PictureModeDynamic

KEY_STANDARD PictureModeStandard

KEY_MOVIE1 PictureModeMovie

KEY_GAME PictureModeGame

KEY_CUSTOM PictureModeCustom

KEY_EXT9 PictureModeMovie(Alt)

KEY_EXT10 PictureModeStandard(Alt)

'''Menus'''

'''Ключ''' '''Действие'''

KEY_MENU Menu

KEY_TOPMENU TopMenu

KEY_TOOLS Tools

KEY_HOME Home

KEY_CONTENTS Contents

KEY_GUIDE Guide

KEY_DISC_MENU DiscMenu

KEY_DVR_MENU DVRMenu

KEY_HELP Help

'''OSD'''

'''Ключ''' '''Действие'''

KEY_INFO Info

KEY_CAPTION Caption

KEY_CLOCK_DISPLAY ClockDisplay

KEY_SETUP_CLOCK_TIMER SetupClock

KEY_SUB_TITLE Subtitle

'''Zoom'''

'''Ключ''' '''Действие'''

KEY_ZOOM_MOVE ZoomMove

KEY_ZOOM_IN ZoomIn

KEY_ZOOM_OUT ZoomOut

KEY_ZOOM1 Zoom1

KEY_ZOOM2 Zoom2

'''Other keys'''

'''Ключ''' '''Действие'''

KEY_WHEEL_LEFT WheelLeft

KEY_WHEEL_RIGHT WheelRight

KEY_ADDDEL Add/Del

KEY_PLUS100 Plus100

KEY_AD AD

KEY_LINK Link

KEY_TURBO Turbo

KEY_CONVERGENCE Convergence

KEY_DEVICE_CONNECT DeviceConnect

KEY_11 KEY11

KEY_12 KEY12

KEY_FACTORY KEYFactory

KEY_3SPEED KEY3SPEED

KEY_RSURF KEYRSURF

KEY_FF_ FF_

KEY_REWIND_ REWIND_

KEY_ANGLE Angle

KEY_RESERVED1 Reserved1

KEY_PROGRAM Program

KEY_BOOKMARK Bookmark

KEY_PRINT Print

KEY_CLEAR Clear

KEY_VCHIP VChip

KEY_REPEAT Repeat

KEY_DOOR Door

KEY_OPEN Open

KEY_DMA DMA

KEY_MTS MTS

KEY_DNIe DNIe

KEY_SRS SRS

KEY_CONVERT_AUDIO_MAINSUB ConvertAudioMain/Sub

KEY_MDC MDC

KEY_SEFFECT SoundEffect

KEY_PERPECT_FOCUS PERPECTFocus

KEY_CALLER_ID CallerID

KEY_SCALE Scale

KEY_MAGIC_BRIGHT MagicBright

KEY_W_LINK WLink

KEY_DTV_LINK DTVLink

KEY_APP_LIST ApplicationList

KEY_BACK_MHP BackMHP

KEY_ALT_MHP AlternateMHP

KEY_DNSe DNSe

KEY_RSS RSS

KEY_ENTERTAINMENT Entertainment

KEY_ID_INPUT IDInput

KEY_ID_SETUP IDSetup

KEY_ANYVIEW AnyView

KEY_MS MS

KEY_MORE

KEY_MIC

KEY_NINE_ SEPERATE

KEY_AUTO_FORMAT AutoFormat

KEY_DNET DNET

'''Auto Arc keys'''

'''Ключ'''

KEY_AUTO_ARC_C_FORCE_AGING

KEY_AUTO_ARC_CAPTION_ENG

KEY_AUTO_ARC_USBJACK_INSPECT

KEY_AUTO_ARC_RESET

KEY_AUTO_ARC_LNA_ON

KEY_AUTO_ARC_LNA_OFF

KEY_AUTO_ARC_ANYNET_MODE_OK

KEY_AUTO_ARC_ANYNET_AUTO_START

KEY_AUTO_ARC_CAPTION_ON

KEY_AUTO_ARC_CAPTION_OFF

KEY_AUTO_ARC_PIP_DOUBLE

KEY_AUTO_ARC_PIP_LARGE

KEY_AUTO_ARC_PIP_LEFT_TOP

KEY_AUTO_ARC_PIP_RIGHT_TOP

KEY_AUTO_ARC_PIP_LEFT_BOTTOM

KEY_AUTO_ARC_PIP_CH_CHANGE

KEY_AUTO_ARC_AUTOCOLOR_SUCCESS

KEY_AUTO_ARC_AUTOCOLOR_FAIL

KEY_AUTO_ARC_JACK_IDENT

KEY_AUTO_ARC_CAPTION_KOR

KEY_AUTO_ARC_ANTENNA_AIR

KEY_AUTO_ARC_ANTENNA_CABLE

KEY_AUTO_ARC_ANTENNA_SATELLITE

'''Panel keys'''

'''Ключ''' '''Действие'''

KEY_PANNEL_POWER

KEY_PANNEL_CHUP

KEY_PANNEL_VOLUP

KEY_PANNEL_VOLDOW

KEY_PANNEL_ENTER

KEY_PANNEL_MENU

KEY_PANNEL_SOURCE

KEY_PANNEL_ENTER

'''Extended keys'''

'''Ключ'''

KEY_EXT1

KEY_EXT2

KEY_EXT3

KEY_EXT4

KEY_EXT5

KEY_EXT6

KEY_EXT7

KEY_EXT8

KEY_EXT11

KEY_EXT12

KEY_EXT13

KEY_EXT16

KEY_EXT17

KEY_EXT18

KEY_EXT19

KEY_EXT20

KEY_EXT21

KEY_EXT22

KEY_EXT23

KEY_EXT24

KEY_EXT25

KEY_EXT26

KEY_EXT27

KEY_EXT28

KEY_EXT29

KEY_EXT30

KEY_EXT31

KEY_EXT32

KEY_EXT33

KEY_EXT34

KEY_EXT35

KEY_EXT36

KEY_EXT37

KEY_EXT38

KEY_EXT39

KEY_EXT40

KEY_EXT41

==Управление ТВ==

Отправка ''команд'' на ТВ выполняется с помощью привязанного к ним '''''свойства объекта''''' путем записи в это свойство команды через функцию ''setGlobal()'' или иным способом. Возможные команды приведены в таблице ниже.

'''Пример:'''

setGlobal('TV1.Power', '1');

// Или сокращенная форма setGlobal

sg('TV1.Volume', '-3');

// Открытие сайта в браузере

sg('TV1.URL', 'yandex.ru');

При добавлении в модуль телевизора, с ним автоматически добавляются часто используемые команды. Их описание в таблице ниже.

'''Команда''' '''Описание''' '''Значения'''

'''Команда''' В привязанное к этой команде свойство вы можете написать любую команду из списка выше и она будет передана в чистом виде на телевизор. Любая команда из списка выше

'''ВКЛ/ВЫКЛ''' Выключение и включение ТВ Включение ТВ с помощью WOL (только для подключения ТВ по ethernet).
Поддерживается не всеми моделями ТВ. '''1''' - включить, '''0''' - выключить

'''Управление громкостью''' Управление громкостью. '''Положительное''' число - прибавить на заданное количество пунктов. '''Отрицательное''' число - убавить на заданное количество пунктов. '''0''' - MUTE

'''Установка громкости''' Установка уровня громкости. '''1-100'''

'''Управление каналами''' Переключение каналов. '''1''' - канал вперед, '''0''' - список каналов, '''-1''' - канал назад

'''Навигация''' Управление курсором. '''0''' или '''ENTER''' или '''OK''' - кнопка ENTER, 1 или '''LEFT''' - влево, '''2''' или '''UP''' - вверх, '''3''' или '''RIGHT''' - вправо, '''4''' или '''DOWN''' - вниз.

'''Назад''' Кнопка НАЗАД Любое значение

'''Меню''' Кнопка МЕНЮ Любое значение

'''Домой''' Кнопка ДОМОЙ Любое значение

'''Стоп''' Кнопка СТОП Любое значение

'''Воспроизведение''' Кнопка ПЛЭЙ Любое значение

'''HDMI''' Первый источник HDMI Любое значение

'''HDMI1''' Второй источник HDMI Любое значение

'''Цифровые кнопки''' Ввод цифр. Например, для переключения каналов Любое положительное цифровое значение

'''Цветные кнопки''' Цветные кнопки на пульте '''1''' или '''RED''' - красная кнопка, '''2''' или '''GREEN''' - зеленая кнопка, '''3''' или '''YELLOW''' - желтая кнопка, '''4''' или '''BLUE''' - синяя кнопка.

Аналогично происходит управление приложениями. В привязанном свойстве возможны значения '''1''' - запустить, '''0''' - закрыть.

Первое приложение '''Internet''' - запускает браузер с '''URL''', записанным в значение свойства.

Если вы установили новое приложение, то для того, чтоб оно появилось в модуле, нажмите кнопку '''Обновить''' внизу списка приложений.

==Встроенные функции==

Модулем также можно управлять с помощью встроенных функций. В любой функции в качестве имени устройства можно использовать его '''ID''', '''название''' или '''IP-адрес'''.

'''Функция''' '''Описание''' '''Пример'''

'''STVPowerOn(Имя устройства)''' Включение телевизора. STVPowerOn('Телевизор в зале');

'''STVPowerOff(Имя устройства)''' Включение телевизора STVPowerOff('192.168.0.106');

'''STVVolUp(Имя устройства, значение)''' Прибавить громкость. Если не написать значение, громкость будет прибавлена на 1 STVVolUp('Телевизор в зале');

STVVolUp('192.168.0.106', 4);

'''STVVolDown(Имя устройства, значение)''' Убавить громкость. Если не написать значение, громкость будет убавлена на 1 STVVolDown('Телевизор в зале');

STVVolDown('192.168.0.106', 4);

'''STVGetVol(Имя устройства)''' Запрос текущей громкости ТВ STVGetVol('Телевизор в зале');

'''STVSetVol(Имя устройства, значение)''' Установка громкости на устройстве STVSetVol('192.168.0.106', 15);

'''STVChUp(Имя устройства)''' Переключение канала вперед STVChUp('Телевизор в зале');

'''STVChDown(Имя устройства)''' Переключение канала назад STVChDown('192.168.0.106');

'''STVEnter(Имя устройства)''' Кнопка ENTER STVEnter('Телевизор в зале');

'''STVSendURL(Имя устройства, url)''' Открытие ссылки в браузере STVSendURL('192.168.0.106', 'yandex.ru');

'''STVSendKey(Имя устройства, ключ)''' Отправка любого ключа из списка выше на ТВ STVSendKey('Телевизор в зале', 'KEY_VOLUP');

'''STVStatus(Имя устройства)''' Получение информации о доступности устройства (TRUE/FALSE) STVStatus('192.168.0.106');

Tuya модуль

2020-01-22T15:50:26Z

George2017: создание новой страницы

[[Category:Модули]]

==Описание==

Автор: fandaymon от сен 30, 2019

'''Модуль Tuya''' - Модуль для взаимодействия с устройствами Tuya через облако и локально.

Модуль в состоянии альфа.

==Установка модуля==

Ставится из '''Маркета дополнений''' - '''Оборудование''' - '''Tuya Smarthome'''

Для получения списка устройств, прикрепленных к вашему экаунту в программе TuyaSmart надо кликнуть на Настройки и ввести E-mail и пароль аккаунта под которым вы заходите в программу, код страны, а также выбрать какой программой вы пользуетесь - TuyaSmart или Smart Life
После нажатия кнопки Обновить вы получите список ваших устройств с теми именами, под которыми устройства числятся в TuyaSmart

[[Файл:Tuya list.jpg|800px|мини|центр|Настройка модуля]]

Далее нажав кнопку редактирование на вкладке '''Данные''' можно связать поле '''State''' с ПУ выключатель. После этого устройством можно управлять из ПУ
А такой конфигурации управление идёт через облако. Из параметров устройства вы получаете только '''Online/Offline''' ''On/Off''.
Чтобы управлять устройством локально и получить более подробный статус устройства необходимо получить локальный ключ устройства и ip под которым оно фигурирует в вашей локальной сети

Самый простой способ получить локальный ключ это поставить на смартфон программу Packet Capture и отследить трафик который идёт от программы TuyaSmart. (К сожалению с новой версией программы TuyaSmart не работает - ставьте предыдущую.) В самом большом по размере пакете в розовых сообщениях надо поискать конструкцию

'''name:''' название вашего устройства

'''timezoneID:'''

'''category:'''

'''localKey''': тут будет локальный ключ от вашего устройства

'''ip''' можно посмотреть на роутере по мак-адресу вашего устройства. Мак-адрес можно увидеть в TuyaSmart в разделе информация об устройстве

Имея '''localKey''' и '''ip''' заходим в редактирование устройства и вносим эту информацию в соответствующие поля. После сохранения в данных должны появится '''дополнительные поля'''

[[Файл:Tuya date.jpg|800px|мини|центр|Данные]]

Для розеток с соответствующим функционалом там могут быть ''вольтаж, сила тока, мощность и т.д''.

Для устройств с несколькими группами розеток в списке устройств появятся столько устройств, сколько групп розеток вы можете контролировать. '''Локальный ключи''' и '''IP''' надо будет вписать только в устройство с _1 на конце ID. Дополнительная информация соответственно появится только в этом устройстве.

Пока модуль протестирован с 2 видами розеток, краном для воды и одним сетевым фильтром. Буду рад услышать отзывы от владельцев других устройств

Маленькое замечание - если '''IP''' устройства в вашей локальной сети поменяется, то поменяется и локальный ключ.

'''Как повзаимодействовать с ДУ из модуля'''

1. Добавляется сцена, которая по клику, например, включает ТВ

2. В модуле появляется устройство с типом сцена с каким-то id, допустим abcdef

3. В методе/сценарии, где нам надо включить телевизор пишем

<td>include_once(DIR_MODULES . 'tuya/tuya.class.php');</td>

<td>$tuya_module = new tuya();</td>

<td>$tuya_module->TuyaRemoteMsg('abcdef','1','turnOnOff');</td>

'''Профит''' - этот код запускает сцену, сцена запускает пульт - пульт включает телевизор

Примерно так же можно производить какие-то действия с ''устройствами'', которые напрямую модулем не поддерживаются, например, ''замками''.

Файл:Tuya date.jpg

2020-01-22T15:42:16Z

George2017:

Данные

Файл:Tuya list.jpg

2020-01-22T15:37:54Z

George2017:

Настройка млдуля

Xiaomi miIO модуль

2020-01-22T12:21:52Z

George2017: дополнение новой страницы

[[Category:Модули]]

автор: skysilver от Июль 23, 2018

'''P.S. Дополнение к редакции от 22.01.2020 г'''.

Увы но в новых версиях Xiaomi Gateway2 закрыты порты (режим разработчика виден, но работать не будет) и их придется открывать через программатор, предлагаю к прочтению [https://yandex.ru/turbo?text=https%3A%2F%2Fsprut.ai%2Fclient%2Farticle%2F1576&d=1 вот этой статьи].

==Описание==
'''Модуль Xiaomi miIO'''

==Установка модуля==
Установка осуществляется через '''Маркет дополнений'''

==Интерфейс модуля==

[[Файл:Joxi screenshot 1532893274950.png|800px|мини|центр|Главная страница модуля]]

1 - Список устройств.

2 - Кнопка вызова настроек модуля (подробнее здесь).

3 - Кнопка ручного добавления устройства.

4 - Кнопка ручного запуска поиска устройств в локальной сети.

5 - Индикатор статуса цикла модуля.

6 - Кнопка вызова справки о модуле.

[[Файл:Joxi screenshot 1532900245440.png|800px|мини|центр|Элементы сиска устройств]]

1 - Название устройства.

2 - Изображение устройства.

3 - IP-адрес устройства.

4 - Токен устройства или индикатор его отсутствия (подробнее здесь).

5 - Системная модель устройства.

6 - Индикатор доступности устройства (онлайн/оффлайн).

7 - Интервал периодического запроса актуального состояния устройства и всех его метрик в секундах (поллинг, polling).

8 - Кнопка ручного запроса актуального состояния устройства и всех его метрик.

9 - Кнопка редактирования настроек и свойств устройства.

10 - Кнопка удаления устройства из модуля.

11 - Кнопка получения служебной информации об устройстве - miIO.info.

12 - Кнопка вызова окна тестирования API-команд.

[[Файл:Joxi screenshot 1532900599065.png|800px|мини|центр|Раздел работы с устройством]]

1 - Область настроек устройства - вкладка '''Общее''' (подробнее здесь).

2 - Работа с метриками (свойствами, состояниями) устройства - вкладка '''Данные'''.

3 - Справочные сведения (помощь) об устройстве - вкладка '''Справка'''.

[[Файл:Joxi screenshot 1532901323397.png|800px|мини|центр|Работа с метриками устройства]]

1 - Доступные '''метрики''' (свойства, состояния) устройства.

2 - Текущее '''значение''' метрик.

3 - Добавление (привязка) '''простого устройства''' (ПУ) к метрике.

4 - Выбор связанного '''объекта'''.

5 - Добавление (привязка) '''свойства''' связанного объекта к метрике.

6 - Добавление (привязка) '''метода''' связанного объекта к метрике.

7 - Время последнего обновления метрики.

8 - Кнопка удаления метрики.

==Настройка модуля==

Настройка модуля '''Xiaomi miIO''' заключается в указании базовых настроек самого модуля, проверке запуска цикла модуля и индивидуальной настройке каждого из устройств.

==Базовые настройки модуля==

Файл:Joxi screenshot 1532718140078.png

2020-01-22T12:01:38Z

George2017:

Индивидуальные настройки устройства

Файл:Joxi screenshot 1532717812522.png

2020-01-22T12:00:24Z

George2017:

Редактирование настроек устройства

Файл:Joxi screenshot 1532643105234.png

2020-01-22T11:57:55Z

George2017:

Запуск цикла модуля Xiaomi miIO

Файл:Joxi screenshot 1532643165745.png

2020-01-22T11:57:06Z

George2017:

Управление циклами MajorDoMo

Файл:Joxi screenshot 1532644272492.png

2020-01-22T11:54:59Z

George2017:

Цикл модуля остановлен

Файл:Joxi screenshot 1532644232799.png

2020-01-22T11:54:11Z

George2017:

Цикл модуля запущен

Файл:Joxi screenshot 1532643037099.png

2020-01-22T11:49:06Z

George2017:

Окно настроек модуля

Xiaomi miIO модуль

2020-01-22T11:41:54Z

George2017:

[[Category:Модули]]

автор: skysilver от Июль 23, 2018

'''P.S. Дополнение к редакции от 22.01.2020 г'''.

В случает если нижеописанный метод не сработает, предлагаю к прочтению [https://yandex.ru/turbo?text=https%3A%2F%2Fsprut.ai%2Fclient%2Farticle%2F1576&d=1 вот этой статьи], как альтернативный вариант.

==Описание==
'''Модуль Xiaomi miIO'''

==Установка модуля==
Установка осуществляется через '''Маркет дополнений'''

==Интерфейс модуля==

[[Файл:Joxi screenshot 1532893274950.png|800px|мини|центр|Главная страница модуля]]

1 - Список устройств.

2 - Кнопка вызова настроек модуля (подробнее здесь).

3 - Кнопка ручного добавления устройства.

4 - Кнопка ручного запуска поиска устройств в локальной сети.

5 - Индикатор статуса цикла модуля.

6 - Кнопка вызова справки о модуле.

[[Файл:Joxi screenshot 1532900245440.png|800px|мини|центр|Элементы сиска устройств]]

1 - Название устройства.

2 - Изображение устройства.

3 - IP-адрес устройства.

4 - Токен устройства или индикатор его отсутствия (подробнее здесь).

5 - Системная модель устройства.

6 - Индикатор доступности устройства (онлайн/оффлайн).

7 - Интервал периодического запроса актуального состояния устройства и всех его метрик в секундах (поллинг, polling).

8 - Кнопка ручного запроса актуального состояния устройства и всех его метрик.

9 - Кнопка редактирования настроек и свойств устройства.

10 - Кнопка удаления устройства из модуля.

11 - Кнопка получения служебной информации об устройстве - miIO.info.

12 - Кнопка вызова окна тестирования API-команд.

[[Файл:Joxi screenshot 1532900599065.png|800px|мини|центр|Раздел работы с устройством]]

1 - Область настроек устройства - вкладка '''Общее''' (подробнее здесь).

2 - Работа с метриками (свойствами, состояниями) устройства - вкладка '''Данные'''.

3 - Справочные сведения (помощь) об устройстве - вкладка '''Справка'''.

[[Файл:Joxi screenshot 1532901323397.png|800px|мини|центр|Работа с метриками устройства]]

1 - Доступные '''метрики''' (свойства, состояния) устройства.

2 - Текущее '''значение''' метрик.

3 - Добавление (привязка) '''простого устройства''' (ПУ) к метрике.

4 - Выбор связанного '''объекта'''.

5 - Добавление (привязка) '''свойства''' связанного объекта к метрике.

6 - Добавление (привязка) '''метода''' связанного объекта к метрике.

7 - Время последнего обновления метрики.

8 - Кнопка удаления метрики.

P.S. Дополнение к редакции от 22.01.2020 г.

В случает если вышеописанный метод не сработает, предлагаю к прочтению [https://yandex.ru/turbo?text=https%3A%2F%2Fsprut.ai%2Fclient%2Farticle%2F1576&d=1 вот этой статьи], как альтернативный вариант.

Xiaomi miIO модуль

2020-01-22T11:32:59Z

George2017: создание новой страницы

[[Category:Модули]]

автор: skysilver от Июль 23, 2018

==Описание==
'''Модуль Xiaomi miIO'''

==Установка модуля==
Установка осуществляется через '''Маркет дополнений'''

==Интерфейс модуля==

[[Файл:Joxi screenshot 1532893274950.png|800px|мини|центр|Главная страница модуля]]

1 - Список устройств.

2 - Кнопка вызова настроек модуля (подробнее здесь).

3 - Кнопка ручного добавления устройства.

4 - Кнопка ручного запуска поиска устройств в локальной сети.

5 - Индикатор статуса цикла модуля.

6 - Кнопка вызова справки о модуле.

[[Файл:Joxi screenshot 1532900245440.png|800px|мини|центр|Элементы сиска устройств]]

1 - Название устройства.

2 - Изображение устройства.

3 - IP-адрес устройства.

4 - Токен устройства или индикатор его отсутствия (подробнее здесь).

5 - Системная модель устройства.

6 - Индикатор доступности устройства (онлайн/оффлайн).

7 - Интервал периодического запроса актуального состояния устройства и всех его метрик в секундах (поллинг, polling).

8 - Кнопка ручного запроса актуального состояния устройства и всех его метрик.

9 - Кнопка редактирования настроек и свойств устройства.

10 - Кнопка удаления устройства из модуля.

11 - Кнопка получения служебной информации об устройстве - miIO.info.

12 - Кнопка вызова окна тестирования API-команд.

[[Файл:Joxi screenshot 1532900599065.png|800px|мини|центр|Раздел работы с устройством]]

1 - Область настроек устройства - вкладка '''Общее''' (подробнее здесь).

2 - Работа с метриками (свойствами, состояниями) устройства - вкладка '''Данные'''.

3 - Справочные сведения (помощь) об устройстве - вкладка '''Справка'''.

[[Файл:Joxi screenshot 1532901323397.png|800px|мини|центр|Работа с метриками устройства]]

1 - Доступные '''метрики''' (свойства, состояния) устройства.

2 - Текущее '''значение''' метрик.

3 - Добавление (привязка) '''простого устройства''' (ПУ) к метрике.

4 - Выбор связанного '''объекта'''.

5 - Добавление (привязка) '''свойства''' связанного объекта к метрике.

6 - Добавление (привязка) '''метода''' связанного объекта к метрике.

7 - Время последнего обновления метрики.

8 - Кнопка удаления метрики.

P.S. Дополнение к редакции от 22.01.2020 г.

В случает если вышеописанный метод не сработает, предлагаю к прочтению [https://yandex.ru/turbo?text=https%3A%2F%2Fsprut.ai%2Fclient%2Farticle%2F1576&d=1 вот этой статьи], как альтернативный вариант.

Файл:Joxi screenshot 1532901323397.png

2020-01-22T11:26:20Z

George2017:

Работа с метриками устройства

Файл:Joxi screenshot 1532900599065.png

2020-01-22T11:20:34Z

George2017:

Раздел работы с устройством

Файл:Joxi screenshot 1532900245440.png

2020-01-22T11:18:43Z

George2017:

Элементы списка устройств

Файл:Joxi screenshot 1532893274950.png

2020-01-22T11:17:20Z

George2017:

Главная страница модуля

Yandex Home модуль

2020-01-21T20:05:32Z

George2017: /* Публикация обработчиков запросов */

[[Category:Модули]]

автор: skysilver

==Описание==
'''Модуль Yandex Home'''

==Установка модуля==
Установка осуществляется через '''Маркет дополнений'''

==Общие сведения==

Модуль '''Yandex Home''' предназначен для поддержки '''личных''' (приватных) навыков для платформы умного дома '''Яндекс'''.

Платформа умного дома '''Яндекс''' имеет открытое [https://tech.yandex.ru/dialogs/alice/doc/smart-home/start-docpage/ '''API'''] и позволяет интегрировать '''Яндекс Алису''' с оборудованием сторонних производителей и системами умного дома. Модуль реализует '''авторизационный сервис''' на основе стандарта '''OAuth 2.0''' и '''Provider Adapter API''' - промежуточный API, который принимает на вход запросы в формате платформы умного дома Яндекс и преобразует их в запросы к API '''MajorDoMo'''.

Особенностью платформы умного дома '''Яндекс''' является '''новая''' специальная '''категория''' навыков '''Алисы''', которая предназначена для голосового управления домашними устройствами и не требует предварительного запуска навыка по его имени. Теперь устройствами можно управлять прямыми командами вида ''"Алиса, включи свет в гостиной"'', ''"Алиса, сделай в спальне похолоднее"'' и т. п. При этом следует понимать, что в отличие от классических навыков, '''Яндекс''' не передает в '''MajorDoMo''' распознанный текст команды пользователя, а передается непосредственно управляющая команда для устройства, которая интерпретируется модулем и записывается в привязанное свойство объекта.

Модуль реализует классическую концепцию '''MajorDoMo''' для взаимодействия с пользователем через '''метрики''' и привязанные к ним '''свойства объекта'''. К метрикам привязываются уже существующие объекты и свойства, через которые реализовано управление устройствами.

Обсуждение модуля на [https://mjdm.ru/forum/viewtopic.php?f=5&t=6498 '''Форуме'''].

Исходный код модуля на [https://github.com/skysilver-lab/majordomo-yandexhome '''Github'''].

Модуль в [https://connect.smartliving.ru/tasks/482.html '''Connect'''].

[[Файл:Module yandexhome.png|800px|мини|центр|Module yandexhome]]

Для успешного функционирования модуля и управления устройствами, подключенными к '''MajorDoMo''', через ассистента '''Яндекс Алиса''' требуется, в первую очередь, '''опубликовать обработчики запросов''' (конечные точки, вебхуки) в сеть Интернет и обеспечить тем самым их доступность со стороны облака '''Яндекс''' по доменному имени ('''DNS''') и протоколу '''HTTPS'''. Во вторую очередь, необходимо в консоли разработчика платформы Яндекс Диалогов создать, настроить и опубликовать '''приватный навык''' специальной категории '''Умный дом'''.

В модуле '''Yandex Home''' все обработчики запросов реализованы в виде отдельных файлов: ''authorize.php'', '''token.php''' и '''smarthome.php''', и размещаются в директории ''/modules/yandexhome''.

<table>

<tr>
<th>Назначение вебхука</th>
<th>URL вебхука</th>
<th>Пример опубликованной ссылки</th>
</tr>

<tr>
<td>URL авторизации</td>
<td>/modules/yandexhome/authorize.php</td>
<td><code>https://majordomo.keenetic.pro/modules/yandexhome/authorize.php</code></td>
</tr>
<tr>
<td>URL для получения и обновления токена</td>
<td>/modules/yandexhome/token.php</td>
<td><code>https://majordomo.keenetic.pro/modules/yandexhome/token.php</code></td>
</tr>
<tr>
<td>URL обработчика навыка</td>
<td>/modules/yandexhome/smarthome.php</td>
<td><code>https://majordomo.keenetic.pro/modules/yandexhome/smarthome.php</code></td>
</tr>
</table>

В конечном итоге '''запуск модуля''' сводится к такой последовательности шагов:

1. Установка модуля из маркета дополнений.

2. Настройка модуля.

3. Публикация обработчиков запросов.

4. Регистрация приватного навыка.

5. Объединение аккаунтов в приложении Яндекс.

6. Добавление и управление устройствами в модуле

==Поддерживаемые умения==

<table>

<tr>
<th>#</th>
<th>Метрика (умение)</th>
<th>Описание</th>
<th>Значения в модуле</th>
<th>Значения от Яндекс</th>
</tr>

<tr>
<td>1</td>
<td>on</td>
<td>Включить/выключить (1 - включено, 0 выключено).</td>
<td>1 и 0</td>
<td>true и false</td>
</tr>
<tr>
<td>2</td>
<td>volume</td>
<td>Громкость (проценты).</td>
<td>1 - 100 (*)</td>
<td>1 - 100, либо +1/-1</td>
</tr>
<tr>
<td>3</td>
<td>channel</td>
<td>ТВ-канал.</td>
<td>№ канала (*)</td>
<td>№ канала, либо +1/-1</td>
</tr>
<tr>
<td>4</td>
<td>temperature</td>
<td>Температура (градусы цельсия).</td>
<td>1 - 100 (*)</td>
<td>°C</td>
</tr>
<tr>
<td>5</td>
<td>temperature_k</td>
<td>Температура цвета (кельвины).</td>
<td>2700 - 9000</td>
<td>2700 - 9000</td>
</tr>
<tr>
<td>6</td>
<td>thermostat</td>
<td>Температурный режим.</td>
<td>auto, heat, cool, eco, dry, fan_only</td>
<td>auto, heat, cool, eco, dry, fan_only</td>
</tr>
<tr>
<td>7</td>
<td>mute</td>
<td>Режим без звука (1 - включено, 0 выключено).</td>
<td>1 и 0</td>
<td>true и false</td>
</tr>
<tr>
<td>8</td>
<td>fan_speed</td>
<td>Скорость вентиляции.</td>
<td>auto, low, medium, high</td>
<td>auto, low, medium, high</td>
</tr>
<tr>
<td>9</td>
<td>rgb</td>
<td>Цвет в формате RGB (hex).</td>
<td>000000 - FFFFFF</td>
<td>0 - 16777215</td>
</tr>
<tr>
<td>10</td>
<td>brightness</td>
<td>Яркость (проценты).</td>
<td>1 - 100 (*)</td>
<td>1 - 100</td>
</tr>

</table>

* Имеется возможность переопределить диапазон значений и шаг изменения.

==Требования==

1. '''Публичный''' (глобальный, белый) '''IP-адрес''', выдаваемый интернет-провайдером.

2. '''Доменное имя''' (DNS), привязанное к публичному IP-адресу.

3. Валидный '''SSL-сертификат''' на DNS-имя.

4. '''Опубликованные''' в Интернет '''обработчики''' запросов (без требования ввода логина и пароля).

5. Зарегистрированный и '''опубликованный''' приватный '''навык''' категории '''''Умный дом'''''.

6. Активное PHP-расширение '''pdo_mysql'''.

==Установка модуля==

Чтобы установить модуль, нужно в '''Панели управления MajorDoMo''' перейти в раздел '''Система''' и открыть '''Маркет дополнений'''. Модуль находится в категории '''Взаимодействие'''. Открываем эту вкладку и ищем в списке строку с модулем. Для установки нажимаем кнопку '''Добавить'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737355f696d6167652e706e67.png|800px|мини|центр|рис 1]]

Процесс установки отобразится в виде лога. После успешной установки система перенаправит обратно на страницу '''Маркета дополнений''', а в разделе '''Устройства''' Панели управления появится новый пункт с модулем '''Yandex Home'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737365f696d6167652e706e67.png|800px|мини|центр|Установка]]

==Настройка модуля==

Настройка модуля заключается в генерации значений '''OAuth2 ID''' и '''OAuth2 KEY''' с помощью соответствующей кнопки, а также ввод произвольных '''логина''' и '''пароля''' пользователя, которые впоследствии будут запрошены в ходе объединения аккаунтов в '''приложении Яндекс'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737375f696d6167652e706e67.png|800px|мини|центр|Настройка]]

На ранних этапах использования модуля '''рекомендуется включить''' ведение '''логов''' событий - '''Отладка DebMes'''.

При необходимости можно указать, какой использовать '''стиль отображения''' списка устройств на главной странице модуля.

==Публикация обработчиков запросов==

Механизм взаимодействия '''платформы умного дома Яндекс''' со сторонними системами (провайдерами) реализуется посредством '''вебхуков''' (webhook). Облако '''Яндекс''' для запроса состояния устройств и управления ими посылает '''POST'''- и '''GET'''- запросы на '''конечные точки''' (''endpoint'') вебхуков и получает ответы от них. Таким образом, для корректной работы этого механизма необходимо обеспечить постоянную доступность вебхуков из сети Интернет со стороны облака '''Яндекс'''.

Согласно '''API платформы''' умного дома '''Яндекс''' требуется реализовать '''три типа''' конечных точек:

1. '''URL авторизации''' (''authorization endpoint'') - страница, на которой авторизуется пользователь, чтобы разрешить навыку доступ к своему аккаунту.

2. '''URL для получения и обновления токена''' (''token endpoint'') - адрес, на который отправляются запросы с авторизационным кодом, чтобы получить '''''OAuth-токен''''' доступа, и запросы для обновления ранее полученного токена.

3. '''URL обработчика навыка''' (''smarthome endpoint'') - основной вебхук, который отвечает непосредственно за работу с устройствами.

В модуле '''Yandex Home''' все три типа конечных точек реализованы в виде отдельных файлов: ''authorize.php'', ''token.php'' и ''smarthome.php'', размещаемых в директории ''/modules/yandexhome''.

'''# Назначение вебхука''' '''URL вебхука'''

1 URL авторизации /modules/yandexhome/authorize.php

2 URL для получения и обновления токена /modules/yandexhome/token.php

3 URL обработчика навыка /modules/yandexhome/smarthome.php

Чтобы '''опубликовать''' эти три вебхука в сеть '''Интернет''' и обеспечить тем самым их доступность со стороны '''облака Яндекс''', необходимо выполнить ряд условий.

'''Условие №1'''. Публичный (глобальный, белый) IP-адрес, выдаваемый интернет-провадером.

Белый IP-адрес при этом может быть как ''статическим'', так и ''динамическим''. В случаях, когда невозможно получить белый адрес у интернет-провайдера, возможны варианты использования сторонних сервисов. Например, некоторые производители роутеров предоставляют их владельцам сервис по доступу к ресурсам домашней локальной сети (KeenDNS от Keenetic и др). Либо использовать VPN-сервисы на подобие vpnki.ru или собственный VPN-сервер, развернутый на VPS.

'''Условие №2'''. Доменное имя (DNS), привязанное к публичному IP-адресу.

Это требование в большинстве случаев закрывается классическими сервисами '''динамических DNS''', которых представлено в сети в большом ассортименте, как платных, так и бесплатных. Большинство современных роутеров уже имеют встроенную поддержку сервисов '''''Dynamic DNS'''''. При использовании сервисов удаленного доступа типа ''KeenDNS'' или ''VPNKI'' это условие выполняется автоматически - доменное имя выбирается и присвается в ходе регистрации и подключения услуги.

'''Условие №3'''. Валидный SSL-сертификат на DNS-имя.

По требованиям платформы умного дома '''Яндекс''' весь обмен трафиком между их облаком и '''MajorDoMo''' должен идти в зашифрованном виде по протоколу '''HTTPS''', что обеспечивается либо установкой '''''SSL-сертификата''''' на веб-сервер с '''MajorDoMo''', либо услугами сервисов удаленного доступа (см. выше). Бесплатный SSL-сертификат можно получить у удостоверяющего центра [https://letsencrypt.org/ Let’s Encrypt] сроком на 3 месяца, затем его нужно будет регулярно обновлять. Сертификат устанавливается либо на тот же ''виртуальный сервер'' '''Apache''', который обслуживает '''MajorDoMo''', либо на отдельный ''виртуальный сервер'' ('''Apache''' или '''Nginx'''), выступающий в роли обратного прокси (reverse proxy) для '''MajorDoMo'''.

Корректность установки сертификата и доступность вашего сервера из сети Интернет по HTTPS можно проверить с помощью специализированных сервисов, например:

https://ssllabs.com/ssltest/analyze.html
https://www.geocerts.com/ssl-checker
https://www.digicert.com/help/
https://www.sslshopper.com/ssl-checker.html

==Регистрация приватного навыка==

'''Навыки умного дома''' - специальная категория навыков '''Алисы''', предназначенных для голосового управления домашними устройствами. Навыки создаются в [https://dialogs.yandex.ru/developer/ ''консоли разработчика''] платформы Яндекс Диалогов.

Основные '''шаги''' по созданию навыка это:

1. Настройка связки аккаунтов OAuth 2.0.

2. Добавление навыка и выбор его типа.

3. Заполнение информационных полей.

4. Модерация навыка.

5. Публикация навыка.

Чтобы создать новый '''приватный навык''', открываем [https://dialogs.yandex.ru/developer/ '''консоль разработчика'''] и авторизуемся под нужной учетной записью.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3734395f696d6167652e706e67.png|800px|мини|без|Яндекс диалоги]]

В личном кабинете разработчика нажимаем шестеренку и переходим в раздел '''Настройки''', где открываем вкладку '''''Связки аккаунтов'''''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735315f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

После чего добавляем новую связку и заполняем ее поля (детальное описание [https://tech.yandex.ru/dialogs/alice/doc/auth/account-linking-docpage/ здесь]).

- '''Название''' - понятное вам название связки.

- '''Идентификатор приложения''' - значение '''OAuth2 ID''' из настроек модуля '''Yandex Home'''.

- '''Секрет приложения''' - значение '''OAuth2 KEY''' из настроек модуля '''Yandex Home'''.

- '''URL авторизации''' - адрес вебхука авторизации (см. предыдущую статью), например, - https://majordomo.keenetic.pro:8443/modules/yandexhome/authorize.php

- '''URL для получения токена''' - адрес вебхука получения токена (см. предыдущую статью), например, https://majordomo.keenetic.pro:8443/modules/yandexhome/token.php

- '''URL для обновления токена''' - тот же самый, что и пунктом выше, например, https://majordomo.keenetic.pro:8443/modules/yandexhome/token.php

- '''Идентификатор группы действий''' - оставляем пустым.

- '''Идентификатор OAuth приложения''' - оставляем пустым.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735305f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

Сохраняем связку и возвращаемся на главную страницу консоли разработчика, на которой создаем новый навык, кликнув по кнопке '''''Создать диалог'''''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735325f696d6167652e706e67.png|800px|мини|центр|Создать диалог]]

Тип навыка выбираем '''Умный дом'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735335f696d6167652e706e67 (1).png|800px|мини|центр|Тип диалога]]

Последовательно заполняем поля (детальное описание [https://tech.yandex.ru/dialogs/alice/doc/smart-home/start-docpage/ здесь]).

- '''Название''' - указываем название навыка.

- '''Endpoint URL''' - адрес вебхука обработчика навыка (см. предыдущую статью),

например, https://majordomo.keenetic.pro:8443/modules/yandexhome/smarthome.php.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735355f696d6167652e706e67.png|800px|мини|центр|Основные настройки]]

- '''Приватность''' - обязательно ставим галочку '''''Не показывать в каталоге'''''.

- '''Подзаголовок''' - пишем краткое описание навыка.

- '''Имя разработчика''' - фамилия, имя.

- '''E-mail разработчика''' - пишем аккаунт Яндекс.Почты.

- '''Сайт для верификации прав использования бренда''' - оставляем пустым.

- '''Описание''' - произвольное описание нашего навыка.

- '''Заметки для модератора''' - оставляем пустым.

- '''Иконка''' - логотип навыка в формате PNG или JPG.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735365f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

- '''Связка аккаунтов''' - в выпадающем списке выбрать ранее созданную связку.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735375f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

Сохраняем изменения, после чего становится активной кнопка '''''На модерацию'''''. Кликаем на нее и отправляем наш навык на модерацию. На сегодняшний день модерация автоматическая и происходит мгновенно.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735385f696d6167652e706e67.png|800px|мини|центр|Черновик]]

После модерации остается завершающий этап - '''публикация''' навыка. Нажимаем кнопку '''Опубликовать'''''Курсивное начертание'' и на главной странице консоли разработчика видим, что навык сменил статус и переместился в раздел '''Опубликованные'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735395f696d6167652e706e67.png|800px|мини|центр|Публикация]]

Опубликованный приватный навык появится в списке навыков умного дома в '''приложении Яндекс''' (или в его веб-версии [https://quasar.yandex.ru/skills/iot/ '''quasar''']).

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736305f696d6167652e706e67.png|800px|мини|центр|Первые шаги]]

На следующем шаге можно приступать к объединению аккаунтов.

==Объединение аккаунтов в приложении Яндекс==

Следующим этапом после регистрации и публикации приватного навыка является '''объединение аккаунтов''' в приложении умного дома '''Яндекс'''. Это - '''завершающий этап по интеграции сторонних систем (и MajorDoMo в частности) с платформой умного дома Яндекс, после которого становится доступным управление устройствами с помощью голосового ассистента Яндекс Алиса'''.

Чтобы объединить аккаунты, с главной страницы приложения ([https://play.google.com/store/apps/details?id=ru.yandex.searchplugin Google Play] или [https://itunes.apple.com/ru/app/id1050704155 App Store]) необходимо зайти в раздел '''''Умный дом''''', а затем тапнуть кнопку '''Добавить устройство''', после чего откроется раздел '''''Популярные производители'''''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736315f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

В списке производителей выбираем наш приватный навык и тапаем кнопку '''Объединить аккаунты'''. Приложение переадресует на страницу авторизации навыка, на которой нужно ввести '''''логин пользователя и пароль пользователя''''', указанные ранее в настройках модуля '''Yandex Home'''. После успешной авторизации подтверждаем сопряжение кнопкой '''Предоставить'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736325f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

Приложение переадресует обратно на страницу свойств навыка, а кнопка '''Объединить аккаунты''' изменится на '''Обновить список устройств'''. Тапаем на нее и после успешной синхронизации будет предложено перейти на страницу со списком устройств. Если в этот момент в модуле '''Yandex Home''' уже были добавлены устройства, то они отобразятся в приложении. В дальнейшем при добавлении устройств в модуле или изменении их свойств необходимо каждый раз выполнять такую синхронизацию для обновления списка устройств в '''приложении Яндекс'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736335f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

==Добавление и управление устройствами в модуле==

Модуль реализует классическую концепцию '''MajorDoMo''' для взаимодействия с пользователем через '''метрики''' и '''привязанные''' к ним '''свойства объекта'''. К метрикам (умениям) привязываются уже существующие объекты и свойства, через которые '''реализовано управление''' устройствами. К каждому умению устройства можно привязать свое свойство объекта.

Добавление нового устройства выполняется с помощью кнопки '''Добавить устройство''' на главной странице модуля. После чего указываются название, тип и местоположение устройства.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737385f696d6167652e706e67.png|800px|мини|центр|Настройка]]

Дальнейшее конфигурирование выполняется на странице редактирования (настройки) устройства.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737395f696d6167652e706e67.png|800px|мини|центр|Конфигурирование]]

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738305f696d6167652e706e67.png|800px|мини|центр|Настройка устройств]]

'''Обязательные''' для заполнения '''поля''' устройства:

1. Название.

2. Тип.

3. Местоположение.

4. Умения.

У каждого устройства '''должно быть''' указано '''минимум одно''' умение.

'''Не обязательные''' для заполнения '''поля''' устройства:

1. Описание.

2. Производитель.

3. Модель.

4. Версия программного обеспечения (ПО).

5. Версия аппаратного обеспечения (АО).

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738315f696d6167652e706e67.png|800px|мини|центр|Описание полей]]

'''Набор умений''' представлен в виде выпадающего списка.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738325f696d6167652e706e67.png|800px|мини|центр|Набор умений]]

'''Привязка свойства''' объекта к конкретному '''умению''' выполняется также с помощью выпадающих списков.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738335f696d6167652e706e67.png|800px|мини|центр|Привязка свойств]]

При добавлении устройств в модуле или изменении их свойств для обновления списка устройств в '''приложении Яндекс''' необходимо каждый раз выполнять синхронизацию с помощью кнопки '''Обновить список устройств''' в окне свойств навыка. Удаляются устройства из '''приложения Яндекс''' вручную, либо через '''отвязывание аккаунта''' и последующее повторное объединение аккаунтов.

==Документация по модулю==

1. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-obschie-svedeniya.html MajorDoMo и Яндекс Алиса. Общие сведения.]

2. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-publikaciya-vebhukov.html MajorDoMo и Яндекс Алиса. Публикация вебхуков.]

3. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-registraciya-privatnogo-navyka.html MajorDoMo и Яндекс Алиса. Регистрация приватного навыка.]

4. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-obyedinenie-akkauntov.html MajorDoMo и Яндекс Алиса. Объединение аккаунтов.]

5. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-modul-yandex-home.html MajorDoMo и Яндекс Алиса. Модуль Yandex Home.]

6. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-vklyuchi-svet-na-kuhne.html MajorDoMo и Яндекс Алиса. Алиса, включи свет на кухне.]

7. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-uvelich-yarkost-nastolnoy-lampy.html MajorDoMo и Яндекс Алиса. Алиса, сделай ярче настольную лампу.]

8. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-izmeni-cvet-bra-na-krasnyy.html MajorDoMo и Яндекс Алиса. Алиса, измени цвет бра на красный.]

9. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-vklyuchi-kanal-karusel.html MajorDoMo и Яндекс Алиса. Алиса, включи канал Карусель.]

Yandex Home модуль

2020-01-21T19:11:09Z

George2017: создание новой страницы

[[Category:Модули]]

автор: skysilver

==Описание==
'''Модуль Yandex Home'''

==Установка модуля==
Установка осуществляется через Маркет дополнений

==Общие сведения==

Модуль '''Yandex Home''' предназначен для поддержки '''личных''' (приватных) навыков для платформы умного дома '''Яндекс'''.

Платформа умного дома '''Яндекс''' имеет открытое [https://tech.yandex.ru/dialogs/alice/doc/smart-home/start-docpage/ API] и позволяет интегрировать '''Яндекс Алису''' с оборудованием сторонних производителей и системами умного дома. Модуль реализует '''авторизационный сервис''' на основе стандарта '''OAuth 2.0''' и '''Provider Adapter API''' - промежуточный API, который принимает на вход запросы в формате платформы умного дома Яндекс и преобразует их в запросы к API '''MajorDoMo'''.

Особенностью платформы умного дома '''Яндекс''' является '''новая''' специальная '''категория''' навыков '''Алисы''', которая предназначена для голосового управления домашними устройствами и не требует предварительного запуска навыка по его имени. Теперь устройствами можно управлять прямыми командами вида ''"Алиса, включи свет в гостиной"'', ''"Алиса, сделай в спальне похолоднее"'' и т. п. При этом следует понимать, что в отличие от классических навыков, '''Яндекс''' не передает в '''MajorDoMo''' распознанный текст команды пользователя, а передается непосредственно управляющая команда для устройства, которая интерпретируется модулем и записывается в привязанное свойство объекта.

Модуль реализует классическую концепцию '''MajorDoMo''' для взаимодействия с пользователем через '''метрики''' и привязанные к ним '''свойства объекта'''. К метрикам привязываются уже существующие объекты и свойства, через которые реализовано управление устройствами.

Обсуждение модуля на [https://mjdm.ru/forum/viewtopic.php?f=5&t=6498 '''Форуме'''].

Исходный код модуля на [https://github.com/skysilver-lab/majordomo-yandexhome '''Github'''].

Модуль в [https://connect.smartliving.ru/tasks/482.html '''Connect'''].

[[Файл:Module yandexhome.png|800px|мини|центр|Module yandexhome]]

Для успешного функционирования модуля и управления устройствами, подключенными к '''MajorDoMo''', через ассистента '''Яндекс Алиса''' требуется, в первую очередь, '''опубликовать обработчики запросов''' (конечные точки, вебхуки) в сеть Интернет и обеспечить тем самым их доступность со стороны облака '''Яндекс''' по доменному имени ('''DNS''') и протоколу '''HTTPS'''. Во вторую очередь, необходимо в консоли разработчика платформы Яндекс Диалогов создать, настроить и опубликовать '''приватный навык''' специальной категории '''Умный дом'''.

В модуле '''Yandex Home''' все обработчики запросов реализованы в виде отдельных файлов: ''authorize.php'', '''token.php''' и '''smarthome.php''', и размещаются в директории ''/modules/yandexhome''.

'''Назначение вебхука''' '''URL вебхука''' '''Пример опубликованной ссылки'''
URL авторизации /modules/yandexhome/authorize.php https://majordomo.keenetic.pro/modules/yandexhome/authorize.php
URL для получения и обновления токена /modules/yandexhome/token.php https://majordomo.keenetic.pro/modules/yandexhome/token.php
URL обработчика навыка /modules/yandexhome/smarthome.php https://majordomo.keenetic.pro/modules/yandexhome/smarthome.php

В конечном итоге '''запуск модуля''' сводится к такой последовательности шагов:

1. Установка модуля из маркета дополнений.

2. Настройка модуля.

3. Публикация обработчиков запросов.

4. Регистрация приватного навыка.

5. Объединение аккаунтов в приложении Яндекс.

6. Добавление и управление устройствами в модуле

==Поддерживаемые умения==

'''Метрика (умение)''' '''Описание''' '''Значения в модуле''' '''Значения от Яндекс'''
1 on Включить/выключить (1 - включено, 0 выключено). 1 и 0 true и false
2 volume Громкость (проценты). 1 - 100 (*) 1 - 100, либо +1/-1
3 channel ТВ-канал. № канала (*) № канала, либо +1/-1
4 temperature Температура (градусы цельсия). 1 - 100 (*) °C
5 temperature_k Температура цвета (кельвины). 2700 - 9000 2700 - 9000
6 thermostat Температурный режим. auto, heat, cool, eco, dry, fan_only auto, heat, cool, eco, dry, fan_only
7 mute Режим без звука (1 - включено, 0 выключено). 1 и 0 true и false
8 fan_speed Скорость вентиляции. auto, low, medium, high auto, low, medium, high
9 rgb Цвет в формате RGB (hex). 000000 - FFFFFF 0 - 16777215
10 brightness Яркость (проценты). 1 - 100 (*) 1 - 100

* Имеется возможность переопределить диапазон значений и шаг изменения.

==Требования==

1. '''Публичный''' (глобальный, белый) '''IP-адрес''', выдаваемый интернет-провайдером.

2. '''Доменное имя''' (DNS), привязанное к публичному IP-адресу.

3. Валидный '''SSL-сертификат''' на DNS-имя.

4. Опубликованные в Интернет обработчики запросов (без требования ввода логина и пароля).

5. Зарегистрированный и опубликованный приватный навык категории Умный дом.

6. Активное PHP-расширение pdo_mysql.

==Установка модуля==

Чтобы установить модуль, нужно в '''Панели управления MajorDoMo''' перейти в раздел '''Система''' и открыть '''Маркет дополнений'''. Модуль находится в категории '''Взаимодействие'''. Открываем эту вкладку и ищем в списке строку с модулем. Для установки нажимаем кнопку '''Добавить'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737355f696d6167652e706e67.png|800px|мини|центр|рис 1]]

Процесс установки отобразится в виде лога. После успешной установки система перенаправит обратно на страницу '''Маркета дополнений''', а в разделе '''Устройства''' Панели управления появится новый пункт с модулем '''Yandex Home'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737365f696d6167652e706e67.png|800px|мини|центр|Установка]]

==Настройка модуля==

Настройка модуля заключается в генерации значений OAuth2 ID и OAuth2 KEY с помощью соответствующей кнопки, а также ввод произвольных логина и пароля пользователя, которые впоследствии будут запрошены в ходе объединения аккаунтов в приложении Яндекс.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737375f696d6167652e706e67.png|800px|мини|центр|Настройка]]

На ранних этапах использования модуля рекомендуется включить ведение логов событий - Отладка DebMes.

При необходимости можно указать, какой использовать стиль отображения списка устройств на главной странице модуля.

==Публикация обработчиков запросов==

Механизм взаимодействия платформы умного дома Яндекс со сторонними системами (провайдерами) реализуется посредством вебхуков (webhook). Облако Яндекс для запроса состояния устройств и управления ими посылает POST- и GET- запросы на конечные точки (endpoint) вебхуков и получает ответы от них. Таким образом, для корректной работы этого механизма необходимо обеспечить постоянную доступность вебхуков из сети Интернет со стороны облака Яндекс.

Согласно API платформы умного дома Яндекс требуется реализовать три типа конечных точек:

1. URL авторизации (authorization endpoint) - страница, на которой авторизуется пользователь, чтобы разрешить навыку доступ к своему аккаунту.

2. URL для получения и обновления токена (token endpoint) - адрес, на который отправляются запросы с авторизационным кодом, чтобы получить OAuth-токен доступа, и запросы для обновления ранее полученного токена.

3. URL обработчика навыка (smarthome endpoint) - основной вебхук, который отвечает непосредственно за работу с устройствами.

В модуле Yandex Home все три типа конечных точек реализованы в виде отдельных файлов: authorize.php, token.php и smarthome.php, размещаемых в директории /modules/yandexhome.

# Назначение вебхука URL вебхука

1 URL авторизации /modules/yandexhome/authorize.php

2 URL для получения и обновления токена /modules/yandexhome/token.php

3 URL обработчика навыка /modules/yandexhome/smarthome.php

Чтобы опубликовать эти три вебхука в сеть Интернет и обеспечить тем самым их доступность со стороны облака Яндекс, необходимо выполнить ряд условий.

Условие №1. Публичный (глобальный, белый) IP-адрес, выдаваемый интернет-провадером.

Белый IP-адрес при этом может быть как статическим, так и динамическим. В случаях, когда невозможно получить белый адрес у интернет-провайдера, возможны варианты использования сторонних сервисов. Например, некоторые производители роутеров предоставляют их владельцам сервис по доступу к ресурсам домашней локальной сети (KeenDNS от Keenetic и др). Либо использовать VPN-сервисы на подобие vpnki.ru или собственный VPN-сервер, развернутый на VPS.

Условие №2. Доменное имя (DNS), привязанное к публичному IP-адресу.

Это требование в большинстве случаев закрывается классическими сервисами динамических DNS, которых представлено в сети в большом ассортименте, как платных, так и бесплатных. Большинство современных роутеров уже имеют встроенную поддержку сервисов Dynamic DNS. При использовании сервисов удаленного доступа типа KeenDNS или VPNKI это условие выполняется автоматически - доменное имя выбирается и присвается в ходе регистрации и подключения услуги.

Условие №3. Валидный SSL-сертификат на DNS-имя.

По требованиям платформы умного дома Яндекс весь обмен трафиком между их облаком и MajorDoMo должен идти в зашифрованном виде по протоколу HTTPS, что обеспечивается либо установкой SSL-сертификата на веб-сервер с MajorDoMo, либо услугами сервисов удаленного доступа (см. выше). Бесплатный SSL-сертификат можно получить у удостоверяющего центра Let’s Encrypt сроком на 3 месяца, затем его нужно будет регулярно обновлять. Сертификат устанавливается либо на тот же виртуальный сервер Apache, который обслуживает MajorDoMo, либо на отдельный виртуальный сервер (Apache или Nginx), выступающий в роли обратного прокси (reverse proxy) для MajorDoMo.

Корректность установки сертификата и доступность вашего сервера из сети Интернет по HTTPS можно проверить с помощью специализированных сервисов, например:

https://ssllabs.com/ssltest/analyze.html
https://www.geocerts.com/ssl-checker
https://www.digicert.com/help/
https://www.sslshopper.com/ssl-checker.html

==Регистрация приватного навыка==

Навыки умного дома - специальная категория навыков Алисы, предназначенных для голосового управления домашними устройствами. Навыки создаются в [https://dialogs.yandex.ru/developer/ консоли разработчика] платформы Яндекс Диалогов.

Основные шаги по созданию навыка это:

1. Настройка связки аккаунтов OAuth 2.0.

2. Добавление навыка и выбор его типа.

3. Заполнение информационных полей.

4. Модерация навыка.

5. Публикация навыка.

Чтобы создать новый приватный навык, открываем [https://dialogs.yandex.ru/developer/ консоль разработчика] и авторизуемся под нужной учетной записью.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3734395f696d6167652e706e67.png|800px|мини|без|Яндекс диалоги]]

В личном кабинете разработчика нажимаем шестеренку и переходим в раздел Настройки, где открываем вкладку Связки аккаунтов.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735315f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

После чего добавляем новую связку и заполняем ее поля (детальное описание [https://tech.yandex.ru/dialogs/alice/doc/auth/account-linking-docpage/ здесь]).

- Название - понятное вам название связки.

- Идентификатор приложения - значение OAuth2 ID из настроек модуля Yandex Home.

- Секрет приложения - значение OAuth2 KEY из настроек модуля Yandex Home.

- URL авторизации - адрес вебхука авторизации (см. предыдущую статью), например, - https://majordomo.keenetic.pro:8443/modules/yandexhome/authorize.php

- URL для получения токена - адрес вебхука получения токена (см. предыдущую статью), например, https://majordomo.keenetic.pro:8443/modules/yandexhome/token.php

- URL для обновления токена - тот же самый, что и пунктом выше, например, https://majordomo.keenetic.pro:8443/modules/yandexhome/token.php

- Идентификатор группы действий - оставляем пустым.

- Идентификатор OAuth приложения - оставляем пустым.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735305f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

Сохраняем связку и возвращаемся на главную страницу консоли разработчика, на которой создаем новый навык, кликнув по кнопке Создать диалог.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735325f696d6167652e706e67.png|800px|мини|центр|Создать диалог]]

Тип навыка выбираем '''Умный дом'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735335f696d6167652e706e67 (1).png|800px|мини|центр|Тип диалога]]

Последовательно заполняем поля (детальное описание [https://tech.yandex.ru/dialogs/alice/doc/smart-home/start-docpage/ здесь]).

- Название - указываем название навыка.

- Endpoint URL - адрес вебхука обработчика навыка (см. предыдущую статью),

например, https://majordomo.keenetic.pro:8443/modules/yandexhome/smarthome.php.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735355f696d6167652e706e67.png|800px|мини|центр|Основные настройки]]

- Приватность - обязательно ставим галочку Не показывать в каталоге.

- Подзаголовок - пишем краткое описание навыка.

- Имя разработчика - фамилия, имя.

- E-mail разработчика - пишем аккаунт Яндекс.Почты.

- Сайт для верификации прав использования бренда - оставляем пустым.

- Описание - произвольное описание нашего навыка.

- Заметки для модератора - оставляем пустым.

- Иконка - логотип навыка в формате PNG или JPG.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735365f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

- Связка аккаунтов - в выпадающем списке выбрать ранее созданную связку.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735375f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

Сохраняем изменения, после чего становится активной кнопка На модерацию. Кликаем на нее и отправляем наш навык на модерацию. На сегодняшний день модерация автоматическая и происходит мгновенно.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735385f696d6167652e706e67.png|800px|мини|центр|Черновик]]

После модерации остается завершающий этап - '''публикация''' навыка. Нажимаем кнопку '''Опубликовать'''''Курсивное начертание'' и на главной странице консоли разработчика видим, что навык сменил статус и переместился в раздел '''Опубликованные'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735395f696d6167652e706e67.png|800px|мини|центр|Публикация]]

Опубликованный приватный навык появится в списке навыков умного дома в приложении Яндекс (или в его веб-версии [https://quasar.yandex.ru/skills/iot/ quasar]).

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736305f696d6167652e706e67.png|800px|мини|центр|Первые шаги]]

На следующем шаге можно приступать к объединению аккаунтов.

==Объединение аккаунтов в приложении Яндекс==

Следующим этапом после регистрации и публикации приватного навыка является '''объединение аккаунтов''' в приложении умного дома '''Яндекс'''. Это - '''завершающий этап по интеграции сторонних систем (и MajorDoMo в частности) с платформой умного дома Яндекс, после которого становится доступным управление устройствами с помощью голосового ассистента Яндекс Алиса'''.

Чтобы объединить аккаунты, с главной страницы приложения (Google Play или App Store) необходимо зайти в раздел '''''Умный дом''''', а затем тапнуть кнопку '''Добавить устройство''', после чего откроется раздел '''''Популярные производители'''''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736315f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

В списке производителей выбираем наш приватный навык и тапаем кнопку '''Объединить аккаунты'''. Приложение переадресует на страницу авторизации навыка, на которой нужно ввести '''''логин пользователя и пароль пользователя''''', указанные ранее в настройках модуля '''Yandex Home'''. После успешной авторизации подтверждаем сопряжение кнопкой '''Предоставить'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736325f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

Приложение переадресует обратно на страницу свойств навыка, а кнопка '''Объединить аккаунты''' изменится на '''Обновить список устройств'''. Тапаем на нее и после успешной синхронизации будет предложено перейти на страницу со списком устройств. Если в этот момент в модуле '''Yandex Home''' уже были добавлены устройства, то они отобразятся в приложении. В дальнейшем при добавлении устройств в модуле или изменении их свойств необходимо каждый раз выполнять такую синхронизацию для обновления списка устройств в '''приложении Яндекс'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736335f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

==Добавление и управление устройствами в модуле==

Модуль реализует классическую концепцию '''MajorDoMo''' для взаимодействия с пользователем через '''метрики''' и '''привязанные''' к ним '''свойства объекта'''. К метрикам (умениям) привязываются уже существующие объекты и свойства, через которые '''реализовано управление''' устройствами. К каждому умению устройства можно привязать свое свойство объекта.

Добавление нового устройства выполняется с помощью кнопки '''Добавить устройство''' на главной странице модуля. После чего указываются название, тип и местоположение устройства.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737385f696d6167652e706e67.png|800px|мини|центр|Настройка]]

Дальнейшее конфигурирование выполняется на странице редактирования (настройки) устройства.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737395f696d6167652e706e67.png|800px|мини|центр|Конфигурирование]]

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738305f696d6167652e706e67.png|800px|мини|центр|Настройка устройств]]

'''Обязательные''' для заполнения '''поля''' устройства:

1. Название.

2. Тип.

3. Местоположение.

4. Умения.

У каждого устройства '''должно быть''' указано '''минимум одно''' умение.

'''Не обязательные''' для заполнения '''поля''' устройства:

1. Описание.

2. Производитель.

3. Модель.

4. Версия программного обеспечения (ПО).

5. Версия аппаратного обеспечения (АО).

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738315f696d6167652e706e67.png|800px|мини|центр|Описание полей]]

'''Набор умений''' представлен в виде выпадающего списка.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738325f696d6167652e706e67.png|800px|мини|центр|Набор умений]]

'''Привязка свойства''' объекта к конкретному '''умению''' выполняется также с помощью выпадающих списков.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738335f696d6167652e706e67.png|800px|мини|центр|Привязка свойств]]

При добавлении устройств в модуле или изменении их свойств для обновления списка устройств в '''приложении Яндекс''' необходимо каждый раз выполнять синхронизацию с помощью кнопки '''Обновить список устройств''' в окне свойств навыка. Удаляются устройства из '''приложения Яндекс''' вручную, либо через '''отвязывание аккаунта''' и последующее повторное объединение аккаунтов.

==Документация по модулю==

1. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-obschie-svedeniya.html MajorDoMo и Яндекс Алиса. Общие сведения.]

2. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-publikaciya-vebhukov.html MajorDoMo и Яндекс Алиса. Публикация вебхуков.]

3. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-registraciya-privatnogo-navyka.html MajorDoMo и Яндекс Алиса. Регистрация приватного навыка.]

4. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-obyedinenie-akkauntov.html MajorDoMo и Яндекс Алиса. Объединение аккаунтов.]

5. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-modul-yandex-home.html MajorDoMo и Яндекс Алиса. Модуль Yandex Home.]

6. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-vklyuchi-svet-na-kuhne.html MajorDoMo и Яндекс Алиса. Алиса, включи свет на кухне.]

7. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-uvelich-yarkost-nastolnoy-lampy.html MajorDoMo и Яндекс Алиса. Алиса, сделай ярче настольную лампу.]

8. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-izmeni-cvet-bra-na-krasnyy.html MajorDoMo и Яндекс Алиса. Алиса, измени цвет бра на красный.]

9. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-vklyuchi-kanal-karusel.html MajorDoMo и Яндекс Алиса. Алиса, включи канал Карусель.]

Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738335f696d6167652e706e67.png

2020-01-21T18:44:53Z

George2017:

Привязка свойств