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

Материал из SmartPlayer
Новая страница: «Event Widget User Guide»
 
Новая страница: «== '''Completing Widget Configuration''' == After completing the widget setup, the user must click the "Apply Settings" button in the lower right corner of the screen. thumb|center| Example of the "Apply Settings" button |800px Next, the widget will expand to full screen and the user must click the "Save" button at the bottom center of the screen. File:Сохран.png|thumb|center| Example of the "Sav...»
 
(не показана 1 промежуточная версия этого же участника)
Строка 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]]
* фон виджета позволяет настроить фон виджета с помощью палитры;
== '''Completing Widget Configuration''' ==
* изображение фона виджета позволяет выбрать изображение в качестве фона виджета из доступных в личном кабинете.
After completing the widget setup, the user must click the "Apply Settings" button in the lower right corner of the screen.
[[File:Настройки_фона_виджета.png|thumb|center| Пример отображения параметров для фона|800px]]
[[File:Применение_настрок.png|thumb|center| Example of the "Apply Settings" button |800px]]
=== '''Настройки кнопок и групп кнопок''' ===
Next, the widget will expand to full screen and the user must click the "Save" button at the bottom center of the screen.
В данный блок настроек входят следующие параметры:
[[File:Сохран.png|thumb|center| Example of the "Save" button |800px]]
* кнопка «Добавить кнопку» создает окно со следующими параметрами:
=== '''How the Configured Widget Works''' ===
[[File:Параметры_кнопки.png|thumb|center| Пример отображения списка параметров|800px]]
Once the widget is configured, the user will see the created buttons or button groups on the screen. By pressing them with the remote control, events can be switched, and the original broadcasts will resume playback.
* название кнопки пользователю необходимо прописать название кнопки;
== '''Loading and Downloading Widget Settings''' ==
* идентификатор трансляции пользователю необходимо найти нужную трансляцию, кликнуть на нее и скопировать из URL значение параметра "broadcastid";
During interaction with the widget settings, the user can upload or download the widget configuration. Each of these actions can be performed using separate icons in the widget interface. The icons are located at the bottom center of the widget.
[[File:Идентификатор_транлсяции.png|thumb|center| Пример отображения идентификатора трансляции|800px]]
[[File:Иконки_загрузки.png|thumb|center| Example of the icons in the widget settings |800px]]
* имя события наименование события, которое знает сервер (по умолчанию и всегда "label");
== '''Widget Work Specifics and Nuances''' ==
* значение события вводится значение, которое используется при создании события в трансляции. Значение события можно настроить в трансляции выбрав «серверное приложение» и выставив определение по «полезной нагрузке». Укажите нужное вам значение в трансляции.
This widget, like any solution, has its "weak points," which are listed in this section:
[[File:Работа_с_событиями.png|thumb|center| Пример отображения значения для события|800px]]
* When working with the widget, the user can configure the switching of a single screen using a button on the remote control. The event on this screen will start, while other devices will continue playing the current broadcast.
{{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}}
== '''Adding the Configured Widget to a Broadcast''' ==
* кнопка «Добавить группу» создает окно с двумя параметрами:
To fully explore how this functionality works, the user needs to start a broadcast with a schedule and add this widget as content. To get familiar with the previously mentioned steps on how to create a broadcast and schedule, it is recommended to review the following Wikipedia articles:
[[File:Параметры_кнопки.png|thumb|center| Пример отображения списка параметров|800px]]
* название группы позволяет пользователю создать хранилище для группового хранения кнопок;
* добавить кнопку функционал идентичен описанному выше в этом разделе.
[[File:Доавбление_групп.png|thumb|center| Пример отображения параметров для групп|800px]]
</div>
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Завершение настройки виджета''' ==
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана.
[[File:Применение_настрок.png|thumb|center| Пример отображения кнопки «Применить настройки»|800px]]
Далее виджет растянется на весь экран и пользователь должен нажать на кнопку «Сохранить», внизу по центру экрана.
[[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]]
=== '''Работа настроенного виджета''' ===
Когда виджет будет настроен пользователь увидит на экране созданные кнопки или группы кнопок, при нажатии на которые, с помощью пульта, можно переключать события и возвращать исходные трансляции для проигрывания.
== '''Загрузка и скачивание настроек''' ==
В процессе взаимодействия с настройками виджета пользователь может загрузить или выгрузить настройки виджета. Каждое из указанных действий можно сделать с помощью отдельных иконок в интерфейсе виджета. Иконки расположены в виджете снизу по центру.
[[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок в настройках виджета |800px]]
== '''Тонкости и нюансы в работе виджета''' ==
Данный виджет, как и любое решение имеет свои «узкие» места, которые будут обозначены в этом разделе:
* При работе с виджетом пользователь может настроить переключение одного экрана по кнопке с пульта. Событие на этом экране запустится, остальные устройства продолжат проигрывать текущую трансляцию.
== '''Добавление настроенного виджета в трансляцию''' ==
Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить в качестве контента данный виджет. Чтобы ознакомиться с описанными ранее шагами по созданию трансляции и расписания рекомендуется просмотреть следующие статьи из Wikipedia:
* [[Раздел "Устройства"]]
* [[Раздел "Устройства"]]
* [[Раздел "Контент на устройства"]]
* [[Раздел "Контент на устройства"]]
* [[Раздел "Трансляции"]]
* [[Раздел "Трансляции"]]
* [[Раздел "Расписание"]]
* [[Раздел "Расписание"]]
== '''Видеоинструкция''' ==
== '''Video Instruction''' ==
[https://vk.com/video-227547238_456239090 Настройка виджета переключения событий]
[https://vk.com/video-227547238_456239090 Setting Up the Event Switching Widget]
== '''Дополнительная информация''' ==
== '''Additional Information''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
If this article does not help to use the functionality as intended or if there are any remaining questions after reading, they can be asked in the "Discussions" section at the top of the page.
[[File:Обсуждение_виджета_событий.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
[[File:Обсуждение_виджета_событий.png|thumb|center| Example of the "Discussions" tab on the wiki page |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
You can also find additional information on the page [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</div>

Текущая версия от 09:49, 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

Completing Widget Configuration

After completing the widget setup, the user must click the "Apply Settings" button in the lower right corner of the screen.

Example of the "Apply Settings" button

Next, the widget will expand to full screen and the user must click the "Save" button at the bottom center of the screen.

Example of the "Save" button

How the Configured Widget Works

Once the widget is configured, the user will see the created buttons or button groups on the screen. By pressing them with the remote control, events can be switched, and the original broadcasts will resume playback.

Loading and Downloading Widget Settings

During interaction with the widget settings, the user can upload or download the widget configuration. Each of these actions can be performed using separate icons in the widget interface. The icons are located at the bottom center of the widget.

Example of the icons in the widget settings

Widget Work Specifics and Nuances

This widget, like any solution, has its "weak points," which are listed in this section:

  • When working with the widget, the user can configure the switching of a single screen using a button on the remote control. The event on this screen will start, while other devices will continue playing the current broadcast.

Adding the Configured Widget to a Broadcast

To fully explore how this functionality works, the user needs to start a broadcast with a schedule and add this widget as content. To get familiar with the previously mentioned steps on how to create a broadcast and schedule, it is recommended to review the following Wikipedia articles:

Video Instruction

Setting Up the Event Switching Widget

Additional Information

If this article does not help to use the functionality as intended or if there are any remaining questions after reading, they can be asked in the "Discussions" section at the top of the page.

Example of the "Discussions" tab on the wiki page

You can also find additional information on the page Как взаимодействовать пользователю с разделом "Обсуждения"