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

Материал из SmartPlayer
Новая страница: «Event Widget User Guide»
 
Новая страница: «== '''Widget Description''' == This widget allows users to utilize event functionality across multiple devices simultaneously. That means, if users have several devices/screens, each playing its own stream, a button press on the remote control will trigger the widget to simultaneously start playing the desired event on all three devices, interrupting the current broadcast. After the event playback is complete, the widget stops functioning and the original br...»
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Widget Description''' == This widget allows users to utilize event functionality across multiple devices simultaneously. That means, if users have several devices/screens, each playing its own stream, a button press on the remote control will trigger the widget to simultaneously start playing the desired event on all three devices, interrupting the current broadcast. After the event playback is complete, the widget stops functioning and the original broadcasts on the devices resume.
== '''Описание виджета''' ==
== '''Adding the Widget to the Personal Account''' == To add this widget to the personal account, the user must request it from the SmartPlayer support team. It will be provided as a ".zip" archive. [[File:Архив_виджета.png|thumb|center| Example of widget in ".zip" archive format|800px]]
Данный виджет позволит пользователям использовать функционал событий на нескольких устройствах одновременно. То есть, если у пользователей несколько устройств/экранов, и на каждом из них проигрывается своя трансляция. По нажатию кнопки на пульте на всех трех устройствах виджет запускает синхронное проигрывание нужного события и прерывает текущую трансляцию. После проигрывания события виджет прекращает функционировать и исходные трансляции на устройствах продолжают своё проигрывание.
Next, the user must log into their personal SmartPlayer account and go to the "Content" section. [[File:Раздел_контент_личного_кабиента.png|thumb|center| Example of "Content" section in personal account |800px]]
== '''Добавление виджета в личный кабинет''' ==
In the "Content" section, drag the widget from local storage into the "Content" area. After uploading, the widget will appear in the content list. [[File:Виджет_событий_в_лк.png|thumb|center| Example of widget drag-n-drop upload|800px]]
Чтобы добавить данный виджет в личный кабинет пользователю необходимо запросить у специалиста команды технической поддержки виджет. Он будет предоставлен в формате ".zip" - архива.
== '''Widget Setup''' == After uploading the widget to the "Content" section, the user should double-click the widget icon to start the initial setup. This action opens the widget's homepage. [[File:Главная_странциа_виджета.png|thumb|center| Example of widget homepage|800px]]
[[File:Архив_виджета.png|thumb|center| Пример виджета в формате ".zip" - архива|800px]]
On the homepage, users can access the widget settings by clicking the gear icon. [[File:Настройка_виджета.png|thumb|center| Example of settings icon|800px]]
После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент».
== '''Widget Configuration Parameters''' == After entering the widget settings, the user will see two configuration blocks:
[[File:Раздел_контент_личного_кабиента.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]]
* Font size and background;
В разделе «Контент» необходимо перетянуть данный виджет из локального хранилища в раздел «Контент». После того как пользователь перенесет виджет в личный кабинет он отобразится в списке с контентом.
* Button and button group settings.
[[File:Виджет_событий_в_лк.png|thumb|center| Пример отображения переноса виджета с помощью drag-n-drop|800px]]
[[File:Блоки_настроек_виджета.png|thumb|center| Example of widget settings blocks|800px]]
== '''Настройка виджета''' ==
=== '''Font Size and Background''' === This block includes the following parameters:
После переноса виджета в раздел «Контент» для первичной настройки виджета пользователю необходимо дважды кликнуть по иконке виджета. Данное действие перенесет его на главную страницу виджета.
* Language selection allows the user to choose from available localizations: Russian, English, Spanish, Portuguese, Kazakh;
[[File:Главная_странциа_виджета.png|thumb|center| Пример отображения главной страницы виджета|800px]]
*Font size allows the user to set font size via value or slider;
На главной странице виджета можно перейти в настройки параметров виджета. Это можно сделать с помощью клика по иконке в виде шестеренки.
*Widget background allows the user to set the background using a palette;
[[File:Настройка_виджета.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]]
*Background image allows selection of an image from available files in the personal account. [[File:Настройки_фона_виджета.png|thumb|center| Example of background settings|800px]]
== '''Параметры для настройки виджета''' ==
=== '''Button and Button Group Settings''' === This block includes the following parameters:
После перехода на страницу настроек виджета, пользователь обнаружит два блока настроек:
*"Add Button" button opens a window with the following parameters: [[File:Параметры_кнопки.png|thumb|center| Example of button parameter list|800px]]
# Размер шрифта и фон виджета;
*Button name user must enter the button label;
# Настройки кнопок и групп кнопок.
*Broadcast ID user must find the desired broadcast, click on it, and copy the "broadcastid" value from the URL; [[File:Идентификатор_транлсяции.png|thumb|center| Example of broadcast ID|800px]]
[[File:Блоки_настроек_виджета.png|thumb|center| Пример отображения настроек виджета|800px]]
*Event name the event label known to the server (default and always "label");
=== '''Размер шрифта и фон виджета''' ===
*Event value the value used when creating the event in the broadcast. It is configured by selecting "server application" and defining it by "payload." Enter the required value in the broadcast. [[File:Работа_с_событиями.png|thumb|center| Example of event value configuration|800px]] {{Note|You can learn more about the trigger-event model [https://wiki.smartplayer.org/index.php/%D0%A2%D1%80%D0%B8%D0%B3%D0%B3%D0%B5%D1%80%D0%BD%D1%8B%D0%B5_%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F_%D0%B2_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BB%D1%8F%D1%86%D0%B8%D0%B8 here]|warn}}
Блок включает в себя следующий набор параметров:
*"Add Group" button — opens a window with two parameters: [[File:Параметры_кнопки.png|thumb|center| Example of button parameter list|800px]]
* выбор языка позволяет пользователю выбрать одну из доступных локализаций для работы виджета: русская, английская, испанская, португальская, казахская;
*Group name allows the user to create a container for storing grouped buttons;
* размер шрифта позволяет пользователю выставить размер шрифта с помощью значения или с помощью ползунка;
*Add button the same functionality described above. [[File:Доавбление_групп.png|thumb|center| Example of group configuration parameters|800px]]
* фон виджета позволяет настроить фон виджета с помощью палитры;
* изображение фона виджета позволяет выбрать изображение в качестве фона виджета из доступных в личном кабинете.
[[File:Настройки_фона_виджета.png|thumb|center| Пример отображения параметров для фона|800px]]
=== '''Настройки кнопок и групп кнопок''' ===
В данный блок настроек входят следующие параметры:
* кнопка «Добавить кнопку» создает окно со следующими параметрами:
[[File:Параметры_кнопки.png|thumb|center| Пример отображения списка параметров|800px]]
* название кнопки пользователю необходимо прописать название кнопки;
* идентификатор трансляции пользователю необходимо найти нужную трансляцию, кликнуть на нее и скопировать из URL значение параметра "broadcastid";
[[File:Идентификатор_транлсяции.png|thumb|center| Пример отображения идентификатора трансляции|800px]]
* имя события наименование события, которое знает сервер (по умолчанию и всегда "label");
* значение события вводится значение, которое используется при создании события в трансляции. Значение события можно настроить в трансляции выбрав «серверное приложение» и выставив определение по «полезной нагрузке». Укажите нужное вам значение в трансляции.
[[File:Работа_с_событиями.png|thumb|center| Пример отображения значения для события|800px]]
{{Note|Ознакомиться с триггерно-событийной моделью можно по ссылке [https://wiki.smartplayer.org/index.php/%D0%A2%D1%80%D0%B8%D0%B3%D0%B3%D0%B5%D1%80%D0%BD%D1%8B%D0%B5_%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F_%D0%B2_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BB%D1%8F%D1%86%D0%B8%D0%B8 здесь]|warn}}
* кнопка «Добавить группу» создает окно с двумя параметрами:
[[File:Параметры_кнопки.png|thumb|center| Пример отображения списка параметров|800px]]
* название группы позволяет пользователю создать хранилище для группового хранения кнопок;
* добавить кнопку функционал идентичен описанному выше в этом разделе.
[[File:Доавбление_групп.png|thumb|center| Пример отображения параметров для групп|800px]]
</div>
<div lang="ru" dir="ltr" class="mw-content-ltr">
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Завершение настройки виджета''' ==
== '''Завершение настройки виджета''' ==

Версия от 09:44, 4 сентября 2025

== Widget Description == This widget allows users to utilize event functionality across multiple devices simultaneously. That means, if users have several devices/screens, each playing its own stream, a button press on the remote control will trigger the widget to simultaneously start playing the desired event on all three devices, interrupting the current broadcast. After the event playback is complete, the widget stops functioning and the original broadcasts on the devices resume.

== Adding the Widget to the Personal Account == To add this widget to the personal account, the user must request it from the SmartPlayer support team. It will be provided as a ".zip" archive.

Example of widget in ".zip" archive format

Next, the user must log into their personal SmartPlayer account and go to the "Content" section.

Example of "Content" section in personal account

In the "Content" section, drag the widget from local storage into the "Content" area. After uploading, the widget will appear in the content list.

Example of widget drag-n-drop upload

== Widget Setup == After uploading the widget to the "Content" section, the user should double-click the widget icon to start the initial setup. This action opens the widget's homepage.

Example of widget homepage

On the homepage, users can access the widget settings by clicking the gear icon.

Example of settings icon

== Widget Configuration Parameters == After entering the widget settings, the user will see two configuration blocks:

  • Font size and background;
  • Button and button group settings.
Example of widget settings blocks

=== Font Size and Background === This block includes the following parameters:

  • Language selection — allows the user to choose from available localizations: Russian, English, Spanish, Portuguese, Kazakh;
  • Font size — allows the user to set font size via value or slider;
  • Widget background — allows the user to set the background using a palette;
  • Background image — allows selection of an image from available files in the personal account.
    Example of background settings

=== Button and Button Group Settings === This block includes the following parameters:

  • "Add Button" button — opens a window with the following parameters:
    Example of button parameter list
  • Button name — user must enter the button label;
  • Broadcast ID — user must find the desired broadcast, click on it, and copy the "broadcastid" value from the URL;
    Example of broadcast ID
  • Event name — the event label known to the server (default and always "label");
  • Event value — the value used when creating the event in the broadcast. It is configured by selecting "server application" and defining it by "payload." Enter the required value in the broadcast.
    Example of event value configuration
    You can learn more about the trigger-event model here
  • "Add Group" button — opens a window with two parameters:
    Example of button parameter list
  • Group name — allows the user to create a container for storing grouped buttons;
  • Add button — the same functionality described above.
    Example of group configuration parameters

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

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

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

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

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

Работа настроенного виджета

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

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

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

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

Тонкости и нюансы в работе виджета

Данный виджет, как и любое решение имеет свои «узкие» места, которые будут обозначены в этом разделе:

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

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

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

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

Настройка виджета переключения событий

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

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

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

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