Триггерные события в трансляции/en: различия между версиями

Материал из SmartPlayer
(Новая страница: «Trigger events in broadcast»)
(Новая страница: «== '''Final Result''' == Users know how to use and integrate trigger events into their broadcasts.»)
 
(не показаны 2 промежуточные версии этого же участника)
Строка 16: Строка 16:
* Go back to the beginning and wait for the triggers to activate again.
* Go back to the beginning and wait for the triggers to activate again.
{{Note|If a user creates a broadcast with content and doesn't manually set up events, the broadcast will play each page separately, in order.|warn}}
{{Note|If a user creates a broadcast with content and doesn't manually set up events, the broadcast will play each page separately, in order.|warn}}
<div lang="ru" dir="ltr" class="mw-content-ltr">
=== '''Creating a Broadcast''' ===
=== '''Создание трансляции''' ===
[[File:Сощдание_трансялции.png|thumb|right|Creating a Broadcast|150px]]
[[File:Сощдание_трансялции.png|thumb|right|Создание трансляции|150px]]
In the personal cabinet, the user needs to find the "Broadcast" section, click on it, and after a pop-up window appears, click on the "Create" line. <br>
Пользователю в личном кабинете необходимо найти раздел "Трансляция", кликнуть на него и после открытия всплывающего окна кликнуть на строку "Создать".<br>
After this, the user must select a zone for the broadcast and fill it with content. To be able to work with events in the broadcast, there should be at least two pages. <br>
После этого, пользователю необходимо выбрать зону для трансляции и заполнить её контентом. Для возможности работы с событиями в трансляции должно быть минимум две страницы.<br>
If there are no events, the broadcast currently defaults to playing by pages, meaning the first page, then the second page, and so on.
Если же событий нет, трансляция сейчас по умолчанию проигрывается по страницам, то есть первая страница, потом вторая страница и так далее.
{{Note|The duration of content playback is not adjusted in the event settings but in the playback settings of the broadcast. To adjust the duration, you need to click on the content in the zone and find the "Duration" parameter in the pop-up window. In it, the user sets the desired value.|warn}}
{{Note|Длительность проигрывания контента настраивается не в настройках события, а в настройках проигрывания в трансляции. Для настройки длительности необходимо кликнут на контент в зоне и найти параметр "Продолжительность" во всплывшем окне. В нём пользователь выставляет нужное значение. |warn}}
[[File:Продолжительность.png|thumb|center|Location of the Duration option in the content settings.|300px]]
[[File:Продолжительность.png|thumb|center|Расположение параметра "Продолжительность" в настройке контента.|300px]]
=== '''Event Configuration and Types''' ===
</div>
After adding content to the page, it's necessary to click on the "Page Configuration" icon..
<div lang="ru" dir="ltr" class="mw-content-ltr">
When opening the configuration page, one should move to event creation on the right toolbar. <br>
=== '''Настройка и типы событий''' ===
To do this, click on the "+" icon next to the "Event" line and add an event type.<br>
После добавления контента на страницу необходимо нажать на иконку "Настройка страницы".
[[File:Тип_события.png|thumb|center|
Открыв страницу настроек, необходимо справа в тулбаре перейти к созданию события.<br>
Two kinds of parameters for launching a trigger event|300px]]
Для этого нажимаем на иконку "+" рядом со строкой "Событие" и добавляем тип события.<br>
There are two types of events available as triggers:
[[File:Тип_события.png|thumb|center|Два вида параметров для запуска триггерного события|300px]]
* '''RFID tag'''  
Существует два типа событий доступных в качестве триггера:  
It involves two sequentially set parameters: key and value. In the "Key" parameter, a key identifier is selected:
* '''RFID метка'''  
* By payload
Включает в себя два параметра выставляемых по очереди: ключ и значение.
* By ID
В параметре "Ключ" выбирается определитель ключа:  
After choosing one of the two identifiers, a value parameter appears.<br>
* По полезной нагрузке
In the first case, if the data identifier is set "by ID," these are values that can be found in the device description under "RFID device."<br>
* По идентификатору
In the second case, if the data identifier is set "by payload," it means the encoded textual meaning. Here, the identifier can take any string value.
После выбора одного из двух определителей появляется параметр - значение.<br>
[[File:Определители_параметров_и_значения.png|thumb|center|Determinant of the “By ID” and “By Payload” parameters and their values|300px]]
В первом случае, если определитель  данных выставлен "по идентификатору". Это значения, которые можно будет найти в описании устройства в строке "RFID устройства".<br>
* '''Face Recognition'''  
Во втором случае, если определитель данных выставлен "по полезной нагрузке". То есть закодированному текстовому смысловому значению. Здесь определитель может принимать любое строковое значение.
This also involves two sequentially set parameters: key and value. In the "Key" parameter, a key identifier is selected. In this case, there's only one - by gender. After choosing the identifier, a value parameter appears. The value has two options - male and female. After all settings, it's essential to click the "Save" button.
[[File:Определители_параметров_и_значения.png|thumb|center|Определитель параметров "По идентификатору" и "По полезной нагрузки" и их значения|300px]]
[[File:Значения_по_половому_признаку.png|thumb|center|
* '''Распознавание лица'''  
Determinant of parameters “By gender” and their meanings|300px]]
Включает в себя два параметра выставляемых по очереди: ключ и значение.
{{Note|Future versions of the feature plan to add additional triggers.|warn}}
В параметре "Ключ" выбирается параметр определитель ключа. В данном случае он один - по половому признаку.
=== '''Choosing a Page to Transition to''' ===
После выбора определителя появляется параметр - значение.
The page for the transition is chosen in the event creation menu. This parameter is slightly below and is named "Next Page." Inside this parameter, the user selects which page the broadcast will switch to upon triggering the event. After selecting the page, it's also essential to click the "Save" button
Значение имеет два варианта - мужчина и женщина.
[[File:Пример_следующая_страница.png|thumb|center|Example of binding an event to a page|300px]]
После всех настроек обязательно надо нажать кнопку "Сохранить".
[[File:Значения_по_половому_признаку.png|thumb|center|Определитель параметров "По половому признаку" и их значения|300px]]
{{Note|В будущих версиях функционала планируется добавить дополнительные триггеры. |warn}}
</div>
<div lang="ru" dir="ltr" class="mw-content-ltr">
=== '''Выбор страницы для перехода''' ===
Страница для перехода выбирается в меню создания события.<br>
Данный параметр находится немного ниже страницы и называется "Следующая страница".
Внутри этого параметра пользователь выбирает на какую страницу будет переключаться трансляция при активации триггерного события.<br>
После выбора страницы также необходимо нажать кнопку "Сохранить".
[[File:Пример_следующая_страница.png|thumb|center|Пример привязки события к странице|300px]]
</div>


<div lang="ru" dir="ltr" class="mw-content-ltr">
=== '''Viewing the Display Scheme and Bindings''' ===
=== '''Просмотр схемы отображения и привязки''' ===
You can view the event display scheme and binding lines by clicking on a specific icon. Thanks to this scheme, it's easy to understand whether triggers and events are correctly configured.
Просмотреть схему отображения событий и линии привязки можно по нажатию на специальную иконку. Благодаря данной схеме можно легко понять правильно ли настроено триггеры и события.
[[File:Схема_и_обозначения.png|thumb|center|An example of a diagram and a "Legend" for understanding the diagram.|800px]]
[[File:Схема_и_обозначения.png|thumb|center|Пример схемы и "Легенды" для понимания схемы.|800px]]
=== '''Additional Application Possibilities''' ===
</div>
The functionality can also interact with devices that have touch solutions embedded. The action algorithm with the touch solution is as follows:
<div lang="ru" dir="ltr" class="mw-content-ltr">
[[File:Строка_действие_.png|thumb|right|
=== '''Дополнительные возможности для применения''' ===
Action binding location|300px]]
Также функционал может взаимодействовать с устройствами, предусматривающими в себе тач решения. Алгоритм действия с тач решением выглядит так:
* First, create a broadcast with content to play and content for user pressing. This can be either two different types of content or just one.
[[File:Строка_действие_.png|thumb|right|Расположение привязки действия|300px]]
* Next, select the content to which you want to attach the "touch" and go to the content settings by clicking on the desired content.
* Первым шагом создаётся трансляция с контентом для проигрывания и контентом для нажатия пользователем. Это могут быть как два разных вида контента, так и один.
* By clicking the "+" icon next to the action line, the user opens the settings.
* Далее выбираем контент, к которому хотим привязать "касание" и переходим в настройки контента с помощью клика на нужном пользователю контенте.
* In the window that appears, they need to choose an action. In the "Action" line, "Pressing on the content" is set.
* Нажав на иконку "+" рядом со строкой действия, пользователь открывает настройки.
* The next step introduces another line: "Transition to the page". In this line, the user chooses which page the transition will go to.
* В появившимся окне ему необходимо выбрать действие. В строке "Действие" выставляется "Нажатие по контенту".
* Press the "Save" button and finish editing the broadcast.
* Следующим шагом появляется еще одна строка "Переход на страницу". В строке выбирает на какую страницу будет осуществлен переход.
[[File:Настройки_действий.png|thumb|center|An example of filling out lines with an action.|800px]]
* Нажатие кнопки "Сохранить" и завершение редактирования трансляции.
[[File:Настройки_действий.png|thumb|center|Пример заполнение строк с действием.|800px]]
</div>


<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Final Result''' ==
== '''Итоговый результат''' ==
Users know how to use and integrate trigger events into their broadcasts.
Пользователи умеют пользоваться и интегрировать триггерные события в свои трансляции.
</div>

Текущая версия от 15:03, 23 октября 2023

Situation Description

A new feature has been introduced in the SmartPlayer personal cabinet - the creation of trigger events. This functionality broadens the scope of interactions with the platform.

Need for the Feature

This feature allows users to modify the content played on a device using a trigger set in the settings. As soon as the trigger disappears, the event ends, and the original broadcast resumes.

If an "Announcement" is created in the broadcast, it will not be possible to create a trigger event due to potential playback issues.

Operating Principle

Logic of Operation

To create trigger events, one must have specific user rights called "AdminBrandML".
User role for creating a broadcast

If a user plans to create a trigger event, they must:

  • First step - create a broadcast with multiple pages and designated content areas.
  • Then, configure the event operation within the broadcast.
  • Link the created event to transitions to other broadcast pages.
  • First, wait for the activation and completion of triggers for the event.
  • Go back to the beginning and wait for the triggers to activate again.
If a user creates a broadcast with content and doesn't manually set up events, the broadcast will play each page separately, in order.

Creating a Broadcast

Creating a Broadcast

In the personal cabinet, the user needs to find the "Broadcast" section, click on it, and after a pop-up window appears, click on the "Create" line.
After this, the user must select a zone for the broadcast and fill it with content. To be able to work with events in the broadcast, there should be at least two pages.
If there are no events, the broadcast currently defaults to playing by pages, meaning the first page, then the second page, and so on.

The duration of content playback is not adjusted in the event settings but in the playback settings of the broadcast. To adjust the duration, you need to click on the content in the zone and find the "Duration" parameter in the pop-up window. In it, the user sets the desired value.
Location of the Duration option in the content settings.

Event Configuration and Types

After adding content to the page, it's necessary to click on the "Page Configuration" icon.. When opening the configuration page, one should move to event creation on the right toolbar.
To do this, click on the "+" icon next to the "Event" line and add an event type.

Two kinds of parameters for launching a trigger event

There are two types of events available as triggers:

  • RFID tag

It involves two sequentially set parameters: key and value. In the "Key" parameter, a key identifier is selected:

  • By payload
  • By ID

After choosing one of the two identifiers, a value parameter appears.
In the first case, if the data identifier is set "by ID," these are values that can be found in the device description under "RFID device."
In the second case, if the data identifier is set "by payload," it means the encoded textual meaning. Here, the identifier can take any string value.

Determinant of the “By ID” and “By Payload” parameters and their values
  • Face Recognition

This also involves two sequentially set parameters: key and value. In the "Key" parameter, a key identifier is selected. In this case, there's only one - by gender. After choosing the identifier, a value parameter appears. The value has two options - male and female. After all settings, it's essential to click the "Save" button.

Determinant of parameters “By gender” and their meanings
Future versions of the feature plan to add additional triggers.

Choosing a Page to Transition to

The page for the transition is chosen in the event creation menu. This parameter is slightly below and is named "Next Page." Inside this parameter, the user selects which page the broadcast will switch to upon triggering the event. After selecting the page, it's also essential to click the "Save" button

Example of binding an event to a page

Viewing the Display Scheme and Bindings

You can view the event display scheme and binding lines by clicking on a specific icon. Thanks to this scheme, it's easy to understand whether triggers and events are correctly configured.

An example of a diagram and a "Legend" for understanding the diagram.

Additional Application Possibilities

The functionality can also interact with devices that have touch solutions embedded. The action algorithm with the touch solution is as follows:

Action binding location
  • First, create a broadcast with content to play and content for user pressing. This can be either two different types of content or just one.
  • Next, select the content to which you want to attach the "touch" and go to the content settings by clicking on the desired content.
  • By clicking the "+" icon next to the action line, the user opens the settings.
  • In the window that appears, they need to choose an action. In the "Action" line, "Pressing on the content" is set.
  • The next step introduces another line: "Transition to the page". In this line, the user chooses which page the transition will go to.
  • Press the "Save" button and finish editing the broadcast.
An example of filling out lines with an action.

Final Result

Users know how to use and integrate trigger events into their broadcasts.