Инструкция к виджету трансляции событий (Event Broadcast): различия между версиями
Материал из SmartPlayer
Нет описания правки |
Нет описания правки |
||
| (не показано 18 промежуточных версий этого же участника) | |||
| Строка 1: | Строка 1: | ||
<languages/> | |||
<translate> | |||
== '''Описание ситуации''' == | == '''Описание ситуации''' == | ||
Компания SmartPlayer разработала виджет, который позволяет управлять трансляцией и событиями | Компания SmartPlayer разработала виджет, который позволяет управлять трансляцией и событиями внутри неё с помощью кнопок на сенсорных экранах. Данный виджет позволяет создавать элементы управления — кнопки, к которым можно привязать реакции и события. Настроенный виджет можно использовать в качестве пульта управления трансляцией. | ||
== '''Добавление виджета в личный кабинет''' == | == '''Добавление виджета в личный кабинет''' == | ||
Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате | Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате ZIP-архива. | ||
[[File:Виджет_показа_трансляций.png|thumb|center| Пример виджета в формате | [[File:Виджет_показа_трансляций.png|thumb|center| Пример виджета в формате ZIP-архива|800px]] | ||
После этого | После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент». | ||
[[File:Контент_в_лк.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]] | [[File:Контент_в_лк.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете|800px]] | ||
В разделе «Контент» необходимо перенести данный виджет из локального хранилища в личный кабинет. После того как пользователь | В разделе «Контент» необходимо перенести данный виджет из локального хранилища в личный кабинет. После того как пользователь перенесёт виджет в личный кабинет, он отобразится в списке контента. | ||
[[File:Виджет_в_лк контент.png|thumb|center| Пример отображения переноса виджета в личном кабинете SmartPlayer|800px]] | [[File:Виджет_в_лк контент.png|thumb|center| Пример отображения переноса виджета в личном кабинете SmartPlayer|800px]] | ||
== '''Главная страница виджета''' == | == '''Главная страница виджета''' == | ||
После переноса виджета для первичной настройки пользователю необходимо дважды | После переноса виджета в личный кабинет для первичной настройки пользователю необходимо дважды нажать на иконку виджета. После этого откроется главная страница. | ||
[[File: | [[File:Главная_страница_другой_версии.png|thumb|center| Пример отображения главной страницы виджета|800px]] | ||
На главной странице виджета пользователь может | На главной странице виджета пользователь может нажать на иконку в виде шестерёнки, чтобы перейти в настройки виджета. | ||
[[File: | [[File:Переход_в_настройки_другой_ui.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]] | ||
== '''Кнопка «Настройки»''' == | == '''Кнопка «Настройки»''' == | ||
После открытия настроек виджета пользователь увидит список настраиваемых в левой части экрана. В правой части экрана | После открытия настроек виджета пользователь увидит список настраиваемых параметров в левой части экрана. В правой части экрана находится область предпросмотра виджета, на которой будут отображаться все вносимые изменения. | ||
[[File: | [[File:Разделение_экрана_с_виджетами.png|thumb|center| Пример отображения разделения экрана в разделе «Настройки» виджета|800px]] | ||
В список настраиваемых параметров виджета входят: | В список настраиваемых параметров виджета входят: | ||
* выбор языка — выбрать один из доступных языков для отображения интерфейса виджета. Доступны следующие языки: русский, английский, португальский, испанский и казахский; | * выбор языка — позволяет выбрать один из доступных языков для отображения интерфейса виджета. Доступны следующие языки: русский, английский, португальский, испанский и казахский; | ||
* размер шрифта виджета — установить размер шрифта с помощью ползунка или | * размер шрифта виджета — позволяет установить размер шрифта текста с помощью ползунка или числового значения; | ||
* фон виджета — позволяет выбрать фон | * фон виджета — позволяет выбрать фон виджета с помощью палитры. Цвет внутри палитры можно указать с помощью HEX-кода, который можно подобрать с помощью общедоступных цветовых палитр; | ||
* изображение фона виджета — выбрать изображение | * изображение фона виджета — позволяет выбрать изображение с помощью кнопки «Выберите изображение». Предварительно нужное изображение необходимо загрузить в личный кабинет SmartPlayer; | ||
* масштаб кнопок — установить масштаб с помощью ползунка или | * масштаб кнопок — позволяет установить масштаб создаваемых в виджете кнопок с помощью ползунка или числового значения; | ||
* тип кнопок — выбрать | * тип кнопок — позволяет выбрать тип отображения кнопок на экране. Доступны два варианта: с прямыми углами и со скруглёнными углами; | ||
* | * кнопка «Добавить кнопку» — добавляет на экран виджета кнопку, которая реагирует на нажатие; | ||
* | * кнопка «Добавить группу кнопок» — добавляет на экран виджета кнопку с возможностью добавить в неё другие кнопки и разворачивать их по нажатию. | ||
[[File: | [[File:Блок_настроек_виджета.png|thumb|center| Пример отображения параметров для настройки виджета|800px]] | ||
== '''Настройки кнопок для событий трансляции''' == | == '''Настройки кнопок для событий трансляции''' == | ||
Кнопки «Добавить кнопку» и «Добавить группу кнопок» при нажатии | Кнопки «Добавить кнопку» и «Добавить группу кнопок» при нажатии изменяют интерфейс виджета и добавляют дополнительные параметры для настройки каждого варианта по отдельности. | ||
=== '''Добавить кнопку''' === | === '''Добавить кнопку''' === | ||
При нажатии на кнопку «Добавить кнопку» пользователь увидит изменения интерфейса в настройках виджета. | При нажатии на кнопку «Добавить кнопку» пользователь увидит изменения интерфейса в настройках виджета. | ||
[[File:Добавление_кнопки.png|thumb|center| Пример отображения изменений интерфейса при нажатии «Добавить кнопку»|800px]] | [[File:Добавление_кнопки.png|thumb|center| Пример отображения изменений интерфейса при нажатии «Добавить кнопку»|800px]] | ||
Для настройки добавленной кнопки пользователю необходимо изменить следующие параметры: | Для настройки добавленной кнопки пользователю необходимо изменить следующие параметры: | ||
* название кнопки — | * название кнопки — указать текстовое название кнопки; | ||
* идентификатор трансляции — указать ID | * идентификатор трансляции — указать ID трансляции, к которой будет привязана кнопка. ID можно скопировать из адресной строки при просмотре уже созданной трансляции; | ||
[[File:Идентификатор_трансляции.png|thumb|center| Пример отображения ID | [[File:Идентификатор_трансляции.png|thumb|center| Пример отображения ID трансляции|800px]] | ||
* имя события — неизменяемый | * имя события — неизменяемый параметр. По умолчанию установлено значение события «label»; | ||
* значение события — | * значение события — указать значение события, установленное при настройке трансляции; | ||
* изображение кнопки — | * изображение кнопки — после нажатия на кнопку «Выберите изображение» пользователь должен выбрать изображение кнопки из личного кабинета SmartPlayer. Рекомендуется загрузить изображение заранее. | ||
[[File:Настройки_кнопки в виджете.png|thumb|center| Пример отображения настроек кнопки|800px]] | [[File:Настройки_кнопки в виджете.png|thumb|center| Пример отображения настроек кнопки|800px]] | ||
=== '''Добавить группу кнопок''' === | === '''Добавить группу кнопок''' === | ||
При нажатии на кнопку «Добавить | При нажатии на кнопку «Добавить группу кнопок» пользователь увидит изменения интерфейса в настройках виджета. | ||
[[File:Добавить_группу_кнопок.png|thumb|center| Пример отображения изменений интерфейса при нажатии «Добавить | [[File:Добавить_группу_кнопок.png|thumb|center| Пример отображения изменений интерфейса при нажатии «Добавить группу кнопок»|800px]] | ||
Для настройки добавленной группы кнопок пользователю необходимо изменить следующие параметры: | Для настройки добавленной группы кнопок пользователю необходимо изменить следующие параметры: | ||
* имя группы — | * имя группы — указать текстовое название группы; | ||
* изображение кнопки — | * изображение кнопки — после нажатия на кнопку «Выберите изображение» пользователь должен выбрать изображение кнопки из личного кабинета SmartPlayer. Рекомендуется загрузить изображение заранее; | ||
* кнопка «Добавить кнопку» — добавляет настройки | * кнопка «Добавить кнопку» — добавляет настройки кнопки, описанные в разделе выше. Данные параметры необходимо настроить. Добавленная здесь кнопка будет входить в группу. | ||
[[File:Группа_кнопок.png|thumb|center| Пример отображения параметров для настройки группы кнопок|800px]] | [[File:Группа_кнопок.png|thumb|center| Пример отображения параметров для настройки группы кнопок|800px]] | ||
== '''Завершение настройки виджета''' == | == '''Завершение настройки виджета''' == | ||
После завершения | После завершения настройки виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана. | ||
[[File:Применение_настрок.png|thumb|center| Пример отображения кнопки «Применить настройки»|800px]] | [[File:Применение_настрок.png|thumb|center| Пример отображения кнопки «Применить настройки»|800px]] | ||
Далее виджет | Далее виджет развернётся на весь экран, и пользователь должен нажать на кнопку «Сохранить», расположенную внизу по центру экрана. | ||
[[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]] | [[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]] | ||
== '''Загрузка и скачивание настроек''' == | == '''Загрузка и скачивание настроек''' == | ||
При работе с настройками виджета пользователь может загрузить ранее сохранённые настройки или скачать текущие настройки виджета. Каждое из указанных действий выполняется с помощью отдельных иконок в интерфейсе виджета. Иконки расположены в нижней части виджета по центру. | |||
[[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок в настройках виджета |800px]] | [[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок в настройках виджета|800px]] | ||
== '''Серверная логика''' == | == '''Серверная логика''' == | ||
При настройке параметров виджета | При настройке параметров виджета, кнопок или групп кнопок, пользователь настраивает параметры, на которые реагирует серверное приложение SmartPlayer. | ||
Список параметров на которые реагирует серверное приложение SmartPlayer | Список параметров, на которые реагирует серверное приложение SmartPlayer: | ||
* идентификатор трансляции; | * идентификатор трансляции; | ||
* имя события; | * имя события; | ||
* значение события. | * значение события. | ||
[[File:Параметры_для_события.png|thumb|center| Пример отображения параметров взаимодействующих с сервером |800px]] | [[File:Параметры_для_события.png|thumb|center| Пример отображения параметров, взаимодействующих с сервером|800px]] | ||
{{Note|Обратите внимание пользователю | {{Note|Обратите внимание: пользователю необходимо настроить событие по следующему пути: «Добавить событие» в трансляции или в списке событий → выбрать событие «Серверное приложение» → ключ по полезной нагрузке → значение, то есть числовое значение события.|warn}} | ||
При правильной настройке виджета на каждое касание серверное приложение будет | При правильной настройке виджета на каждое касание серверное приложение будет выполнять действие, связанное с нажатием, например переключение страницы с контентом. | ||
Чтобы настроить это правильно, ознакомьтесь с инструкциями в разделе ниже или по [https://wiki.smartplayer.org/index.php?title=%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D1%8F_%D0%B8_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2_SmartPlayer_c_%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%D0%BC_%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%BD%D1%8B%D1%85_%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B9 ссылке здесь]. Особое внимание уделите серверным событиям. | |||
== '''Добавление настроенного виджета в трансляцию''' == | == '''Добавление настроенного виджета в трансляцию''' == | ||
Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить в качестве контента | Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить данный виджет в качестве контента. Подробнее с описанными ранее шагами по созданию трансляции и расписания можно ознакомиться в следующих статьях Wiki SmartPlayer: | ||
* [[Раздел "Устройства"]] | * [[Раздел "Устройства"]] | ||
* [[Раздел "Контент на устройства"]] | * [[Раздел "Контент на устройства"]] | ||
| Строка 73: | Строка 77: | ||
* [[Подключения и интеграция в SmartPlayer c использованием серверных событий]] | * [[Подключения и интеграция в SmartPlayer c использованием серверных событий]] | ||
== '''Видеоинструкция''' == | == '''Видеоинструкция''' == | ||
[https:// | [https://vkvideo.ru/video-227547238_456239143 Инструкция к виджету трансляции событий (Event Broadcast)] | ||
== '''Дополнительная информация''' == | == '''Дополнительная информация''' == | ||
Если данная статья не помогает использовать | Если данная статья не помогает использовать функциональность по назначению или после её прочтения остаются вопросы, их можно задать в разделе «Обсуждения» вверху страницы. | ||
[[File:Обсужление_Трансялции_событий.png|thumb|center| Пример отображения вкладки «Обсуждения» на wiki-странице |800px]] | [[File:Обсужление_Трансялции_событий.png|thumb|center| Пример отображения вкладки «Обсуждения» на wiki-странице|800px]] | ||
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]] | Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]. | ||
</translate> | |||
Текущая версия от 10:53, 17 июля 2026
Описание ситуации
Компания SmartPlayer разработала виджет, который позволяет управлять трансляцией и событиями внутри неё с помощью кнопок на сенсорных экранах. Данный виджет позволяет создавать элементы управления — кнопки, к которым можно привязать реакции и события. Настроенный виджет можно использовать в качестве пульта управления трансляцией.
Добавление виджета в личный кабинет
Чтобы добавить данный виджет в личный кабинет, пользователю необходимо запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате ZIP-архива.
После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент».
В разделе «Контент» необходимо перенести данный виджет из локального хранилища в личный кабинет. После того как пользователь перенесёт виджет в личный кабинет, он отобразится в списке контента.
Главная страница виджета
После переноса виджета в личный кабинет для первичной настройки пользователю необходимо дважды нажать на иконку виджета. После этого откроется главная страница.
На главной странице виджета пользователь может нажать на иконку в виде шестерёнки, чтобы перейти в настройки виджета.
Кнопка «Настройки»
После открытия настроек виджета пользователь увидит список настраиваемых параметров в левой части экрана. В правой части экрана находится область предпросмотра виджета, на которой будут отображаться все вносимые изменения.
В список настраиваемых параметров виджета входят:
- выбор языка — позволяет выбрать один из доступных языков для отображения интерфейса виджета. Доступны следующие языки: русский, английский, португальский, испанский и казахский;
- размер шрифта виджета — позволяет установить размер шрифта текста с помощью ползунка или числового значения;
- фон виджета — позволяет выбрать фон виджета с помощью палитры. Цвет внутри палитры можно указать с помощью HEX-кода, который можно подобрать с помощью общедоступных цветовых палитр;
- изображение фона виджета — позволяет выбрать изображение с помощью кнопки «Выберите изображение». Предварительно нужное изображение необходимо загрузить в личный кабинет SmartPlayer;
- масштаб кнопок — позволяет установить масштаб создаваемых в виджете кнопок с помощью ползунка или числового значения;
- тип кнопок — позволяет выбрать тип отображения кнопок на экране. Доступны два варианта: с прямыми углами и со скруглёнными углами;
- кнопка «Добавить кнопку» — добавляет на экран виджета кнопку, которая реагирует на нажатие;
- кнопка «Добавить группу кнопок» — добавляет на экран виджета кнопку с возможностью добавить в неё другие кнопки и разворачивать их по нажатию.
Настройки кнопок для событий трансляции
Кнопки «Добавить кнопку» и «Добавить группу кнопок» при нажатии изменяют интерфейс виджета и добавляют дополнительные параметры для настройки каждого варианта по отдельности.
Добавить кнопку
При нажатии на кнопку «Добавить кнопку» пользователь увидит изменения интерфейса в настройках виджета.
Для настройки добавленной кнопки пользователю необходимо изменить следующие параметры:
- название кнопки — указать текстовое название кнопки;
- идентификатор трансляции — указать ID трансляции, к которой будет привязана кнопка. ID можно скопировать из адресной строки при просмотре уже созданной трансляции;
- имя события — неизменяемый параметр. По умолчанию установлено значение события «label»;
- значение события — указать значение события, установленное при настройке трансляции;
- изображение кнопки — после нажатия на кнопку «Выберите изображение» пользователь должен выбрать изображение кнопки из личного кабинета SmartPlayer. Рекомендуется загрузить изображение заранее.
Добавить группу кнопок
При нажатии на кнопку «Добавить группу кнопок» пользователь увидит изменения интерфейса в настройках виджета.
Для настройки добавленной группы кнопок пользователю необходимо изменить следующие параметры:
- имя группы — указать текстовое название группы;
- изображение кнопки — после нажатия на кнопку «Выберите изображение» пользователь должен выбрать изображение кнопки из личного кабинета SmartPlayer. Рекомендуется загрузить изображение заранее;
- кнопка «Добавить кнопку» — добавляет настройки кнопки, описанные в разделе выше. Данные параметры необходимо настроить. Добавленная здесь кнопка будет входить в группу.
Завершение настройки виджета
После завершения настройки виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана.
Далее виджет развернётся на весь экран, и пользователь должен нажать на кнопку «Сохранить», расположенную внизу по центру экрана.
Загрузка и скачивание настроек
При работе с настройками виджета пользователь может загрузить ранее сохранённые настройки или скачать текущие настройки виджета. Каждое из указанных действий выполняется с помощью отдельных иконок в интерфейсе виджета. Иконки расположены в нижней части виджета по центру.
Серверная логика
При настройке параметров виджета, кнопок или групп кнопок, пользователь настраивает параметры, на которые реагирует серверное приложение SmartPlayer. Список параметров, на которые реагирует серверное приложение SmartPlayer:
- идентификатор трансляции;
- имя события;
- значение события.
Обратите внимание: пользователю необходимо настроить событие по следующему пути: «Добавить событие» в трансляции или в списке событий → выбрать событие «Серверное приложение» → ключ по полезной нагрузке → значение, то есть числовое значение события.
При правильной настройке виджета на каждое касание серверное приложение будет выполнять действие, связанное с нажатием, например переключение страницы с контентом. Чтобы настроить это правильно, ознакомьтесь с инструкциями в разделе ниже или по ссылке здесь. Особое внимание уделите серверным событиям.
Добавление настроенного виджета в трансляцию
Чтобы полностью ознакомиться с работой данной функциональности, пользователю необходимо запустить трансляцию с расписанием и добавить данный виджет в качестве контента. Подробнее с описанными ранее шагами по созданию трансляции и расписания можно ознакомиться в следующих статьях Wiki SmartPlayer:
- Раздел "Устройства"
- Раздел "Контент на устройства"
- Раздел "Трансляции"
- Раздел "Расписание"
- Подключения и интеграция в SmartPlayer c использованием серверных событий
Видеоинструкция
Инструкция к виджету трансляции событий (Event Broadcast)
Дополнительная информация
Если данная статья не помогает использовать функциональность по назначению или после её прочтения остаются вопросы, их можно задать в разделе «Обсуждения» вверху страницы.
Также дополнительную информацию можно узнать на странице Как взаимодействовать пользователю с разделом "Обсуждения".
