Виджет авторизации Ver.2.0/en: различия между версиями

Материал из SmartPlayer
Новая страница: «Authorization Widget Ver. 2.0»
 
Новая страница: «== '''Description of the Situation''' == The Authorization Widget is a tool that previously allowed users to perform automatic authorization on platforms during display by overlaying virtual elements (fields and buttons) onto screenshots of authorization pages. The widget uses the URL of the authorization page and matches the screenshot image with the page displayed at that URL. Thus, the authorization process becomes automated.<br> The new version of...»
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Description of the Situation''' ==
== '''Описание ситуации''' ==
The Authorization Widget is a tool that previously allowed users to perform automatic authorization on platforms during display by overlaying virtual elements (fields and buttons) onto screenshots of authorization pages.
Виджет авторизации — это инструмент, который позволял пользователям проводить автоматическую авторизацию на платформах при отображении, путём наложения виртуальных элементов (полей и кнопок) на скриншоты страниц авторизации. Для работы виджет использует URL-адрес страницы авторизации и сопоставляет изображение на скриншоте с отображаемой по URL страницей. Таким образом, процесс авторизации автоматизируется.<br>
The widget uses the URL of the authorization page and matches the screenshot image with the page displayed at that URL. Thus, the authorization process becomes automated.<br>
Новая версия виджета предлагает дополнительные возможности к логике работы функционала, упрощает взаимодействие и делает пользовательский опыт более позитивным.<br>
The new version of the widget offers additional improvements to the functional logic, simplifies interaction, and enhances the overall user experience.<br>
Ознакомиться с работой первой версии виджета можно по ссылке [https://wiki.smartplayer.org/index.php?title=%D0%92%D0%B8%D0%B4%D0%B6%D0%B5%D1%82_%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8 здесь]  
You can ознакомиться with the first version of the widget at the following link [https://wiki.smartplayer.org/index.php?title=%D0%92%D0%B8%D0%B4%D0%B6%D0%B5%D1%82_%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8 here]
== '''Добавление виджета в личный кабинет''' ==
== '''Adding the Widget to the Personal Account''' ==
Чтобы добавить виджет в личный кабинет, пользователю нужно запросить у специалиста команды технической поддержки архив с содержимым. Он будет предоставлен в формате .zip - архива.
To add the widget to the personal account, the user must request a content archive from a SmartPlayer technical support specialist. It will be provided in `.zip` format.
[[File:Виджет_авторизации_2.0.png|thumb|center| Пример виджета в формате .zip - архива|800px]]
[[File:Виджет_авторизации_2.0.png|thumb|center| Example of the widget in .zip format |800px]]
После этого пользователь должен авторизоваться в личном кабинете и перейти в раздел «Контент».
After that, the user must log in to the personal account and navigate to the “Content” section.
[[File:Лк_контент.png|thumb|center| Пример отображения раздела «Контент» в личном кабинете |800px]]
[[File:Лк_контент.png|thumb|center| Example of the “Content” section in the personal account |800px]]
В разделе «Контент» перетаскиваем виджет из локального хранилища в личный кабинет. После того как пользователь перенесет виджет в личный кабинет, он отобразится в списке с контентом.
In the “Content” section, drag and drop the widget from local storage into the personal account. Once transferred, it will appear in the content list.
[[File:Виджет_авторизации.png|thumb|center| Пример отображения переноса виджета с помощью drag-and-drop|800px]]
[[File:Виджет_авторизации.png|thumb|center| Example of transferring the widget via drag-and-drop |800px]]
== '''Главная страница виджета''' ==
== '''Widget Main Page''' ==
После переноса виджета для первичной настройки пользователь должен дважды кликнуть по иконке. Данное действие перенесет его на главную страницу виджета.
After transferring the widget, double-click its icon for initial configuration. This action will open the widget’s main page.
[[File:Базовая_страница.png|thumb|center| Пример отображения главной страницы виджета|800px]]
[[File:Базовая_страница.png|thumb|center| Example of the widget main page |800px]]
На главной странице виджета отображается:
The widget main page displays:
* инструкция по использованию виджета (главный экран, на котором после настройки будут отображены шаги с полями и кнопками самого виджета);
* usage instructions (main screen where configured steps with fields and buttons will later be displayed);
* кнопки управления виджетом;
* widget control buttons;
* колонка учёта шагов.
* steps tracking column.
[[File:Главная_страница_и_инструкция.png|thumb|center| Пример отображения иконки для перехода в настройки виджета|800px]]
[[File:Главная_страница_и_инструкция.png|thumb|center| Example of the settings navigation icon |800px]]
{{Note|При необходимости, можно открыть инструкцию снова, кликнув на иконку в виде знака «?».|warn}}
{{Note|If necessary, the instructions can be reopened by clicking the “?” icon.|warn}}
== '''Общие настройки виджета''' ==
== '''General Widget Settings''' ==
Кликнув на кнопку «Настройки» с иконкой в виде шестерёнки откроется страница с общими настройками виджета. На этой странице можно настроить следующие параметры:
Clicking the “Settings” button (gear icon) opens the general widget settings page. The following parameters can be configured:
* выбор языка позволяет выбрать один из доступных для работы виджета языков. Доступные языки — русский, английский, испанский, португальский, казахский;
* language selection choose one of the supported languages (Russian, English, Spanish, Portuguese, Kazakh);
* адрес страницы вставить URL-ссылку на нужную страницу авторизации;
* page address insert the URL of the required authorization page;
* чекбокс (галочка) «Запустить десктопную версию» активирует/деактивирует масштабирование элементов, отображаемых на экране по размерам экрана устройства вывода данных;
* checkbox “Launch desktop version” enables/disables scaling of elements according to the display device screen size;
* интервал обновления страницы указать значения для интервала обновления страницы. Измеряется в секундах. Минимальное значение — 30 секунд;
* page refresh interval set the refresh interval in seconds (minimum value — 30 seconds);
* чекбокс (галочка) «Автоскрол» активирует/деактивирует автоматический скролл на странице после прохождения процесса авторизации;
* checkbox “Auto-scroll” enables/disables automatic scrolling after the authorization process;
* скорость автоскролла прописывается значение для учета скорости автоскролла. Измеряется в процентах (%). Минимальное значение — 1, максимальное - 100. Если значение будет вне диапазона, будут использоваться ближайшие пограничные к диапазону значения;
* auto-scroll speed set scroll speed in percent (%). Minimum value — 1, maximum — 100. If outside the range, nearest boundary values will be used;
* задержка перед началом автоскролла прописывается значение задержки, запуска работы автоскролла. Измеряется в миллисекундах;
* delay before auto-scroll start set delay value in milliseconds;
* выбрать изображение позволяет выбрать загруженные изображения из папки, расположенной в личном кабинете SmartPlayer.
* select image choose uploaded images from the SmartPlayer personal account folder.
[[File:Настройки общие для виджета.png|thumb|center| Пример отображения общих настроек виджета|800px]]
[[File:Настройки общие для виджета.png|thumb|center| Example of general widget settings |800px]]
=== '''Загрузка и скачивание настроек''' ===
=== '''Uploading and Downloading Settings''' ===
В процессе взаимодействия с настройками виджета пользователь может загрузить или выгрузить настройки виджета. Каждое из указанных действий можно сделать с помощью отдельных иконок в интерфейсе виджета. Иконки расположены в виджете снизу по центру.
While working with widget settings, the user can import or export widget settings. Each action is performed using separate icons located at the bottom center of the widget interface.
[[File:Иконки_загрузки.png|thumb|center| Пример отображения иконок в настройках виджета |800px]]
[[File:Иконки_загрузки.png|thumb|center| Example of settings import/export icons |800px]]
=== '''Завершение общих настроек виджета''' ===
=== '''Completing General Settings''' ===
После завершения работ по настройке виджета пользователь должен нажать на кнопку «Применить настройки» в правой нижней части экрана. Либо пользователь может не сохранять выставленные настройки по кнопке «Сбросить».
After configuring settings, click “Apply settings” in the bottom-right corner. Alternatively, click “Reset” to discard changes.
[[File:Применение_настрок.png|thumb|center| Пример отображения кнопок «Применить настройки» и «Сбросить»|800px]]
[[File:Применение_настрок.png|thumb|center| Example of “Apply settings” and “Reset” buttons |800px]]
Далее виджет растянется на весь экран и пользователь должен нажать на кнопку «Сохранить», внизу по центру экрана.
Then the widget will expand to full screen. Click “Save” at the bottom center of the screen.
[[File:Сохран.png|thumb|center| Пример отображения кнопки «Сохранить»|800px]]
[[File:Сохран.png|thumb|center| Example of the “Save” button |800px]]
== '''Добавление шага''' ==
== '''Adding a Step''' ==
После завершения общих настроек виджета в левой нижней части экрана для пользователя станет активна кнопка «Добавить шаг». По клику на нее изменится отображение страницы:
After completing general settings, the “Add step” button becomes active in the bottom-left corner. Clicking it changes the page display:
* будут отображены новые кнопки:
* new buttons appear:
** выбрать скриншот;  
** select screenshot;
** добавить действие.
** add action.
* в колонке «Шаги авторизации» появится новый шаг и две кнопки:
* a new step appears in the “Authorization steps” column with two buttons:
** применить;
** apply;
** блок схема.
** flowchart.
* в левом верхнем углу появится обозначение текущего шага в виде кнопки (является кликабельной кнопкой)
* in the top-left corner, the current step appears as a clickable button. 
[[File:Изменения_добавления_шага.png|thumb|center| Пример отображения изменений при добавлении шага|800px]]
[[File:Изменения_добавления_шага.png|thumb|center| Example of changes after adding a step |800px]]
=== '''Выбор скриншота''' ===
=== '''Selecting a Screenshot''' ===
По нажатию на одноименную кнопку откроется модальное окно, в котором загружены все скриншоты из папки.
Clicking the corresponding button opens a modal window containing all screenshots from the folder. Select the required screenshot for the step.
В этом окне выбрать нужный для шага скриншот.
[[File:Скрин_авторизации.png|thumb|center| Example of screenshot selection modal window |800px]]
[[File:Скрин_авторизации.png|thumb|center| Пример отображения модального окна с выбором скриншота|800px]]
The screenshot name will appear in the “Authorization steps” column.
После выбора название скриншота будет отображено в колонке «Шаги авторизации» для первого шага.  
[[File:Изменение_шагов_авторизации.png|thumb|center| Example of updated “Authorization steps” column |800px]]
[[File:Изменение_шагов_авторизации.png|thumb|center| Пример отображения изменений в колонке «Шаги авторизации» |800px]]
=== '''Add Action''' ===
=== '''Добавить действие''' ===
Clicking the corresponding button allows choosing between two action types:
По нажатию на одноименную кнопку откроется выбор с двумя вариантами действий:
* add input field creates an overlay field for entering data;
* добавить поле ввода создаёт на экране поле для наложения и ввода данных накладываемое на поле авторизации;
* add button creates a clickable overlay button for authorization page actions. 
* добавить кнопку создаёт кнопку, которая выполняет клик и накладывается на кнопки, которые есть на страницах авторизации, для исоплнения действия;
[[File:Добавление_действий.png|thumb|center| Example of action button functionality |800px]]
[[File:Добавление_действий.png|thumb|center| Пример отображения функциональности кнопки |800px]]
After creating fields and buttons, position them on the screenshot.
После создания поля и кнопки пользователь размещает их на экране со скриншотом.  
[[File:Поле_ввода_и_кнопка.png|thumb|center| Example of input field and button placement |800px]]
[[File:Поле_ввода_и_кнопка.png|thumb|center| Пример отображения поля ввода и кнопки |800px]]
Added actions will appear in the “Authorization steps” column.
Добавленные действия также отобразятся в колонке «Шаги авторизации» внутри текущего шага.
[[File:Действия_для_текущего_шага.png|thumb|center| Example of actions in the “Authorization steps” column |800px]]
[[File:Действия_для_текущего_шага.png|thumb|center| Пример отображения в колонке «Шаги авторизации» |800px]]
== '''Authorization Steps Column''' ==
При перемещении элементов откроется панель с параметрами для настройки выбранного элемента. О параметрах поля и кнопки будет описано ниже в разделе. Также при перемещении подсвечивается только выбранный пользователем элемент.
The column displays a list of all steps and their actions.
== '''Колонка «Шаги авторизации»''' ==
[[File:Отображение_шагов_авторизации.png|thumb|center| Example of the “Authorization steps” column |800px]]
В колонке «Шаги авторизации» отображается список всех шагов с действиями.
Each step contains:
[[File:Отображение_шагов_авторизации.png|thumb|center| Пример отображения колонки «Шаги авторизации» |800px]]
* screenshot name;
Эта колонка состоит из списка шагов, внутри которых описаны:
* input field (editable via gear icon or removable via cross icon);
* название картинки;
* action button (editable via gear icon or removable via cross icon).
* поле ввода(можно отредактировать с помощью клика на иконку шестерёнки или удалить по иконке крестика);
[[File:Расппеделение_по_шагу_.png|thumb|center| Example of step structure in the column |800px]]
* кнопка действия(можно отредактировать с помощью клика на иконку шестерёнки или удалить по иконке крестика).
Each step can be deleted via “Delete step”. Actions inside a step can also be removed individually.
[[File:Расппеделение_по_шагу_.png|thumb|center| Пример отображения колонки «Шаги авторизации» |800px]]
Click the blue “Apply” button at the bottom of the column to apply all steps and settings. The widget will display a confirmation modal window.
Каждый шаг можно удалить по отдельной кнопке «Удалить шаг». Также в каждом шаге можно удалить действия оставив его пустым (только с картинкой), при необходимости.<br>
[[File:Применения_шагов.png|thumb|center| Example of confirmation modal window |800px]]
Чтобы применить все действия и настройки для шагов кликнуть на синюю кнопку «Применить», расположенную внизу колонки «Шаги авторизации». Виджет оповестит пользователя об успешном применении шагов модальным окном с подтверждением.
=== '''Configuring Input Field and Action Button''' ===
[[File:Применения_шагов.png|thumb|center| Пример отображения модального окна с подтверждением сохранения настроек |800px]]
{{Note|Some parameters described here automatically change when dragging elements within the widget screen.|warn}}
=== '''Настройка поля ввода и кнопки действия''' ===
Click the gear icon next to a field or button to open its settings.
{{Note|Некоторые параметры, описанные в этом разделе автоматически изменяются если вы перетаскиваете поле или кнопку в рамках экрана виджета.|warn}}
Button settings:
Кликнув по иконке в виде шестеренки рядом с кнопкой или полем пользователь может перейти в настройки данного элемента.<br>
* name;
Кнопка включает в себя следующие настройки:
* X coordinate (pixels);
* имя — ввести название кнопки;
* Y coordinate (pixels);
* координата X — прописать числовое значение координаты в пикселях;
* width (pixels);
* координата Y — прописать числовое значение координаты в пикселях;
* height (pixels);
* ширина — прописать числовое значение в пикселях;
* delay time (milliseconds before click).
* высота — прописать числовое значение в пикселях;
[[File:Настройки_кнопки.png|thumb|center| Example of button settings |800px]]
* время задержки — прописать числовое значение, которое указывает задержку перед нажатием кнопки. Измеряется в миллисекундах.
Field settings:
[[File:Настройки_кнопки.png|thumb|center| Пример отображения параметров для кнопки |800px]]
* name;
Поле включает в себя настройки:
* value (text inserted into field);
* имя — ввести название поля;
* X coordinate;
* значение — прописать значение, которое будет введено в поле при наложении на изображение;
* Y coordinate;
* координата X — прописать числовое значение координаты в пикселях;
* width;
* координата Y — прописать числовое значение координаты в пикселях;
* height;
* ширина — прописать числовое значение в пикселях;
* delay time (milliseconds before input).
* высота — прописать числовое значение в пикселях;  
[[File:Настройки_поля.png|thumb|center| Example of field settings |800px]]
* время задержки — прописать числовое значение, которое указывает задержку перед вводом значения в поле. Измеряется в миллисекундах.
Click the blue “Apply” button at the bottom of the column to save changes.
[[File:Настройки_поля.png|thumb|center| Пример отображения для полей|800px]]
[[File:Кнопка_применить в видежте.png|thumb|center| Example of the “Apply” button |800px]]
В обоих случаях для применения изменённых настроек кнопки или поля нажать на синюю кнопку «Применить» внизу колонки.
=== '''Flowchart''' ===
[[File:Кнопка_применить в видежте.png|thumb|center| Пример отображения кнопки «Применить» |800px]]
Clicking “Flowchart” displays a visual flowchart showing steps and actions within each step. This allows clearer understanding of the authorization logic built in the widget.
=== '''Блок-схема''' ===
[[File:Блока_схема_шагов.png|thumb|center| Example of the flowchart |800px]]
При клике на кнопку «Блок-схема» перед пользователем появится блок-схема с последовательностью шагов и действий внутри каждого шага. Это позволит более наглядно просмотреть и понять текущую логику авторизации построенную пользователем в виджете.
== '''Adding the Configured Widget to a Broadcast''' ==
[[File:Блока_схема_шагов.png|thumb|center| Пример отображения блок-схемы|800px]]
To fully review this functionality, launch a scheduled broadcast and add the widget as content. For details on creating broadcasts and schedules, review the following articles:
== '''Добавление настроенного виджета в трансляцию''' ==
* [[Раздел "Устройства"]]
Чтобы полностью ознакомиться с работой данной функциональности, запустить трансляцию с расписанием и добавить в качестве контента виджет. Чтобы ознакомиться с описанными ранее шагами по созданию трансляции и расписания рекомендуется просмотреть следующие статьи из Wikipedia:
* [[Раздел "Контент на устройства"]]
* [[Раздел "Устройства"]]
* [[Раздел "Трансляции"]]
* [[Раздел "Контент на устройства"]]
* [[Раздел "Трансляции"]]
* [[Раздел "Расписание"]]
* [[Раздел "Расписание"]]
== '''Видеоинструкция''' ==
== '''Video Instruction''' ==
[https://vk.com/video-227547238_456239099 Настройка виджета авторизации ver. 2.0]
[https://vk.com/video-227547238_456239099 Authorization Widget Setup ver. 2.0]
== '''Дополнительная информация''' ==
== '''Additional Information''' ==
Если данная статья не помогает использовать функционал по назначению, или после её прочтения остаются вопросы, их можно озвучить в разделе "Обсуждения" вверху страницы.
If this article does not help you use the functionality as intended, or if questions remain, they can be raised 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]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
Additional information is available on the page [[How users interact with the "Discussions" section]]
</div>

Версия от 13:39, 20 февраля 2026

Description of the Situation

The Authorization Widget is a tool that previously allowed users to perform automatic authorization on platforms during display by overlaying virtual elements (fields and buttons) onto screenshots of authorization pages. The widget uses the URL of the authorization page and matches the screenshot image with the page displayed at that URL. Thus, the authorization process becomes automated.
The new version of the widget offers additional improvements to the functional logic, simplifies interaction, and enhances the overall user experience.
You can ознакомиться with the first version of the widget at the following link here

Adding the Widget to the Personal Account

To add the widget to the personal account, the user must request a content archive from a SmartPlayer technical support specialist. It will be provided in `.zip` format.

Example of the widget in .zip format

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, drag and drop the widget from local storage into the personal account. Once transferred, it will appear in the content list.

Example of transferring the widget via drag-and-drop

Widget Main Page

After transferring the widget, double-click its icon for initial configuration. This action will open the widget’s main page.

Example of the widget main page

The widget main page displays:

  • usage instructions (main screen where configured steps with fields and buttons will later be displayed);
  • widget control buttons;
  • steps tracking column.
Example of the settings navigation icon
If necessary, the instructions can be reopened by clicking the “?” icon.

General Widget Settings

Clicking the “Settings” button (gear icon) opens the general widget settings page. The following parameters can be configured:

  • language selection — choose one of the supported languages (Russian, English, Spanish, Portuguese, Kazakh);
  • page address — insert the URL of the required authorization page;
  • checkbox “Launch desktop version” — enables/disables scaling of elements according to the display device screen size;
  • page refresh interval — set the refresh interval in seconds (minimum value — 30 seconds);
  • checkbox “Auto-scroll” — enables/disables automatic scrolling after the authorization process;
  • auto-scroll speed — set scroll speed in percent (%). Minimum value — 1, maximum — 100. If outside the range, nearest boundary values will be used;
  • delay before auto-scroll start — set delay value in milliseconds;
  • select image — choose uploaded images from the SmartPlayer personal account folder.
Example of general widget settings

Uploading and Downloading Settings

While working with widget settings, the user can import or export widget settings. Each action is performed using separate icons located at the bottom center of the widget interface.

Example of settings import/export icons

Completing General Settings

After configuring settings, click “Apply settings” in the bottom-right corner. Alternatively, click “Reset” to discard changes.

Example of “Apply settings” and “Reset” buttons

Then the widget will expand to full screen. Click “Save” at the bottom center of the screen.

Example of the “Save” button

Adding a Step

After completing general settings, the “Add step” button becomes active in the bottom-left corner. Clicking it changes the page display:

  • new buttons appear:
    • select screenshot;
    • add action.
  • a new step appears in the “Authorization steps” column with two buttons:
    • apply;
    • flowchart.
  • in the top-left corner, the current step appears as a clickable button.
Example of changes after adding a step

Selecting a Screenshot

Clicking the corresponding button opens a modal window containing all screenshots from the folder. Select the required screenshot for the step.

Example of screenshot selection modal window

The screenshot name will appear in the “Authorization steps” column.

Example of updated “Authorization steps” column

Add Action

Clicking the corresponding button allows choosing between two action types:

  • add input field — creates an overlay field for entering data;
  • add button — creates a clickable overlay button for authorization page actions.
Example of action button functionality

After creating fields and buttons, position them on the screenshot.

Example of input field and button placement

Added actions will appear in the “Authorization steps” column.

Example of actions in the “Authorization steps” column

Authorization Steps Column

The column displays a list of all steps and their actions.

Example of the “Authorization steps” column

Each step contains:

  • screenshot name;
  • input field (editable via gear icon or removable via cross icon);
  • action button (editable via gear icon or removable via cross icon).
Example of step structure in the column

Each step can be deleted via “Delete step”. Actions inside a step can also be removed individually. Click the blue “Apply” button at the bottom of the column to apply all steps and settings. The widget will display a confirmation modal window.

Example of confirmation modal window

Configuring Input Field and Action Button

Some parameters described here automatically change when dragging elements within the widget screen.

Click the gear icon next to a field or button to open its settings. Button settings:

  • name;
  • X coordinate (pixels);
  • Y coordinate (pixels);
  • width (pixels);
  • height (pixels);
  • delay time (milliseconds before click).
Example of button settings

Field settings:

  • name;
  • value (text inserted into field);
  • X coordinate;
  • Y coordinate;
  • width;
  • height;
  • delay time (milliseconds before input).
Example of field settings

Click the blue “Apply” button at the bottom of the column to save changes.

Example of the “Apply” button

Flowchart

Clicking “Flowchart” displays a visual flowchart showing steps and actions within each step. This allows clearer understanding of the authorization logic built in the widget.

Example of the flowchart

Adding the Configured Widget to a Broadcast

To fully review this functionality, launch a scheduled broadcast and add the widget as content. For details on creating broadcasts and schedules, review the following articles:

Video Instruction

Authorization Widget Setup ver. 2.0

Additional Information

If this article does not help you use the functionality as intended, or if questions remain, they can be raised in the “Discussions” section at the top of the page.

Example of the “Discussions” tab on the wiki page

Additional information is available on the page How users interact with the "Discussions" section