Инструкция к виджету трансляции событий (Event Broadcast)/en: различия между версиями

Материал из SmartPlayer
← Предыдущая правкаСледующая правка →
N.Bloshkin (обсуждение | вклад)
Администраторы интерфейса, Администраторы
8249 правок
Новая страница: «== '''Widget Main Page''' == After transferring the widget to the personal account, the user must double-click the widget icon to perform the initial configuration. The widget's main page will then open. thumb|center| Example of the widget's main page|800px On the widget's main page, the user can click the gear icon to open the widget settings. File:Иконка_настройки_...»
Нет описания правки
Строка 1: Строка 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
== '''Description of the Situation''' ==
== '''Description of the Situation''' ==
SmartPlayer has developed a widget that allows users to control a broadcast and the events within it using buttons on touch screens. This widget makes it possible to create control elements (buttons) to which reactions and events can be assigned. The configured widget can be used as a remote control for managing a broadcast.
SmartPlayer has developed a widget that allows users to control a broadcast and the events within it using buttons on touch screens. This widget makes it possible to create control elements (buttons) to which reactions and events can be assigned. The configured widget can be used as a remote control for managing a broadcast.
Строка 15: Строка 14:
On the widget's main page, the user can click the gear icon to open the widget settings.
On the widget's main page, the user can click the gear icon to open the widget settings.
[[File:Иконка_настройки_виджета_трансляций.png|thumb|center| Example of the icon used to open the widget settings|800px]]
[[File:Иконка_настройки_виджета_трансляций.png|thumb|center| Example of the icon used to open the widget settings|800px]]
== '''The "Settings" Button''' ==
After opening the widget settings, the user will see a list of configurable parameters on the left side of the screen. The right side contains the widget preview area, where all changes are displayed.
[[File:Разделение_экрана_в_настройках.png|thumb|center| Example of the screen layout in the widget's '''Settings''' section|800px]]
The widget settings include the following parameters:
* '''Language Selection''' — allows the user to choose one of the available interface languages. The following languages are available: Russian, English, Portuguese, Spanish, and Kazakh;
* '''Widget Font Size''' — allows the user to set the text font size using a slider or a numeric value;
* '''Widget Background''' — allows the user to select the widget background color using a color palette. The color can also be specified using a HEX code selected from any publicly available color palette;
* '''Widget Background Image''' — allows the user to select an image using the '''Select Image''' button. The required image must first be uploaded to the SmartPlayer personal account;
* '''Button Scale''' — allows the user to set the size of the buttons created in the widget using a slider or a numeric value;
* '''Button Type''' — allows the user to choose the button appearance. Two options are available: square corners or rounded corners;
* '''Add Button''' — adds a clickable button to the widget;
* '''Add Button Group''' — adds a button that can contain other buttons and expand when pressed.
[[File:Настройких_виджета.png|thumb|center| Example of the widget configuration parameters|800px]]
== '''Configuring Buttons for Broadcast Events''' ==
Clicking the '''Add Button''' or '''Add Button Group''' buttons changes the widget interface and displays additional settings specific to each option.
=== '''Add Button''' ===
After clicking the '''Add Button''' button, the widget settings interface changes.
[[File:Добавление_кнопки.png|thumb|center| Example of the interface after clicking '''Add Button'''|800px]]
To configure the added button, the user must specify the following parameters:
* '''Button Name''' — specify the button label;
* '''Broadcast Identifier''' — specify the ID of the broadcast associated with the button. The ID can be copied from the browser address bar while viewing an existing broadcast;
[[File:Идентификатор_трансляции.png|thumb|center| Example of a broadcast ID|800px]]
* '''Event Name''' — a fixed parameter. By default, the event name is '''label''';
* '''Event Value''' — specify the event value configured in the broadcast settings;
* '''Button Image''' — after clicking the '''Select Image''' button, the user must select an image for the button from the SmartPlayer personal account. It is recommended to upload the image in advance.
[[File:Настройки_кнопки в виджете.png|thumb|center| Example of button settings|800px]]
=== '''Add Button Group''' ===
After clicking the '''Add Button Group''' button, the widget settings interface changes.
[[File:Добавить_группу_кнопок.png|thumb|center| Example of the interface after clicking '''Add Button Group'''|800px]]
To configure the newly added button group, the user must specify the following parameters:
* '''Group Name''' — specify the group name;
* '''Button Image''' — after clicking the '''Select Image''' button, the user must select an image from the SmartPlayer personal account. It is recommended to upload the image in advance;
* '''Add Button''' — adds the button settings described in the previous section. These settings must be configured. The newly added button will become part of the group.
[[File:Группа_кнопок.png|thumb|center| Example of button group settings|800px]]
== '''Completing the Widget Configuration''' ==
After configuring the widget, the user must click the '''Apply Settings''' button in the lower-right corner of the screen.
[[File:Применение_настрок.png|thumb|center| Example of the '''Apply Settings''' button|800px]]
The widget will then expand to full screen, and the user must click the '''Save''' button located at the bottom center of the screen.
[[File:Сохран.png|thumb|center| Example of the '''Save''' button|800px]]
== '''Importing and Exporting Settings''' ==
While working with the widget settings, the user can upload previously saved settings or download the current widget configuration. Each action is performed using a separate icon in the widget interface. These icons are located at the bottom center of the widget.
[[File:Иконки_загрузки.png|thumb|center| Example of the icons used for importing and exporting widget settings|800px]]
== '''Server Logic''' ==
When configuring the widget, buttons, or button groups, the user defines the parameters that the SmartPlayer server application responds to.
The SmartPlayer server application responds to the following parameters:
* broadcast identifier;
* event name;
* event value.
[[File:Параметры_для_события.png|thumb|center| Example of the parameters used for server interaction|800px]]
{{Note|Please note: the user must configure the event using the following path: '''Add Event''' in the broadcast or in the event list → select the '''Server Application''' event → '''Key by Payload''' → '''Value''' (the numeric event value).|warn}}
When the widget is configured correctly, every touch interaction will cause the server application to perform the assigned action, such as switching to another content page.
{{Note|To configure this correctly, review the documentation listed in the section below. Pay particular attention to the documentation on server events.|warn}}
== '''Adding the Configured Widget to a Broadcast''' ==
To fully understand how this functionality works, the user must launch a scheduled broadcast and add this widget as content. Detailed information about creating broadcasts and schedules is available in the following SmartPlayer Wiki articles:
* [[Раздел "Устройства"]]
* [[Раздел "Контент на устройства"]]
* [[Раздел "Трансляции"]]
* [[Раздел "Расписание"]]
* [[Подключения и интеграция в SmartPlayer c использованием серверных событий]]
== '''Video Tutorial''' ==
[https://vkvideo.ru/video-227547238_456239143 Event Broadcast Widget Guide (Event Broadcast)]
== '''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 '''Discussions''' section at the top of the page.
[[File:Обсужление_Трансялции_событий.png|thumb|center| Example of the '''Discussions''' tab on a wiki page|800px]]
Additional information is also available on the page [[Как взаимодействовать пользователю с разделом "Обсуждения"]].
</div>


== '''Widget Main Page''' ==
== '''Widget Main Page''' ==

Версия от 10:50, 17 июля 2026

Другие языки:

Description of the Situation

SmartPlayer has developed a widget that allows users to control a broadcast and the events within it using buttons on touch screens. This widget makes it possible to create control elements (buttons) to which reactions and events can be assigned. The configured widget can be used as a remote control for managing a broadcast.

Adding the Widget to the Personal Account

To add this widget to the personal account, the user must request the archive containing the widget from a SmartPlayer technical support specialist. It will be provided as a ZIP archive.

Example of the widget provided as a ZIP archive

After that, the user must log in to the personal account and navigate to the Content section.

Example of the Content section in the personal account

In the Content section, the widget must be transferred from local storage to the personal account. Once the user uploads the widget, it will appear in the content list.

Example of transferring the widget to the SmartPlayer personal account

Widget Main Page

After transferring the widget to the personal account, the user must double-click the widget icon to perform the initial configuration. The widget's main page will then open.

Example of the widget's main page

On the widget's main page, the user can click the gear icon to open the widget settings.

Example of the icon used to open the widget settings

Widget Main Page

After transferring the widget to the personal account, the user must double-click the widget icon to perform the initial configuration. The widget's main page will then open.

Example of the widget's main page

On the widget's main page, the user can click the gear icon to open the widget settings.

Example of the icon used to open the widget settings

The "Settings" Button

After opening the widget settings, the user will see a list of configurable parameters on the left side of the screen. The right side contains the widget preview area, where all changes are displayed.

Example of the screen layout in the widget's Settings section

The widget settings include the following parameters:

  • Language Selection — allows the user to choose one of the available interface languages. The following languages are available: Russian, English, Portuguese, Spanish, and Kazakh;
  • Widget Font Size — allows the user to set the text font size using a slider or a numeric value;
  • Widget Background — allows the user to select the widget background color using a color palette. The color can also be specified using a HEX code selected from any publicly available color palette;
  • Widget Background Image — allows the user to select an image using the Select Image button. The required image must first be uploaded to the SmartPlayer personal account;
  • Button Scale — allows the user to set the size of the buttons created in the widget using a slider or a numeric value;
  • Button Type — allows the user to choose the button appearance. Two options are available: square corners or rounded corners;
  • Add Button — adds a clickable button to the widget;
  • Add Button Group — adds a button that can contain other buttons and expand when pressed.
Example of the widget configuration parameters

Configuring Buttons for Broadcast Events

Clicking the Add Button or Add Button Group buttons changes the widget interface and displays additional settings specific to each option.

Add Button

After clicking the Add Button button, the widget settings interface changes.

Example of the interface after clicking Add Button

To configure the added button, the user must specify the following parameters:

  • Button Name — specify the button label;
  • Broadcast Identifier — specify the ID of the broadcast associated with the button. The ID can be copied from the browser address bar while viewing an existing broadcast;
Example of a broadcast ID
  • Event Name — a fixed parameter. By default, the event name is label;
  • Event Value — specify the event value configured in the broadcast settings;
  • Button Image — after clicking the Select Image button, the user must select an image for the button from the SmartPlayer personal account. It is recommended to upload the image in advance.
Example of button settings

Add Button Group

After clicking the Add Button Group button, the widget settings interface changes.

Example of the interface after clicking Add Button Group

To configure the newly added button group, the user must specify the following parameters:

  • Group Name — specify the group name;
  • Button Image — after clicking the Select Image button, the user must select an image from the SmartPlayer personal account. It is recommended to upload the image in advance;
  • Add Button — adds the button settings described in the previous section. These settings must be configured. The newly added button will become part of the group.
Example of button group settings

Completing the Widget Configuration

After configuring the widget, the user must click the Apply Settings button in the lower-right corner of the screen.

Example of the Apply Settings button

The widget will then expand to full screen, and the user must click the Save button located at the bottom center of the screen.

Example of the Save button

Importing and Exporting Settings

While working with the widget settings, the user can upload previously saved settings or download the current widget configuration. Each action is performed using a separate icon in the widget interface. These icons are located at the bottom center of the widget.

Example of the icons used for importing and exporting widget settings

Server Logic

When configuring the widget, buttons, or button groups, the user defines the parameters that the SmartPlayer server application responds to. The SmartPlayer server application responds to the following parameters:

  • broadcast identifier;
  • event name;
  • event value.
Example of the parameters used for server interaction
Please note: the user must configure the event using the following path: Add Event in the broadcast or in the event list → select the Server Application event → Key by Payload → Value (the numeric event value).

When the widget is configured correctly, every touch interaction will cause the server application to perform the assigned action, such as switching to another content page.

To configure this correctly, review the documentation listed in the section below. Pay particular attention to the documentation on server events.

Adding the Configured Widget to a Broadcast

To fully understand how this functionality works, the user must launch a scheduled broadcast and add this widget as content. Detailed information about creating broadcasts and schedules is available in the following SmartPlayer Wiki articles:

Video Tutorial

Event Broadcast Widget Guide (Event Broadcast)

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 Discussions section at the top of the page.

Example of the Discussions tab on a wiki page

Additional information is also available on the page Как взаимодействовать пользователю с разделом "Обсуждения".

Настройки кнопок для событий трансляции

Кнопки «Добавить кнопку» и «Добавить группу кнопок» при нажатии изменяют интерфейс виджета и добавляют дополнительные параметры для настройки каждого варианта по отдельности.

Добавить кнопку

При нажатии на кнопку «Добавить кнопку» пользователь увидит изменения интерфейса в настройках виджета.

Пример отображения изменений интерфейса при нажатии «Добавить кнопку»

Для настройки добавленной кнопки пользователю необходимо изменить следующие параметры:

  • название кнопки — указать текстовое название кнопки;
  • идентификатор трансляции — указать ID трансляции, к которой будет привязана кнопка. ID можно скопировать из адресной строки при просмотре уже созданной трансляции;
Пример отображения ID трансляции
  • имя события — неизменяемый параметр. По умолчанию установлено значение события «label»;
  • значение события — указать значение события, установленное при настройке трансляции;
  • изображение кнопки — после нажатия на кнопку «Выберите изображение» пользователь должен выбрать изображение кнопки из личного кабинета SmartPlayer. Рекомендуется загрузить изображение заранее.
Пример отображения настроек кнопки

Добавить группу кнопок

При нажатии на кнопку «Добавить группу кнопок» пользователь увидит изменения интерфейса в настройках виджета.

Пример отображения изменений интерфейса при нажатии «Добавить группу кнопок»

Для настройки добавленной группы кнопок пользователю необходимо изменить следующие параметры:

  • имя группы — указать текстовое название группы;
  • изображение кнопки — после нажатия на кнопку «Выберите изображение» пользователь должен выбрать изображение кнопки из личного кабинета SmartPlayer. Рекомендуется загрузить изображение заранее;
  • кнопка «Добавить кнопку» — добавляет настройки кнопки, описанные в разделе выше. Данные параметры необходимо настроить. Добавленная здесь кнопка будет входить в группу.
Пример отображения параметров для настройки группы кнопок

Завершение настройки виджета

После завершения настройки виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана.

Пример отображения кнопки «Применить настройки»

Далее виджет развернётся на весь экран, и пользователь должен нажать на кнопку «Сохранить», расположенную внизу по центру экрана.

Пример отображения кнопки «Сохранить»

Загрузка и скачивание настроек

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

Пример отображения иконок в настройках виджета

Серверная логика

При настройке параметров виджета, кнопок или групп кнопок, пользователь настраивает параметры, на которые реагирует серверное приложение SmartPlayer. Список параметров, на которые реагирует серверное приложение SmartPlayer:

  • идентификатор трансляции;
  • имя события;
  • значение события.
Пример отображения параметров, взаимодействующих с сервером
Обратите внимание: пользователю необходимо настроить событие по следующему пути: «Добавить событие» в трансляции или в списке событий → выбрать событие «Серверное приложение» → ключ по полезной нагрузке → значение, то есть числовое значение события.

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

Добавление настроенного виджета в трансляцию

Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить данный виджет в качестве контента. Подробнее с описанными ранее шагами по созданию трансляции и расписания можно ознакомиться в следующих статьях Wiki SmartPlayer:

Видеоинструкция

Инструкция к виджету трансляции событий (Event Broadcast)

Дополнительная информация

Если данная статья не помогает использовать функциональность по назначению или после её прочтения остаются вопросы, их можно задать в разделе «Обсуждения» вверху страницы.

Пример отображения вкладки «Обсуждения» на wiki-странице

Также дополнительную информацию можно узнать на странице Как взаимодействовать пользователю с разделом "Обсуждения".

Источник — https://wiki.smartplayer.org/index.php?title=Инструкция_к_виджету_трансляции_событий_(Event_Broadcast)/en&oldid=20396