Работа таймеров включения и выключения для группы устройств/en: различия между версиями

Материал из SmartPlayer
Новая страница: «Working with Power On/Off Timers for Device Groups»
 
Новая страница: «== '''Description of the Situation''' == The timer configuration for device groups has been enhanced to support automated operation. The SmartPlayer platform now supports power on/off timers at the group level and allows adjusting the timers for device groups using a special JSON file sent from the server. As a result, both the group and individual devices within the group (with their own timers) can receive this timer configuration file. {{Note|To learn how...»
 
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Description of the Situation''' ==
== '''Описание ситуации''' ==
The timer configuration for device groups has been enhanced to support automated operation. The SmartPlayer platform now supports power on/off timers at the group level and allows adjusting the timers for device groups using a special JSON file sent from the server. As a result, both the group and individual devices within the group (with their own timers) can receive this timer configuration file.
Для групп устройств была доработана настройка таймеров, влияющая на автоматическую работу. Теперь платформа SmartPlayer поддерживает работу таймеров включения и выключения на уровне групп устройств и позволяет влиять на таймер включения/выключения групп устройств с помощью специального JSON-файла отправляемого сервером. Таким образом файл с описанием работы таймеров может получить как группа устройств, так и каждое устройство из группы имеющее свой таймер.
{{Note|To learn how power on/off timers work for individual devices, see [https://wiki.smartplayer.org/index.php/%D0%A2%D0%B0%D0%B9%D0%BC%D0%B5%D1%80%D1%8B_%D0%B2%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D1%8F_%D0%B8_%D0%B2%D1%8B%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D1%8F_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2 here]. We recommend reviewing this page before working with the feature.|warn}}
{{Note|С работой функционала таймеров включения и выключения для отдельных устройств можно ознакомиться [https://wiki.smartplayer.org/index.php/%D0%A2%D0%B0%D0%B9%D0%BC%D0%B5%D1%80%D1%8B_%D0%B2%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D1%8F_%D0%B8_%D0%B2%D1%8B%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D1%8F_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2 здесь]. Рекомендуется просмотреть эту страницу перед работой с функционалом.|warn}}
== '''How It Works''' ==
== '''Принцип действия''' ==
{{Note|To test and use the timer feature, you need to obtain an API key. For more on creating API keys in the SmartPlayer dashboard, see [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%B9_%D1%87%D0%B5%D1%80%D0%B5%D0%B7_API_%D0%B2_%D0%BB%D0%B8%D1%87%D0%BD%D0%BE%D0%BC_%D0%BA%D0%B0%D0%B1%D0%B8%D0%BD%D0%B5%D1%82%D0%B5/ru here].|warn}}
{{Note|Для проверки и работы функционала таймеров необходимо получить API-ключ. Подробнее о возможности создать API-ключи в личном кабинете SmartPlayer[https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%B9_%D1%87%D0%B5%D1%80%D0%B5%D0%B7_API_%D0%B2_%D0%BB%D0%B8%D1%87%D0%BD%D0%BE%D0%BC_%D0%BA%D0%B0%D0%B1%D0%B8%D0%BD%D0%B5%D1%82%D0%B5/ru здесь]. |warn}}
To configure timers for a device group, the user must register/log into the SmartPlayer platform.<br>
Чтобы настроить таймеры для группы устройств пользователю необходимо зарегистрироваться/авторизоваться на платформе SmartPalyer.<br>
Then, go to the "Devices" section and create (or find) a group with the required devices.
Перейти в раздел «Устройства» личного кабинета и создать (найти) группу с нужными устройствами.
[[File:Группа_устройств таймеры.png|thumb|center| Example of a device group displayed in the "Devices" section|800px]]
[[File:Группа_устройств таймеры.png|thumb|center| Пример отображения группы устройств в разделе «Устройства»|800px]]
Select the group by clicking on it and navigate to the right-hand panel. In this panel, select the "Group Settings" section.
Кликом выделить их и перейти в правую часть экрана личного кабинета. В правой части откроется панель управления в которой необходимо выбрать раздел «Настройки группы».
[[File:Панель_управления_настройки_группы.png|thumb|center| Example of the "Group Settings" section|800px]]
[[File:Панель_управления_настройки_группы.png|thumb|center| Пример отображения раздела «Настройки группы»|800px]]
A new page with a list of setting categories will open. In this case, the relevant category is "Automation Management". Click this category.
Далее откроется новая страница со списком категорий настроек. В данном случае нужной категорией является «Автоматизация управления». На эту категорию пользователю и надо кликнуть.
[[File:Раздел_автоматизации.png|thumb|center| Example of the "Automation Management" category|800px]]
[[File:Раздел_автоматизации.png|thumb|center| Пример отображения категории «Автоматизации управления»|800px]]
On the page, a configuration block for timers under "Automation Management" will appear. The following parameters are available:
После открытия на странице отобразится доступный для настройки набор параметров категории «Автоматизации управления». Пользователю доступен блок с таймерами настройки, в котором есть следующие параметры:
* repeat allows selecting the repeat mode: never, once, daily, weekly;
* повтор позволяет выбрать один из доступных вариантов использования повтора работы таймера: никогда, один раз, ежедневно, еженедельно;
* date allows setting the repeat date (only appears if the repeat option is not "Never");
* дата позволяет выставить дату повтора. Отображение может меняться в зависимости от выбранного варианта в параметре «Повтор» (не отображается при варианте повтора «Никогда»);
* time allows setting the repeat time (only appears if the repeat option is not "Never");
* время позволяет выставить время повтора. Отображение может меняться в зависимости от выбранного варианта в параметре «Повтор» (не отображается при варианте повтора «Никогда»);
* volume level at startup slider to set volume level (note: may not apply immediately after reboot);
* уровень громкости при включении шкала с ползунком для настройки громкости. В описании указано, что настройка может примениться не сразу после перезапуска;
* sleep mode checkbox enables/disables the device's manufacturer-supported sleep mode.
* чекбокс (галочка) спящий режим позволяет активировать/деактивировать с помощью чекбокса спящий режим устройства, предусмотренный производителем.  
[[File:Параметры_настройки_таймеров.png|thumb|center| Example of the "Automation Management" parameters|800px]]
[[File:Параметры_настройки_таймеров.png|thumb|center| Пример отображения параметров категорией «Автоматизации управления»|800px]]
=== '''Auto Timer Configuration via JSON File''' ===
=== '''Автоматическое переключение таймера с помощью файла''' ===
{{Note|This feature works by sending a JSON file. When the SmartPlayer server requests data, a JSON file with timer settings is sent for waking up the devices. This file is sent from the client server once per day to devices linked to the account via a URL request. The received timer info will be processed and automatically applied to the group’s devices. You can view the applied timers in the "Automation Management" block under "Group Settings".|warn}}
{{Note|Реализация построена таким образом, что при работе с JSON-файлами, происходит отправка данных. В момент отправки, когда сервер SmartPlayer обращается за данными, также отправляется JSON-файл с таймерами для пробуждения устройств. Этот файл будет отправляться с клиентского сервера раз в день по URL-запросу на устройства привязанные к личному кабинету. Полученная информация по таймерам включения/выключения будет обработана и автоматически применена к устройствам внутри группы. Просмотреть изменения в таймерах можно в разделе «Настройки группы» в блоке «Автоматизация управления».|warn}}
The JSON file must contain the following fields for timers to update automatically:
JSON-файл должен содержать в себе следующие поля, для корректного обновление таймеров автоматически:
* date — date;
* date — дата;
* apt — folder name;
* apt — название папки;
* city — name of the city where the device is located;
* city — название города, в котором расположено устройство;
* wt_beg — timer to activate sleep mode;
* wt_beg — таймер активации спящего режима;
* wt_end — timer to wake the device from sleep mode.
* wt_end — таймер для пробуждения устройства из спящего режима.
[[File:Пример_полей_в_файле.png|thumb|center| Example of JSON file parameters|800px]]
[[File:Пример_полей_в_файле.png|thumb|center| Пример отображения параметров JSON-файла|800px]]
You can download a template of the JSON file [https://demofordoc.hb.ru-msk.vkcloud-storage.ru/timers%20%282%29.json here].
Сам шаблон файла можно найти по ссылке [https://demofordoc.hb.ru-msk.vkcloud-storage.ru/timers%20%282%29.json здесь]
== '''Additional Information''' ==
== '''Дополнительная информация''' ==
If this article does not help you use the functionality as intended or if you still have questions after reading it, you can ask them in the "Discussion" section at the top of the page.
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, их можно озвучить в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_работы_таймеров.png|thumb|center| Example of the "Discussion" tab on the wiki page |800px]]
[[File:Обсуждение_работы_таймеров.png|thumb|center| Пример отображения вкладки «Обсуждения» на wiki-странице |800px]]
You can also learn more on the page [[How users can interact with the "Discussions" section]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</div>

Текущая версия от 09:45, 24 декабря 2025

Description of the Situation

The timer configuration for device groups has been enhanced to support automated operation. The SmartPlayer platform now supports power on/off timers at the group level and allows adjusting the timers for device groups using a special JSON file sent from the server. As a result, both the group and individual devices within the group (with their own timers) can receive this timer configuration file.

To learn how power on/off timers work for individual devices, see here. We recommend reviewing this page before working with the feature.

How It Works

To test and use the timer feature, you need to obtain an API key. For more on creating API keys in the SmartPlayer dashboard, see here.

To configure timers for a device group, the user must register/log into the SmartPlayer platform.
Then, go to the "Devices" section and create (or find) a group with the required devices.

Example of a device group displayed in the "Devices" section

Select the group by clicking on it and navigate to the right-hand panel. In this panel, select the "Group Settings" section.

Example of the "Group Settings" section

A new page with a list of setting categories will open. In this case, the relevant category is "Automation Management". Click this category.

Example of the "Automation Management" category

On the page, a configuration block for timers under "Automation Management" will appear. The following parameters are available:

  • repeat — allows selecting the repeat mode: never, once, daily, weekly;
  • date — allows setting the repeat date (only appears if the repeat option is not "Never");
  • time — allows setting the repeat time (only appears if the repeat option is not "Never");
  • volume level at startup — slider to set volume level (note: may not apply immediately after reboot);
  • sleep mode checkbox — enables/disables the device's manufacturer-supported sleep mode.
Example of the "Automation Management" parameters

Auto Timer Configuration via JSON File

This feature works by sending a JSON file. When the SmartPlayer server requests data, a JSON file with timer settings is sent for waking up the devices. This file is sent from the client server once per day to devices linked to the account via a URL request. The received timer info will be processed and automatically applied to the group’s devices. You can view the applied timers in the "Automation Management" block under "Group Settings".

The JSON file must contain the following fields for timers to update automatically:

  • date — date;
  • apt — folder name;
  • city — name of the city where the device is located;
  • wt_beg — timer to activate sleep mode;
  • wt_end — timer to wake the device from sleep mode.
Example of JSON file parameters

You can download a template of the JSON file here.

Additional Information

If this article does not help you use the functionality as intended or if you still have questions after reading it, you can ask them in the "Discussion" section at the top of the page.

Example of the "Discussion" tab on the wiki page

You can also learn more on the page How users can interact with the "Discussions" section