Расширенная погода

Адрес оригинальной статьи: https://help.cubicservice.ru/article/106-763

Виджет «Расширенная погода» отображает на экране актуальный прогноз погоды с различными индивидуальными настройками. Используя данный виджет, вы можете настроить желаемый уровень детализации отображения погодных условий, а также свое собственное графическое оформление. 

Изображение 1. Модальное окно виджета «Расширенная погода»

## Как добавить виджет в шаблон

1. Чтобы добавить в шаблон виджет «Расширенная погода», зайдите в редактор шаблонов.

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

3. На вкладке «Контент» в настройках сцены или контейнера нажмите на кнопку «Добавить виджет». Откроется окно со списком доступных виджетов. Выберите виджет «Расширенная погода». Откроется окно с настройками виджета. В данном окне будет доступен выбор типа виджета: главный и второстепенный. В зависимости от вашего выбора изменятся доступные настройки.

4. Виджет «Расширенная погода» всегда должен состоять минимум из двух отдельных виджетов: главного и второстепенного.

В главном виджете содержатся настройки местоположения, фона, иконок погоды и т.д. Без него не будут работать второстепенные виджеты. Второстепенный виджет позволяет настраивать информацию, какую погоду отображать: погоду на выбранный день, температуру сейчас или среднюю на день и т.д. Также второстепенный виджет дает вам доступ к расширенным настройкам расположения иконки с погодой на экране.

5. Главный виджет всегда должен находиться в отдельном контейнере от второстепенных виджетов.

Обратите внимание: у вас не получится создать второстепенный виджет, если не создан главный, поэтому в первую очередь следует создавать и настраивать главный виджет.

## Как настроить главный виджет

1. Введите название в поле для ввода названия. Например, «Погода в Москве главный».

2. Выберите тип виджета – «Главный виджет».

3. Введите местоположение. Выберите поле и начните вводить название. При вводе первой буквы появится выпадающий список с вариантами доступных названий. Выберите нужное местоположение.

4. Отметьте чекбокс «Использовать адрес плеера».

Поставьте отметку в чекбоксе, если вы хотите, чтобы отображалась погода в соответствии с адресом плеера, на котором будет отображаться шаблон с созданным виджетом. Это позволит вам, не меняя настроек шаблона, назначать его на плееры в разных городах, и в каждом случае шаблон будет автоматически отображать погоду в зависимости от местоположения плеера. Если в настройках плеера адрес не указан, то будет отображаться погода в зависимости от местоположения, заданного по умолчанию (см. выше).

5. Выберите язык.

Вам доступны два языка: русский и английский.

6. Выберите единицы измерения температуры.

Вам доступны две единицы измерения температуры: градусы Цельсия, градусы Фаренгейта.

7. Выберите фоновое изображение.

Вам доступны на выбор два типа фонового изображения: прозрачный фон или кастомное изображение. При выборе прозрачного фона главный виджет становится невидимым. Если выбрать кастомное изображение, появится кнопка для выбора файла. Нажмите на кнопку «Выбрать файл», чтобы загрузить изображение для фона. Откроется файловый менеджер, в котором необходимо выбрать файл фона. Подробнее о работе с файловым менеджером в разделе «[Файловый менеджер](https://help-vision.cubicservice.ru/section/106-2297)». После выбора файла главный виджет станет видимым и будет отображаться при проигрывании на плеере. Главный виджет с кастомным изображением можно использовать, например, как подложку с фоном для второстепенного виджета или для отображения любого произвольного изображения (логотип, иконка, название и т.д.).

8. В поле «Дополнительные настройки» выберите одну или несколько настроек:

* Размытие; * Использовать кастомные иконки; * Отображать анимацию загрузки виджета. Если выбрать «Размытие», то ниже появится ползунок для выбора процента размытия фонового изображения. Если выбрать «Использовать кастомные иконки», то появится блок загрузки своих собственных иконок для отображения в виджете. Загрузка происходит аналогично загрузке фонового изображение через [файловый менеджер](https://help-vision.cubicservice.ru/section/106-2297).

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

Если выбрать «Отображать анимацию при загрузке виджета», то при долгой загрузке виджета будет отображаться спиннер.

9. В поле «Реакция виджета на отсутствие интернета» вы можете выбрать следующие варианты реакции виджета:

* Отображать сообщение об отсутствии интернета; * Скрывать виджет при отсутствии интернета; * Отобразить последние полученные данные.


Изображение 2. Настройки главного виджета «Расширенная погода»

## Как настроить второстепенный виджет

1. Создайте еще один виджет «Расширенная погода».

2. Введите название в поле для ввода названия. Например, «Погода в Москве второстепенный».

3. Выберите тип виджета – «Второстепенный виджет».

4. Укажите главный виджет.

По умолчанию он будет привязан к первому созданному главному виджету. Если нет, то укажите его самостоятельно.

5. Выберите день для отображения данных. По умолчанию выбран текущий день.

6. Выберите расположение иконки, отображающей погоду (солнечно, пасмурно и т.д.).

При выборе отображения иконки ниже появляется блок для указания размера иконки и отступов.

7. Укажите данные для отображения. Выбор данных для текущего и следующих дней отличается.

8. В поле предпросмотра введите любое значение, для того чтобы посмотреть, как именно будут отображаться данные. Вы можете добавить любое количество элементов из списка. Для этого выберите нужный элемент и нажмите на кнопку «Добавить».

В блоке предварительного просмотра вы можете посмотреть, как будет выглядеть виджет.

9. В текстовом редакторе отображаются названия всех добавленных переменных, вместо которых будут подставлены нужные значения. Здесь можно отредактировать внешний вид добавленных в виджет данных, а также дописать какой-либо текст по необходимости.

**Наименования переменных:** * [cur-temp-0] – текущая температура; * [day-avg-temp-0] – средняя дневная температура(только для следующих дней); * [night-avg-temp-0] – средняя ночная температура(только для следующих дней); * [full-week-day-0] – полное название дня недели; * [short-week-day-0] – сокращенное название дня недели; * [cur-date-0] – текущая дата. Отслеживайте внесенные изменения в блоке предварительного просмотра.

После сохранения виджета вы можете посмотреть, как будут отображаться данные при воспроизведении виджета на экране плеера.


Изображение 3. Настройки второстепенного виджета «Расширенная погода»

Обратите внимание: чтобы виджет «Расширенная погода» показывал погоду из разных городов на одном плеере, вам следует создать новый главный виджет и привязать к нему еще один второстепенный.