# Інструкції користувача

# Мережеві доступи

Незалежно від [сценарію](https://docs.soloveyko.media/link/4), за яким використовується ПЗ Соловейко.Медіа, для коректної роботи, клієнт повинен забезпечити підключення до інтернету та відсутність обмежень у доступі до сервісів описаних далі.

### Сценарій №1

<div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BE%D0%BA-%22soloveyko%22--2">Додаток "**soloveyko**" для відтворення медіаконтенту потребує доступи в інтернеті до наступних сервісів:</div><div class="ql-block" id="bkmrk-">  
</div><div class="clickup-table-view clickup-table-view_wide" contenteditable="false" id="bkmrk-%D0%A1%D0%B5%D1%80%D0%B2%D1%96%D1%81-%D0%94%D0%BE%D0%BC%D0%B5%D0%BD-%28dst%29-%D0%9F"><table class="clickup-table"><colgroup><col style="width:176px;"></col><col style="width:434px;"></col><col style="width:156px;"></col><col style="width:282px;"></col></colgroup><tbody><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">**Сервіс**</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">**Домен (DST)**</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">**Порт / Протокол**</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">**Призначення**</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">Backend</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">api.soloveyko.media є CNAME для</div><div class="qlbt-cell-line">d-mqzuxjv2g8.execute-api.eu-central-1.amazonaws.com</div></td><td colspan="1" rowspan="4"><div class="qlbt-cell-line">443/https/tcp</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Конфігурація</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">File Storage</div></td><td colspan="1" rowspan="1">- soloveyko.s3.eu-central-1.amazonaws.com
- cdn.soloveyko.media

</td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Завантаження медіаконтенту</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">SQS</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">sqs.eu-central-1.amazonaws.com</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Обмін службовими командами</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">Package Repository</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">nest.soloveyko.media</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Завантаження пакету з додатком, контроль версії додатку</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">NTP</div></td><td colspan="2" rowspan="2"><div class="qlbt-cell-line">Використовуються ті, що налаштовані на операційний системі обладнання клієнта;</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Синхронізація часу</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">DNS</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Ідентифікація доменних імен</div></td></tr></tbody></table>

</div>### Сценарій №2

<div class="ql-block" id="bkmrk-%D0%9A%D0%BE%D0%BC%D0%BF%D0%BB%D0%B5%D0%BA%D1%82%C2%A0soloveyko.b">Комплект **Soloveyko.Box** із встановленим повним набором ПЗ потребує мережеві доступи з сценарія 1, а також наступні мережеві доступи:</div><div class="ql-block" id="bkmrk--1">  
</div><div class="clickup-table-view clickup-table-view_wide" contenteditable="false" id="bkmrk-%D0%A1%D0%B5%D1%80%D0%B2%D1%96%D1%81-%D0%94%D0%BE%D0%BC%D0%B5%D0%BD-%28dst%29-%D0%9F-1"><table class="clickup-table"><colgroup><col style="width:124px;"></col><col style="width:266px;"></col><col style="width:166px;"></col><col style="width:239px;"></col></colgroup><tbody><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">**Сервіс**</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">**Домен (DST)**</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">**Порт / протокол**</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">**Призначення**</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">NTP</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">*.ua.pool.ntp.org</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">123/udp</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Синхронізація часу</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">DNS</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">IP-адреса, отримана від DHCP, а також:</div><div class="qlbt-cell-line">1.1.1.1</div><div class="qlbt-cell-line">8.8.8.8</div><div class="qlbt-cell-line">8.8.4.4</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">53/udp</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Ідентифікація доменних імен</div></td></tr><tr><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">OpenVPN</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">gloryhollow.soloveyko.media</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line ql-align-center">80/tcp</div><div class="qlbt-cell-line ql-align-center">443/tcp</div><div class="qlbt-cell-line ql-align-center">8443/tcp</div></td><td colspan="1" rowspan="1"><div class="qlbt-cell-line">Віддалений доступ для служби підтримки</div></td></tr></tbody></table>

</div><div class="ql-block" id="bkmrk--2">  
</div><div class="ql-block" id="bkmrk-%D0%A3-%D0%B2%D0%B8%D0%BF%D0%B0%D0%B4%D0%BA%D1%83-%D0%B2%D0%B8%D0%BA%D0%BE%D1%80%D0%B8%D1%81%D1%82%D0%BE%D0%B2">У випадку використовування клієнтом комплекту **Soloveyko.Box** — ініціатором всіх нових з'єднань виступають додатки (soloveyko та ін.), встановлені на **Soloveyko.Box**.</div><div class="ql-block" id="bkmrk--3">  
</div><div class="ql-block" id="bkmrk-%D0%A3-%D0%B2%D0%B8%D0%BF%D0%B0%D0%B4%D0%BA%D1%83-%D0%B7%D0%B2%D0%B5%D1%80%D0%BD%D0%B5%D0%BD%D1%8C-%D0%B4">У випадку звернень до служби підтримки, вона може відкривати **Soloveyko.Box** віддалений доступ (SSH) або відправляти запити (HTTPS) на **Soloveyko.Box** всередині ініційованого ним OpenVPN шифрованого з'єднання.</div><div class="ql-block" id="bkmrk--4">  
</div>### Визначення IP-адрес доменів

<div class="ql-block" id="bkmrk-%D0%97%D0%B0-%D0%BD%D0%B5%D0%BE%D0%B1%D1%85%D1%96%D0%B4%D0%BD%D0%BE%D1%81%D1%82%D1%96-%D0%86%D0%A0-%D0%B0">За необхідності ІР-адреси для вказаних доменних імен можуть бути визначені клієнтом власноруч за допомогою, наприклад, утиліти nslookup. У випадку обмежень доступів за "білим" списком ІР-адрес, клієнт повинен забезпечити оновлення "білого" списку.</div>### SRC і DST адреси запитів

<div class="ql-block" id="bkmrk-%D0%90%D0%B4%D1%80%D0%B5%D1%81%D0%B0-%D0%B4%D0%B6%D0%B5%D1%80%D0%B5%D0%BB%D0%B0-%28src%29">Адреса джерела (SRC) вихідних запитів на вказані сервіси буде обрана в залежності від налаштувань мережі клієнта.  
</div><div class="ql-block" id="bkmrk-%D0%9F%D1%80%D0%B8%D1%81%D1%82%D1%80%D1%96%D0%B9-%D1%96%D0%B7-%D0%B2%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB">Пристрій із встановленим додатком **"soloveyko"**, який виступає джерелом з'єднання, ініціює їх використовуючи налаштування, отримані за допомогою протоколу DHCP (Dynamic Host Configuration Protocol) або налаштовані клієнтом власноруч.</div>## Гарантії

<div class="ql-block" id="bkmrk-%D0%9C%D0%B8-%D0%B3%D0%B0%D1%80%D0%B0%D0%BD%D1%82%D1%83%D1%94%D0%BC%D0%BE%2C-%D1%89%D0%BE-%D0%B4%D0%BE">Ми гарантуємо, що домен soloveyko.media та всі сабдомени, а також відповідні сервери та/або сервіси належать компанії Соловейко.Медіа та адмініструються співробітниками компанії.</div>

# Встановлення додатку Soloveyko

<div class="ql-advanced-banner" id="bkmrk-%D0%A3%D0%B2%D0%B0%D0%B3%D0%B0%21-%D0%9D%D0%B0%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B0-%D1%96%D0%BD%D1%81%D1%82"></div><p class="callout warning">**Увага!  
Наведена інструкція розрахована на людину, яка має досвід використання операційних систем GNU/Linux, а також досвід роботи з терміналом.  
Уважно прочитайте всю інструкцію до кінця, перед тим як виконувати будь-які наведені команди.  
Всі наведені команди, системні шляхи, назви змінних, значення змінних тощо чутливі до регістру.** </p>

## Вимоги до середовища операційної системи

<div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BE%D0%BA-%22soloveyko%22-">Додаток "soloveyko" працює на операційних системах GNU/Linux. На даний момент підтримуються Debian-based дистрибутиви під керуванням системного менеджера `systemd`. Коректна робота можлива на дистрибутивах не старіше, ніж `Debian 12` або `Ubuntu 22.04`. Підтримуються наступні архітектури процесорів: `amd64/x86_64`, `ARMv7/armhf`, `ARMv8/arm64`.</div><div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BE%D0%BA-%D1%80%D0%BE%D0%B7%D0%BF%D0%BE%D0%B2%D1%81%D1%8E%D0%B4%D0%B6%D1%83%D1%94">Додаток розповсюджується у виді deb-пакунку, для встановлення якого необхідний відповідний менеджер пакунків. Завантаження і встановлення відбувається з офіційного репозиторію Соловейко.Медіа. Наведені нижче інструкції призначені для менеджеру пакунків `apt`. Також необхідна наявність в системі наступних утиліт і пакунків: `curl`, `gpg`, `ca-certificates`.</div>## Процес встановлення

### Додавання офіційного репозиторію Соловейко.Медіа

<div class="ql-block" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D1%96%D1%80%D1%8F%D1%94%D0%BC%D0%BE-%D1%96-%D1%81%D1%82%D0%B2%D0%BE%D1%80%D1%8E">Перевіряємо і створюємо директорії для ключа підпису та файлу посилання на репозиторій, якщо такі відсутні:</div>```shell
if [ ! -d /etc/apt/keyrings/ ]; then mkdir -p /etc/apt/keyrings/; fi
if [ ! -d /etc/apt/sources.list.d/ ]; then mkdir -p /etc/apt/sources.list.d/; fi
```

<div class="ql-block" id="bkmrk-%D0%97%D0%B0%D0%B2%D0%B0%D0%BD%D1%82%D0%B0%D0%B6%D1%83%D1%94%D0%BC%D0%BE-%D0%BF%D1%83%D0%B1%D0%BB%D1%96%D1%87%D0%BD">Завантажуємо публічний ключ підпису пакунку:</div>```shell
curl -fsSL https://nest.soloveyko.media/linux/deb/gpg | gpg --dearmor -o /etc/apt/keyrings/Soloveyko.Media.gpg
```

<div class="ql-block" id="bkmrk-%D0%97%D0%B0%D0%B2%D0%B0%D0%BD%D1%82%D0%B0%D0%B6%D1%83%D1%94%D0%BC%D0%BE-%D1%84%D0%B0%D0%B9%D0%BB-%D0%BF%D0%BE">Завантажуємо файл посилання на репозиторій:</div>```shell
curl -fsSL https://nest.soloveyko.media/linux/deb/Soloveyko.Media.Production.sources -o /etc/apt/sources.list.d/Soloveyko.Media.Production.sources
```

<div class="ql-block" id="bkmrk-%D0%92%D0%B8%D0%BA%D0%BE%D0%BD%D1%83%D1%94%D0%BC%D0%BE-%D0%BE%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F-">Виконуємо оновлення індексів репозиторіїв:</div>```shell
apt update
```

<div class="ql-block" id="bkmrk-%D0%9F%D1%96%D1%81%D0%BB%D1%8F-%D1%83%D1%81%D0%BF%D1%96%D1%88%D0%BD%D0%BE%D0%B3%D0%BE-%D0%B2%D0%B8%D0%BA%D0%BE">Після успішного виконання наведених команд, у пошуку буде доступний пакунок "soloveyko", а також додаткові пакунки:</div>```shell
apt search soloveyko
```

<div class="ql-block" id="bkmrk-">![1.png](https://docs.soloveyko.media/uploads/images/gallery/2024-12/1.png)</div>### Попередні налаштування та встановлення пакунку

<div class="ql-block" id="bkmrk-%D0%9F%D1%96%D0%B4-%D1%87%D0%B0%D1%81-%D0%B2%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F">Під час встановлення буде створено користувача `soloveyko` від імені якого буде працювати додаток, а також створено ряд директорій і файлів:</div>- `/opt/soloveyko/` - директорія, у якій буде розміщено виконувані файли;
- `/etc/systemd/system/soloveyko.service` - файл сервісу для systemd;
- `/var/log/soloveyko/` - директорія, у яку додаток записує логи під час роботи;
- `/var/lib/soloveyko/` - директорія, у яку додаток заванатажує дані;
- `/etc/soloveyko.env` - файл налаштувань для інсталятора пакунку.

<div class="ql-block" id="bkmrk--1">  
</div><div class="ql-block" id="bkmrk-%D0%9A%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D1%87-soloveyko">Користувач `soloveyko` призначається власником директорій, у яких створюються файли під час роботи, а також він додається до груп:</div><div class="ql-block" id="bkmrk-audio%2C-video%2C-users%2C">`audio`, `video`, `users`, `render`, `pulse`, `pulse-access`.</div><div class="ql-block" id="bkmrk--2">  
</div><div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BE%D0%BA-soloveyko-%2C-">Додаток `soloveyko` , під час комунікації з сервісами Соловейко.Медіа, використовує спеціальний ідентифікатор. Цей ідентифікатор повинен бути унікальним і формується в процесі встановлення з MAC-адреси мережевого інтерфейсу, який має одне з наступних імен: `eth0`, `enp*`, `end0`, `eno*` , а також, за необхідності, може бути переданий перед початком встановлення за допомогою оголошення системної змінної `SOLOVEYKO_HWID` перед початком встановлення. Власноруч переданий ідентифікатор повинен відповідати наступним вимогам:</div>- Максимальна довжина 40 символів;
- Дозволені символи: 
    - `a-z` - літери латинського алфавіту у нижньому регістрі;
    - `A-Z` - літери латинського алфавіту у верхньому регістрі;
    - `0-9` - цифри;
    - `- _` - мінус, нижнє підкреслення.

<div class="ql-block" id="bkmrk--3">  
</div><div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BE%D0%BA-soloveyko-%D0%BC%D0%B0">Додаток `soloveyko` має можливість відтворювати декілька звукових файлів одночасно, відповідно створюючи декілька потоків, що вимагає наявного і працюючого у системі звукового сервера. За замовчуванням використовується `pulseaudio` , для якого є можливість встановити режим роботи на системному рівні шляхом створення відповідного сервісу. Цей режим зручно використовувати на серверних варіантах операційних систем, які працюють середовища робочого столу та без здійснення входу користувачами. Увімкнненя створення сервісу здійснюється оголошенням системної змінної `SOLOVEYKO_SETUP_SYSTEMWIDE_PULSEAUDIO` перед початком встановлення.</div><div class="ql-block" id="bkmrk--4"></div><div class="ql-block" id="bkmrk-%D0%AF%D0%BA%D1%89%D0%BE-%D0%B2-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D1%96%D0%B9%D0%BD%D1%96%D0%B9-%D1%81">Якщо в операційній системі встановлено пакунки для роботи графічного середовища (`xorg` або `wayland`), додаток встановиться із підтримкою відтворення відео і буде примусово розгортатись на весь екран. Якщо така поведінка небажана, можна увімкнути прихований режим роботи, у якому відтворюватиметься лише звук. Увімкнненя прихованого режиму роботи здійснюється оголошенням системної змінної `SOLOVEYKO_AUDIO_ONLY_HEADLESS_MODE` перед початком встановлення.</div><div class="ql-block" id="bkmrk--5"></div><div class="ql-block" id="bkmrk-%D0%9D%D0%B0-%D0%B4%D0%B5%D1%8F%D0%BA%D0%B8%D1%85-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D1%96%D0%B9%D0%BD%D0%B8">На деяких операційних системах було помічено зупинку роботи звукової та/або відео підсистем, якщо користувач не здійснив вхід у систему. Для вирішення цієї проблеми, під час встановлення пакунку, може бути створено відповідний файл модифікації сервісу `getty` за шляхом `/etc/systemd/system/getty@tty1.service.d/autologin.conf` для здійсненя автоматичного входу користувача `soloveyko` . **Слід зауважити, що це накладає безпекові ризики і повинно використовувати із повним усвідомленням власних дій**. Увімкнненя здійснюється оголошенням системної змінної `SOLOVEYKO_AUTOLOGIN_USER` перед початком встановлення.</div><div class="ql-block" id="bkmrk--6">  
</div><div class="ql-block" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B4-%D0%BF%D0%BE%D1%87%D0%B0%D1%82%D0%BA%D0%BE%D0%BC-%D0%B2%D1%81%D1%82%D0%B0%D0%BD">Перед початком встановлення пакунку, за необхідності, можуть бути оголошені системні змінні, для передачі налаштувань, відмінних від за замовчуванням:</div><div class="ql-block" id="bkmrk-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0-%D0%B7%D0%BC%D1%96%D0%BD%D0%BD%D0%BE%D1%97-%D0%97%D0%BD%D0%B0%D1%87%D0%B5%D0%BD"><table style="border-collapse:collapse;width:100%;height:1038.72px;"><colgroup><col style="width:25.5066%;"></col><col style="width:20.143%;"></col><col style="width:31.7044%;"></col><col style="width:22.7652%;"></col></colgroup><thead><tr style="height:46.6px;"><td style="height:46.6px;">**Назва змінної**</td><td style="height:46.6px;">**Значення за замовчуванням**</td><td style="height:46.6px;">**Допустимі значення**</td><td style="height:46.6px;">**Призначення**</td></tr></thead><tbody><tr style="height:214.567px;"><td style="height:214.567px;">`SOLOVEYKO_HWID`</td><td style="height:214.567px;">Відсутнє. Визначається в процесі встановлення.</td><td style="height:214.567px;"><div class="qlbt-cell-line">Максимальна довжина 40 символів. Дозволені символи:</div><div class="qlbt-cell-line">`a-z` - літери латинського алфавіту у нижньому регістрі;</div><div class="qlbt-cell-line">`A-Z` - літери латинського алфавіту у верхньому регістрі;</div><div class="qlbt-cell-line">`0-9` - цифри;</div><div class="qlbt-cell-line">`- _` - мінус, нижнє підкреслення</div></td><td style="height:214.567px;">Ідентифікатор</td></tr><tr style="height:97px;"><td style="height:97px;">`SOLOVEYKO_NETWORK_DEVICE_NAME`</td><td style="height:97px;">Відсутнє. Визначається в процесі встановлення.</td><td style="height:97px;">Відповідно до списку мережевих інтерфейсів</td><td style="height:97px;">Назва мережевого інтерфесу, MAC-адресу якого використовувати при створенні ідентифікатору</td></tr><tr style="height:63.4px;"><td style="height:63.4px;">`SOLOVEYKO_USER_NAME`</td><td style="height:63.4px;">`soloveyko`</td><td style="height:63.4px;">Відповідно до правил іменування груп і користувачів</td><td style="height:63.4px;">Ім'я користувача, від якого працюватиме додаток</td></tr><tr style="height:63.3833px;"><td style="height:63.3833px;">`SOLOVEYKO_USER_GROUP`</td><td style="height:63.3833px;">`soloveyko`</td><td style="height:63.3833px;">Відповідно до правил іменування груп і користувачів</td><td style="height:63.3833px;">Група користувача</td></tr><tr style="height:63.3833px;"><td style="height:63.3833px;">`SOLOVEYKO_UID_GID`</td><td style="height:63.3833px;">`1488`</td><td style="height:63.3833px;">Відповідно до правил іменування груп і користувачів</td><td style="height:63.3833px;">ID-номер користувача і групи</td></tr><tr style="height:46.6px;"><td style="height:46.6px;">`SOLOVEYKO_AUDIO_ONLY_HEADLESS_MODE`</td><td style="height:46.6px;">`False`</td><td style="height:46.6px;">`True`, `False`</td><td style="height:46.6px;">Прихований режим: відключити будь-який вивід зображення, відтворювати лише звук.   
</td></tr><tr style="height:63.4px;"><td style="height:63.4px;">`SOLOVEYKO_AUTOLOGIN_USER`</td><td style="height:63.4px;">`False`</td><td style="height:63.4px;">`True`, `False`</td><td style="height:63.4px;">Створити файл для автоматичного користувача в систему</td></tr><tr style="height:80.1833px;"><td style="height:80.1833px;">`SOLOVEYKO_USER_ADDITIONAL_GROUPS`</td><td style="height:80.1833px;">`audio,video,users,render,pulse,pulse-access`</td><td style="height:80.1833px;">Відповідно до списку системних груп. Список вказується без пробілів, розділення комою.</td><td style="height:80.1833px;">Додати користувача до наступних груп, окрім власної</td></tr><tr style="height:46.6px;"><td style="height:46.6px;">`SOLOVEYKO_LOG_PATH`</td><td style="height:46.6px;">`/var/log/soloveyko/`</td><td style="height:46.6px;">Відповідно до правил створення шляхів</td><td style="height:46.6px;">Директорія для логів</td></tr><tr style="height:46.6px;"><td style="height:46.6px;">`SOLOVEYKO_STORAGE_BASE`</td><td style="height:46.6px;">`/var/lib/soloveyko/`</td><td style="height:46.6px;">Відповідно до правил створення шляхів</td><td style="height:46.6px;">Директорія для даних</td></tr><tr style="height:80.2px;"><td style="height:80.2px;">`SOLOVEYKO_SETUP_SYSTEMWIDE_PULSEAUDIO`</td><td style="height:80.2px;">`False`</td><td style="height:80.2px;">`True`, `False`</td><td style="height:80.2px;">Встановити файл сервісу для запуску звукового серверу на системному рівні</td></tr><tr style="height:46.6px;"><td style="height:46.6px;">`SOLOVEYKO_NO_ENABLE`</td><td style="height:46.6px;">`False`</td><td style="height:46.6px;">`True`, `False`</td><td style="height:46.6px;">Не додавати сервіс `soloveyko` до автозапуску</td></tr><tr style="height:80.2px;"><td style="height:80.2px;">`SOLOVEYKO_NO_START`</td><td style="height:80.2px;">`False`</td><td style="height:80.2px;">`True`, `False`</td><td style="height:80.2px;">Не запускати сервіс `soloveyko` після завершення встановлення</td></tr></tbody></table>

</div><div class="ql-block" id="bkmrk-%D0%92%D1%81%D1%96-%D0%BD%D0%B0%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D1%96-%D0%B7%D0%BC%D1%96%D0%BD%D0%BD%D1%96-">Всі наведені змінні повинні бути оголошеними перед початком встановлення пакунку і оголошуватись як змінні середовища за допомогою команди `export` . Значення наведених змінних, після встановлення, будуть збережені у файл `/etc/soloveyko.env` для застосування у подальших ітераціях встановлення або оновлення пакунку.</div><div class="ql-block" id="bkmrk-%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F-%D0%B4%D0%BE%D0%B4%D0%B0%D1%82%D0%BA%D1%83">Встановлення додатку:</div>```shell
export SOLOVEYKO_SETUP_SYSTEMWIDE_PULSEAUDIO=True
# За необхідності прихованого режиму роботи:
# export SOLOVEYKO_AUDIO_ONLY_HEADLESS_MODE=True
apt install soloveyko helper-utils-soloveyko
```

### Дії після встановлення

<div class="ql-block" id="bkmrk-%D0%9F%D0%BE-%D1%83%D1%81%D0%BF%D1%96%D1%88%D0%BD%D0%BE%D0%BC%D1%83-%D0%B7%D0%B0%D0%B2%D0%B5%D1%80%D1%88%D0%B5">По успішному завершенню встановлення пакунку, у консоль буде виведено призначений ідентифікатор, який використовуватиме додаток, а також встановлені шляхи розміщення логів і даних.</div><div class="ql-block" id="bkmrk--7">![2.png](https://docs.soloveyko.media/uploads/images/gallery/2024-12/2.png)</div><div class="ql-block" id="bkmrk-%D0%86%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%82%D0%BE%D1%80-%D0%BD%D0%B5%D0%BE%D0%B1%D1%85%D1%96">Ідентифікатор необхідно власноруч вказати під час додавання пристрою у інтерфейсі платформи `app.soloveyko.media`.</div><div class="ql-block" id="bkmrk--8">  
</div><div class="ql-block" id="bkmrk-%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D1%96%D1%80%D0%BA%D0%B0-%D1%80%D0%BE%D0%B1%D0%BE%D1%82%D0%B8-%D0%B4%D0%BE%D0%B4">Перевірка роботи додатку може бути здійснена за допомогою команди:</div>```shell
systemctl status soloveyko
```

<div class="ql-block" id="bkmrk--9">![3.png](https://docs.soloveyko.media/uploads/images/gallery/2024-12/3.png)</div><div class="ql-block" id="bkmrk-%D0%A2%D0%B0%D0%BA%D0%BE%D0%B6-%D0%BC%D0%BE%D0%B6%D0%BD%D0%B0-%D0%BF%D0%B5%D1%80%D0%B5%D0%B3%D0%BB%D1%8F%D0%BD">Також можна переглянути логи:</div>```shell
mcview /var/log/soloveyko/soloveyko.log
```

<div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BE%D0%BA-%D0%BC%D0%B0%D1%94-%D1%84%D0%B0%D0%B9%D0%BB-%D0%BD%D0%B0%D0%BB">Додаток має файл налаштувань `/opt/soloveyko/config/override.yml`, у якому можна внести деякі додаткові налаштування для роботи конкретного екземпляру додатку. Всі налаштування будуть збережені між перевстановленнями додоатку, окрім випадків повного видалення (`apt purge soloveyko`).</div><div class="ql-block" id="bkmrk--10">![4.png](https://docs.soloveyko.media/uploads/images/gallery/2024-12/4.png)</div><div class="ql-block" id="bkmrk--11"></div><div class="ql-block" id="bkmrk-%D0%92%D0%BC%D1%96%D1%81%D1%82-%D1%84%D0%B0%D0%B9%D0%BB%D1%83-%D0%B2%D1%96%D0%B4%D0%BF%D0%BE%D0%B2%D1%96%D0%B4">Вміст файлу відповідає синтаксису YAML. Далі наведено опис деяких корисних налаштувань:</div><div class="ql-block" id="bkmrk-%D0%9E%D0%BF%D1%86%D1%96%D1%8F-%D0%97%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F-%D0%B7%D0%B0-%D0%B7%D0%B0"><table style="border-collapse:collapse;width:100%;height:255.172px;"><colgroup><col style="width:19.3087%;"></col><col style="width:17.2913%;"></col><col style="width:36.7016%;"></col><col style="width:26.8176%;"></col></colgroup><thead><tr style="height:46.5938px;"><td style="height:46.5938px;"><div class="qlbt-cell-line">**Опція**</div></td><td style="height:46.5938px;"><div class="qlbt-cell-line">**Значення за замовчуванням**</div></td><td style="height:46.5938px;"><div class="qlbt-cell-line">**Допустимі значення**</div></td><td style="height:46.5938px;"><div class="qlbt-cell-line">**Призначення**</div></td></tr></thead><tbody><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">`raw`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`false`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`true`, `false`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">Завантажувати файли медіаплану без нормалізації гучності</div></td></tr><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">`enable_local_api`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`true`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`true`, `false`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">Включити API</div></td></tr><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">`host`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`0.0.0.0`</div></td><td style="height:29.7969px;">  
</td><td style="height:29.7969px;"><div class="qlbt-cell-line">Адреса мережевого інтерфейсу API</div></td></tr><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">`port`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`14880`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">1 - 65000</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">Порт API</div></td></tr><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">`history`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`20`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">1 - 100</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">Кількість файлів логів, які будуть збережені на диску</div></td></tr><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">`size`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`3`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">1 - 10</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">Розмір файлу логу в мегабайтах, при досягненні якого буде виконана ротація</div></td></tr><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">`ao`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`pulse`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">`pipewire`, `pulse`, `alsa`, `jack`, `sdl`, `pcm`</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">Назва звукового серверу</div></td></tr></tbody></table>

</div>## Допоміжні засоби

### REST API

<div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BE%D0%BA-%D0%BC%D0%B0%D1%94-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8C-r">Додаток має модуль REST API для можливості здійснювати контроль роботи додатку всередині локальної мережі (потребує окремого налаштування фаєрволу). Далі наведено опис методів API:</div><div class="ql-block" id="bkmrk-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%A2%D0%B8%D0%BF-%D0%90%D1%80%D0%B3%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B8-"><table style="border-collapse:collapse;width:100%;height:539.328px;"><colgroup><col style="width:15.8522%;"></col><col style="width:6.7938%;"></col><col style="width:24.1955%;"></col><col style="width:10.0119%;"></col><col style="width:24.4338%;"></col><col style="width:18.8319%;"></col></colgroup><thead><tr style="height:29.7969px;"><td style="height:29.7969px;"><div class="qlbt-cell-line">**Метод**</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">**Тип**</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">**Аргументи**</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">**Значення**</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">**Призначення**</div></td><td style="height:29.7969px;"><div class="qlbt-cell-line">**Приклад запиту**</div></td></tr></thead><tbody><tr style="height:113.766px;"><td style="height:113.766px;"><div class="qlbt-cell-line">`/reschedule`</div></td><td style="height:113.766px;"><div class="qlbt-cell-line">`POST`</div></td><td style="height:113.766px;"><div class="qlbt-cell-line">Відсутні</div></td><td style="height:113.766px;">  
</td><td style="height:113.766px;"><div class="qlbt-cell-line">Почати позачергове оновлення розкладів відтвоерння контенту</div></td><td style="height:113.766px;"><div class="qlbt-cell-line">`curl -X POST "http://127.0.0.1:14880/reschedule"`</div></td></tr><tr style="height:82.2031px;"><td style="height:82.2031px;"><div class="qlbt-cell-line">`/refresh_device_config`</div></td><td style="height:82.2031px;"><div class="qlbt-cell-line">`POST`</div></td><td style="height:82.2031px;"><div class="qlbt-cell-line">Відсутні</div></td><td style="height:82.2031px;">  
</td><td style="height:82.2031px;"><div class="qlbt-cell-line">Синхронізувтаи конфігурацію додатку з платформою `<a class="ql-link" href="http://app.soloveyko.media" target="_blank">app.soloveyko.media</a>`</div></td><td style="height:82.2031px;"><div class="qlbt-cell-line">`curl -X GET "http://127.0.0.1:14880/refresh_device_config"`</div></td></tr><tr style="height:216.578px;"><td style="height:216.578px;"><div class="qlbt-cell-line">`/set_volume`</div></td><td style="height:216.578px;"><div class="qlbt-cell-line">`POST`</div></td><td style="height:216.578px;"><div class="qlbt-cell-line">`volume`</div><div class="qlbt-cell-line">`volume_ad_and_promo`</div><div class="qlbt-cell-line">`volume_system_sound`</div><div class="qlbt-cell-line">`volume_when_system_sound`</div><div class="qlbt-cell-line">`volume_while_air_alert`</div><div class="qlbt-cell-line">  
</div></td><td style="height:216.578px;"><div class="qlbt-cell-line">0 - 200</div></td><td style="height:216.578px;"><div class="qlbt-cell-line">Встановити гучності незважаючи на всі налаштування отримані з платформи. Налаштування будуть актуальні до моменту наступного оновлення конфігурації або зміни гучності на сторінці керування на платформі `<a class="ql-link" href="http://app.soloveyko.media" target="_blank">app.soloveyko.media</a>`. Передавати необхідно всі аргументи</div></td><td style="height:216.578px;"><div class="qlbt-cell-line">`curl -X POST "http://127.0.0.1:14880/set_volume?volume=80&volume_ad_and_promo=80&volume_system_sound=80&volume_when_system_sound=80&volume_while_air_alert=80"`</div></td></tr><tr style="height:96.9844px;"><td style="height:96.9844px;"><div class="qlbt-cell-line">`/play_filename`</div></td><td style="height:96.9844px;"><div class="qlbt-cell-line">`GET`</div></td><td style="height:96.9844px;"><div class="qlbt-cell-line">`filename`</div></td><td style="height:96.9844px;"><div class="qlbt-cell-line">назва файлу з розширенням</div></td><td style="height:96.9844px;"><div class="qlbt-cell-line">Відтворити системне звукове сповіщення</div></td><td style="height:96.9844px;"><div class="qlbt-cell-line">`curl -X GET "http://127.0.0.1:14880/play_filename?filename=default_location_closing.mp3"`</div></td></tr></tbody></table>

</div>## Пакунок `helper-utils-soloveyko` та інші

<div class="ql-block" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%BA%D0%BE%D0%B2%D0%BE-%D0%B4%D0%BE-%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D0%BE">Додатково до основного пакунку з додатком "soloveyko", в репозиторії знаходяться пакунки, які надають допоміжні функції, наприклад</div>- Автоматичне оновлення пакунку soloveyko
- Моніторинг з'єднаня з інтернетом
- Контроль за рівнями гучності звукових інтерфейсів
- Розширення бібліотеки системних звукових сповіщень

<div class="ql-block" id="bkmrk-%D0%A0%D0%B5%D0%BA%D0%BE%D0%BC%D0%B5%D0%BD%D0%B4%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%BC-%D0%B4%D0%BE-%D0%B2%D1%81">Рекомендованим до встановлення є пакунок `helper-utils-soloveyko`, який містить утиліти для оновлення і моніторингу.</div>

# Інструкція користувача платформою Соловейко.Медіа

#### <span style="text-decoration:underline;">**Вступ**</span>

Сайт [app.soloveyko.media](https://app.soloveyko.media) є частиною платформи Соловейко.Медіа, яка надає рішення для створення унікальної аудіовізуальної атмосфери в бізнесі. Платформа дозволяє керувати відтворенням аудіо та відео реклами, цифрового меню та унікальних сповіщень, сприяючи збільшенню середнього чека та додатковому заробітку на рекламі.

Через особистий кабінет користувачі можуть завантажувати зображення, відео, музику, створювати цифрове меню та керувати контентом на екранах зі своїх комп'ютерів, телефонів чи планшетів. Медіа-контент автоматично відтворюється на екранах у точках продажу відповідно до розкладу.

#### **1. Локації та пристрої** 

Даний розділ дозваоляє керувати та моніторти усі підключені пристрої та локації.

[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/tB7image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/tB7image.png)Має основні поля для взаємодії:

1. <span style="text-decoration:underline;">Локації </span>- вкладка котра містить усі локації та пристрої вашої організації
2. <span style="text-decoration:underline;">Вільні соловейчики</span> - тут зщнаходяться соловейчики котрі не прив'язані до жодної локації
3. <span style="text-decoration:underline;">Офлайн соловейчики</span> - список пристроїв котрі наразі офлайн
4. <span style="text-decoration:underline;">Пошук </span>- пошук по локація/пристром/місту
5. <span style="text-decoration:underline;">Загальна кількість онлайн/офлайн соловейчиків</span>
6. <span style="text-decoration:underline;">Меню локацій</span> - випадаюче меню країна/область/місто
7. <span style="text-decoration:underline;">Локація</span> - дозволяє потрапити в меню відповаідної локації

##### <span style="text-decoration:underline;">1.1 Налаштування та взаємодія з локацією</span>  
 

- Вкладка **"Зона"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/VJ7image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/VJ7image.png)

1. <span style="text-decoration:underline;">Відеозона</span> - тут знаходяться відеопристрої
2. <span style="text-decoration:underline;">Аудіозона</span> - тут знаходяться відеопристрої
3. <span style="text-decoration:underline;">Переглянути медіаплан</span> - актуальний розклад локаціїї
4. <span style="text-decoration:underline;">Прив'язати пристрій</span> - додати пристрій у зону
5. <span style="text-decoration:underline;">Пристрої</span> - пристрої підключені до відповідної зони

- Натиснувши на **"Пристрій"**  вас переведе у меню пристрою[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/jkVimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/jkVimage.png)Знаходячись у пристрої вам знадобиться лише блок налаштування гучності пристрою, завдяки ньому ви можете відрегулювати гучність пристрою прямо з платформи Соловейко.

- Повернувшись у меню локації є вкладка **"Сповіщення"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/d11image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/d11image.png)

1. <span style="text-decoration:underline;">Тестовий виклик касира</span> - якщо функція підключена, можна запустити тестовий файл котрий прозвучить на локації
2. <span style="text-decoration:underline;">Тестовий виклик замовлення Глово </span>- якщо функція підключена, можна запустити тестовий файл котрий прозвучить на локації
3. <span style="text-decoration:underline;">Хвилина мовчання</span> - кнопка включення/виключення хвилини мовчання. Якщо включено о 9:00 кожного днгя буде відтворюватись хвилина мовчання.
4. <span style="text-decoration:underline;">Тестовий запукск хвилини мовчання </span>- тестовий запуск хвилини мовчання на локації

- Повернувшись у меню локації є вкладка **"Налаштування"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/hEfimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/hEfimage.png)[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/FAAimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/FAAimage.png)**Налаштування локації містить такі блоки:**

1. <span style="text-decoration:underline;">Ідентифікування локації</span> - Редагування загальної інформаціїї локації
2. <span style="text-decoration:underline;">Географія локації</span> - геолокація (не використовується)
3. <span style="text-decoration:underline;">Контактні особи</span> - працівники локації (Управляючий/завтупник/керуючий)
4. <span style="text-decoration:underline;">Години роботи локації</span> - час відкриття та закриття локації. Пристрої орієнтуютсь на цей параметр, щоб розуміти коли починати та закінчувати відтворення контенту.
5. <span style="text-decoration:underline;">Повітряна тривога</span> - підключення сповіщення про повітряну тривогу, важливо встановити правильну область, тому що пристрої за цією інформацією відтворюють сповіщення про повітряним тривогам в україні


##### <span style="text-decoration:underline;">1.2 Завантаження звіту про всі підключенні пристрої</span>

[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/Rpvimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/Rpvimage.png)

1. У меню **"Локації та пристрої",** натисніть 3 краки
2. У вікошку натисніть "**Підключені пристрої"**
3. Після цього буде завантажений звіт по всім підключеним до локацій пристроями

#### **2. Завантаження контенту на платформу**

##### <span style="text-decoration:underline;">2.1 Створення плейлисту</span>

- Перейдіть на вкладку **"Аудіосупровід"** або **"Відеосупровід"** в головному меню, залежить від типу контенту котрий ви додаєте.
    
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/8O3image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/8O3image.png)
- Натисніть кнопку з **3 крапками** у правій частині екрану.
- Натисніть кнопку "**Додати плейлист**"

 [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/KKFimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/KKFimage.png)

- Додайте назву новому плейлисту.
- Збережіть зміни натиснувши кнопку **"Зберегти зміни"** у правому нижньому кутку екрану


 [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/renimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/renimage.png)

##### <span style="text-decoration:underline;">2.2 Завантаження контенту</span>

- Перейдіть на вкладку **"Аудіосупровід"** або **"Відеосупровід"** в головному меню, залежить від типу контенту котрий ви додаєте.
    
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/8O3image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/8O3image.png)
- Оберіть потрібний плейлист клікнувши на нього.[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/d0rimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/d0rimage.png)
- Натисніть кнопку **"Завантажити аудіо"**/**"Завантажити відео"** в правій частині екрану


 [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/1A1image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/1A1image.png)[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/lLOimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/lLOimage.png)


- Після перехорду на сторінку завантаження можна завантажити контент. Є 2 можливості завантажити файли.  
    1) Перетягти файли з папки де вони збережені на комп'ютері у відповідне поле на сторінці сайту. [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/Jxvimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/Jxvimage.png)
    
    2) Натисніть кнопку **"Завантажити відео"**. У вікні, котре відчиниться, оберіть потрібні файли на натисніть кнопку **"Відкрити"**
- Після додавання файлів, дуже важливо дочекатись закінчення завантаження. Пункти **"Завантажується"** та **"Очікує завантаження"** мають відображати 0 файлів у черзі. [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/NNTimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/NNTimage.png)
- Після завершення процесу завантаждення натисніть кнопку **"Повернутись до плейлиста"** щоб побачити загальний список файлів у даному плейлисті.

#### **3. Створення та налаштування етерів**

##### **<span style="text-decoration:underline;">3.1. Створення етеру</span>**

- <span style="text-decoration:underline;">Н</span>атисніть кнопку **"Етери"** в головному меню [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/dDzimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/dDzimage.png)
- Натисніть **3 крапки** у верхньому правому куті та **"Додати Етер"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/C8Uimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/C8Uimage.png)
- Дайте назву новому Етеру

<p class="callout warning">ВАЖЛИВО! Так як це меню містить розклади для всіх видів пристроїв, рекомендуємо в назві етеру зазначати для яких пристроїв, або під які локації створено цей етер. Щоб у майбутньому не було проблем з навігацією серед купи етерів.</p>

- Натисніть кнопку **"Зберегти зміни"** у правому нижньому кутку екрану

 ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/renimage.png)

- Новий Етер створено, для подальших налаштувань потрібно повернутись в меню Етерів, натиснувши кнопку **"Етери"** в головному меню.

 ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/dDzimage.png)

#####   
**<span style="text-decoration:underline;">3.2. Створення розкладу</span>**

- Поверніться до меню **"Етери"**, знайдіть створений етер, та натисніть кнопку **"Створити Розклад"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/MIrimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/MIrimage.png)
- Дайте назву вашому розкладу, та встановіть часові рамки, в який період буде працювати цей розклад [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/vNkimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/vNkimage.png)
- Натисніть **"Зберегти зміни"** у правому нижньому кутку екрану

 **![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/renimage.png)**

- Поверніться до меню **"Етери"**, знайдіть створений етер, та натисніть кнопку **"Додати таймслот"**

 ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/lHTimage.png)

- Додайте часові рамки [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/5vXimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/5vXimage.png)
    
    <p class="callout warning">ВАЖЛИВО! Встановлюйте час відповідно до графіку роботи магазинів, де транслюватиметься ефір. Якщо магазини працюють за різним розкладом, орієнтуйтеся на той, що відкривається найраніше, і на той, що закривається найпізніше.  
    Приклад:  
    Магазин 1 07:00 - 21:00  
    Магазин 2 08:00 - 22:00  
    При такій ситуації потрібно встановлювати часові рамки 07:00 - 22:00</p>
- Натисніть кнопку **"Зберегти зміни"** у правому нижньому кутку екрану

 **![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/renimage.png)**

##### <span style="text-decoration:underline;">**3.3. Завантаження та налаштування контенту в етер:**</span>

#####  <span style="text-decoration:underline;">3.3.1 Завантаження **звичайного** контенту</span>

- Перейдіть в таймслот вашого Етеру (**"Етер"** -&gt; У блоці потрібного етеру натисніть на стровений **"Таймслот"**) [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/xEyimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/xEyimage.png)
- У верхній частині екрану оберіть **"Налаштування контенту"** [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/lHoimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/lHoimage.png)
- Натисніть кнопку **"Додати плейлист"**![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/RzMimage.png)
- Оберіть тип контенту котрий буде транслюватись у цьому розкладі **Аудіо/Відео**![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/tUlimage.png)
- Оберіть створений для цього розкладу плейлист ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/bNHimage.png)
- Натисніть кнопку **"Підтвердити"** у правому нижньому кутку вікна ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/9Rvimage.png)
- Після підтвердження вас поверне до налаштувань розкладу, натисніть кнопку **"Налаштувати діапазон"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/J7bimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/J7bimage.png)
- У вікні натисніть кнопку **"Додати діапазон"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/AMOimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/AMOimage.png)
- Оберіть **дату початку та дату кінця** трансляції цього плейлиста.

<p class="callout info">До одного плейлиста можна додавати декілька діапазонів одночасно. В такому випадку плейлист буде транслюватись лише в обраних діапазонах дат.</p>

- Натисніть кнопку **"Підтвердити"** в правому нижньому куті вікна ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/cPiimage.png)
- Якщо діапазон було створено вірно, то у меню розкладу на місці кнопки **"Додати діапазон"** буде відображатись найближчий до актуальної дати діапазон [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/Pw5image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/Pw5image.png)

#####  <span style="text-decoration:underline;">3.3.2 Завантаження **промо** контенту</span>

- Перейдіть в таймслот вашого Етеру (**"Етер"** -&gt; У блоці потрібного етеру натисніть на стровений **"Таймслот"**) [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/xEyimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/xEyimage.png)
- У верхній частині екрану оберіть **"Налаштування промо"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/RLSimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/RLSimage.png)
- Натисніть кнопку **"Додати плейлист"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/5KRimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/5KRimage.png)
- Оберіть тип контенту котрий буде транслюватись у цьому розкладі **Аудіо/Відео**![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/tUlimage.png)
- Оберіть створений для цього розкладу плейлист ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/bNHimage.png)
- Натисніть кнопку **"Підтвердити"** у правому нижньому кутку вікна ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/9Rvimage.png)

- Після підтвердження вас поверне до налаштувань розкладу, натисніть кнопку **"Налаштувати діапазон"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/J7bimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/J7bimage.png)
- У вікні натисніть кнопку **"Додати діапазон"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/AMOimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/AMOimage.png)
- Оберіть **дату початку та дату кінця** трансляції цього плейлиста.

<p class="callout info">До одного плейлиста можна додавати декілька діапазонів одночасно. В такому випадку плейлист буде транслюватись лише в обраних діапазонах дат.</p>

- Натисніть кнопку **"Підтвердити"** в правому нижньому куті вікна ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/cPiimage.png)
- Якщо діапазон було створено вірно, то у меню розкладу на місці кнопки **"Додати діапазон"** буде відображатись найближчий до актуальної дати діапазон [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/yiRimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/yiRimage.png)

##### <span style="text-decoration:underline;">3.3.3 Налаштування **промо** контенту</span>

Для налаштування потрібно заповнити 4 поля у вкладці **"Налаштування промо"**

[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/Hbdimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/Hbdimage.png)

**1) "Кожні # треків" -** як часто промо блок буде потрапляти в ефір.

<p class="callout info">Наприклад: Якщо встановити значення 3, тоді проблок буде транслуватись кожні 3 треки зі звичайного плейлиста.  
Якщо значення 4 то кожні 4 треки і т.д.</p>

**2) "Вид вставки" -** як вставити промо блок відносно звичайного контенту

<p class="callout info">Наприклад: Якщо Поставити значення "ДО", тоді промо блок буде відтворюватись перед звичайним контентом, а якщо "ПІСЛЯ" то відтворення відбудеться після звичайного контенту. <span style="text-decoration:underline;">По суті це налаштування визначає послідовність звичайного та промо контенту.</span></p>

**3) "Кількість треків"** - Яку кількість треків буде містити промо блок

<p class="callout info">Наприклад: Якщо значення буде стояти 4, тоді промо блок буде включати в себе 4 треки. Після відтворення 4-х промо роликів почнеться трансляція звичайного контенту.   
</p>

<p class="callout warning">Значення може бути більше кількості треків у плейлисті, але потрібно мати на увазі, що в такому випадку треки будуть повторюватись у промо блоці по декілька разів.</p>

**4) "Вага"** - кількість треків котрі будуть потрапляти до промо блоку з даного плейлиста

<p class="callout info">Наприклад: Якщо ми створили 2 плейлисти и виставили кожному з них різні значення **"ваги"**, наприклад 1 і 2, тоді у кожен промо блок буде потрапляти 1 трек із плейлисту з вагою 1 та 2 треки із плейлисту з вагою 2.</p>

<p class="callout info">На скріншоті нижче приведено приклад налаштувань промо контенту.  
1) Кожні **3 треки** буде запускатись промо блок  
2) Промо блок буде відтворюватись **до** блоку із 3-х треків  
3) Промо блок буде містити в собі **3 промо треки**  
4) Промоблок буде брати **2 треки** з плейлисту **Тест 2, та 1 трек** з плейлисту **Тест.**</p>

[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/bTcimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/bTcimage.png)

<p class="callout info">Виходячи з налашитувань вище медіаплан розкладу биде виглядати наступним чином, приклад на початку роботи розкладу:  
**Жовтим позначено промо блок -** він іде **до** відтворення перших музикальних треків, та містить **1 трек** з плейлисту **ТЕСТ (Test audio)**, та **2 треки** з плейлисту **ТЕСТ 2 (Test audio 2, Test audio 2.1).  
Рожевим позначено блок звичайного контенту** - він містить 3 музикальні треки згідно до налаштувань **"Кожні # треків"**.</p>

[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/LjXimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/LjXimage.png)

<p class="callout info">Вкладка **"Перегляд черги"** відображає актуальну чергу відтворення медіаплану. Та має дві дотакові функції. **1) "Оновити чергу"** - кнопка перезбиранне чергу відтворення роликів. Ця кнопка потрібна пізля внесення змін у розклад, щоб нові треки додались у чергу відтворення.   
**2) "Синхронізувати чергу пристроїв"** - кнопка відправляє на всі пристрої котрі прив'язані до цього ефіру оновлення розкладу.  
<span style="text-decoration:underline;">**ВАЖЛИВО!** Кнопка не миттєво завантажує розклад на пристрої. Оновлення відбуваеться протягом 1 години після відправлення команди.</span></p>

#### **4. Рекламні кампанії**

#####  <span style="text-decoration:underline;">4.1. Створення рекламної кампанії</span>  


<p class="callout info">Для аудіо та відео процес створення та налаштування рекламної кампанії нічим не відрізняються,, тому подальша інструкця буде зроблена на прикладі аудіо.</p>

- Натисніть кнопку **"Реклама"** у головному меню платформи дле переходу у відповідний розділ [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/YW5image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/YW5image.png)
- У правій частині екрану натисніть кнопку **"Додати кампанію"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/3nkimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/3nkimage.png)
- Внесіть налаштування майбутньої рекламної кампанії <p class="callout info">[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/0WNimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/0WNimage.png)  
    1) Назва рекламної кампанії  
    2) Назва компанії замовника реклами  
    3) Дані кнопки допомагають зручно налаштовувати саме дати початку та кінця рекламної кампанії.  
    <span style="text-decoration:underline;">  
    Приклад 1: Якщо 15 січня натиснути "**7 днів"** тоді встановиться діапазон 15 січня - 21 січня.  
    Приклад 2: Якщо вручну виставити дату початку кампанії 1 січня, та натиснути кнопку "7днів", тоді становиться діапазон 1 січня - 7січня</span>  
      
    4) Дати початку/кінця та час початку/кінця рекламної кампанії  
    5) Налаштування діапазону часу виходу реклами (Ви відмічаете кількість підрізків котрі вам потрібні, кожен чекбокс відповідає хвилинам вказаним над ними.   
    <span style="text-decoration:underline;">  
    Наприклад: Якшо відмітити 0,10.,20,30,40,50 тоді реклама буде відтворюватись в ефірі кожні 10 хв.  
    </span>  
    6) Автоматичний підрахунок кількості виходів реклами згідно до внесених налаштувань.  
    </p>
- Після внесення необхідних налашитувань натисніть кнопку **"Зберегти зміни" ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/renimage.png)**
- Після збереження налаштувань з'явиться кнопка **"Завантажити трек",** натисніть її для того щоб додати рекламний трек [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/o76image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/o76image.png)
- У вікні натисніть кнопку **"Завантажити"**, або перетягніть файл з треком у відповідне поле [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/NUyimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/NUyimage.png)
- Після додання треку він з'являться у блоці **"Медіа контент"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/T5limage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/T5limage.png)
    
    <p class="callout info">Для зручності користування, на платформу додали штучний інтелект, котрий здатен зробити транскрипцію любого аудіо/відео файлу.  
    Щоб скористатись цією функцією потрібно натиснути кнопку **"Класифікувати".**</p>
- Після додавання треку Натисніть кнопку **"Локації"** [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/rqMimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/rqMimage.png)
    
    <p class="callout info">Цей роділ потрібен для того щоб обрати на яких локаціях буде транслюватись рекламна кампанія. Локацію можна додати двома способами.</p>
- <span style="text-decoration:underline;">**Спосіб 1: "За маскою"**</span>[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/Cdmimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/Cdmimage.png)
    
    - Оберіть необхідні налаштування маски Країна/Регіон/Населений пункт/Адреса  
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/2jLimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/2jLimage.png)<p class="callout warning">Можна заповнювати не всі поля у вікні. Під полями будуть відображатись усі доступні для трансляції зони відповідно до даних внесених у маску.  
    </p>

\- **Оберіть зони** на котрих ви плануєте запускати рекламну кампанію

 ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/8X6image.png)

\- **Оберіть локації** на котрий має транслюватись рекламна кампранія

\- Натисніть **"Підтвердити"** у нижному правому куті вікна.

- **Спосіб 2: За ID Локації**

\- Натисніть **"Додати локацію за ID"**

 ![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/dBNimage.png)

<p class="callout info">Зверніть увагу, на платформі Соловейко.Медіа кожна локація має власний індентифікатор.![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/SaXimage.png)</p>

\- У вікні пропишіть **ID локації**,оберіть бажану для трансляції **зону**

[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/yUNimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/yUNimage.png)

\- **Оберіть локації** на котрий має транслюватись рекламна кампранія

\- Натисніть **"Підтвердити"** у нижному правому куті вікна

- **Рекламна кампанія створена,** це можна побачити у загальному меню реклами.  
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/hUYimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/hUYimage.png)

#####  <span style="text-decoration:underline;">4.2 Виведення рекламної кампанії в ефір</span>

<p class="callout info">Початкове затвердження рекламної кампанії. На даному етапі кампанію ще можна редагувати перед виходом в ефір.   
Проміжне затвердження необхідно для перевірки налаштувань, або якщо є відповідальний за рекламу керівник, щоб він фінально погоджував налаштування виходу кампанії.</p>

- <span style="text-decoration:underline;">Перейдіть у створену вами рекламну кампанію  
    </span>
- <span style="text-decoration:underline;">Натисніть три крапки у правому верхньому куті екрану</span>, та натисніть **"Затвердити"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/qabimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/qabimage.png)
- Натисніть кнопку **"Підтвердити"**![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/Oglimage.png)

<p class="callout info">Під час проміжного затвердження кампанія змінює статус із **"Чорновик"** на **"Очікує затвердження"**  
![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/6reimage.png)</p>

- <span style="text-decoration:underline;">Перейдіть у створену вами рекламну кампанію  
    </span>
- <span style="text-decoration:underline;">Натисніть три крапки у правому верхньому куті екрану</span>, та натисніть **"Погодити"**
- Натисніть **"Підтвердити"**  
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/z0Iimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/z0Iimage.png)

<p class="callout info">Після погодження рекламної кампанії, вона з'явиться у ефірі, та почне трансляцію на пристроях.  
Статуст кампанії у загальному меню Реклами зміниться зі статусу **"Очікує підтвердження"** на ствтус **"В етері"[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/99Mimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/99Mimage.png)**</p>

<p class="callout warning">Після фінального погодження рекламної кампанії зміни можна вносити лише знявши кампанію з ефіру, або після її завершення.</p>

##### <span style="text-decoration:underline;">4.3 Зняття рекламної кампанії з ефіру</span>

- <span style="text-decoration:underline;">Перейдіть у погоджену рекламну кампанію **"в етері"**  
    </span>
- <span style="text-decoration:underline;">Натисніть три крапки у правому верхньому куті екрану</span>, та натисніть **"Скасувати"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/EQnimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/EQnimage.png)
- Натисніть **"Підтвердити"** [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/OPAimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/OPAimage.png)
- Рекламана компанія отримає статус **"Скасована"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/luAimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/luAimage.png)

<p class="callout info"><span style="text-decoration:underline;">Якщо необхідно повернути рекламну кампанію в етер зі змінами.  
  
</span>- Перейдить в **скасовану** рекламну компанію.  
-Натисніть **"Відновити"  
-** Вносьте зміни та затверджуйте ракламну кампанію згідно пунктам **3.1 та 3.2** </p>

##### <span style="text-decoration:underline;">4.4 Продовження рекламної кампанії</span>

- Перейдить в **Завершену** або **Скасовану** рекламну компанію.
- Натисніть **3 крапки** та **"Продовжити"** у правому верхньому кутку екрану
    
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/07qimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/07qimage.png)
- Далі слідуйте пунктам **3.1** та **3.2**

#### **5. Ефірна довідка**

##### 5.1 Що таке Ефірна довідка

Це меню дозволяє користувачам завантажувати звіт по рекламі за необхідний період часу. Ви отримуєте Exel табличку зі списком рекламних роликів та кількістю їх виходів.

##### 5.2 Як працює Ефірна довідка

- Натисніть **"Евірна довідка"** в головному меню  
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/THMimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/THMimage.png)
- Оберіть потрібний **діапазон звіту**
    
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/btDimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/btDimage.png)
- Натисніть **"Завантажити звіт"**
- Після цього звіт надійде на **пошту через котру зареєстровано особистий кабінет.**


#### **6. Налаштування організації**  
  


- Натисніть **"Шестерню"** у лівому верхньому кутку екрану [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/vDFimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/vDFimage.png)
- Натисніть кнопку **"Налаштувати"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/ED5image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/ED5image.png)
- Налаштування 2 вкладки **"Налаштування"** та **"Учасники"**
- Вкладка **"Налаштування"** має 3 блоки:  
    1) Назва організації  
    2) Налаштування повітряної тривоги  
     -Сповіщення про воітряну тривогу - Вмикає/Вимикає сповіщення  
     -Частота відтворення сигналу - Через який проміжок часу буде повторюватись сповіщення про повітряну тривогу.   
    3)Налаштування планування контенту - Відповідає за об'єм розкладу котрий завантажується на пристрій, від 1 до 7 днів.   
      
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/YAdimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/YAdimage.png)
- Вкладка **"Учасники"** відображає всіх користувачів платформи в вашій організації.   
    1\) Поле для пошуку користувачів, потрібно ввести імейл користувача котрого щукаєте  
    2\) Кнопка відповідає за запрошення нового користувача до організації.
    
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/YFiimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/YFiimage.png)

##### <span style="text-decoration:underline;">6.1. Користувачі та ролі</span>

Як додати нового користувача

- Зайдіть в **"Налаштування"** організації, перейдіть у вкладку **"Учасники"**
- Натисніть **3 крапки** та **"Запросити учасника"**[![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/CfJimage.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/CfJimage.png)
- 1) Впишіть у поле імейл користувача котрого ви бажаєте додати  
    2) Оберіть роль учасника  
    [![image.png](https://docs.soloveyko.media/uploads/images/gallery/2025-01/scaled-1680-/nE7image.png)](https://docs.soloveyko.media/uploads/images/gallery/2025-01/nE7image.png)
    
    <p class="callout info">Які можливості надають ролі:  
    **Адміністратор** - має повні права та функціонал на платформі  
    **Менеджер локації** - має досту лише до дозволених локацій, може налаштовувати та керувати пристроєм на локації <span style="text-decoration:underline;">(Зміна гучності, Керування хвилиною мовчання, тестові відтворення файлів сповіщень)  
    </span>**Слухач** - не має жодного функціоналу (тестова роль)</p>
- Після додавання учасника на пошту надійде лист з запрошенням для реєстрації.   
    -Реєстрацію потрібно проводити саме на імейл котрий додавали до організації  
    -Після реєстрації потрібно її підтвердити на пошті

---

# Інструкція для встановлення пристрою "Соловейко.Аудіо"

#### **1. Підготовка до встановлення**

- Виберіть зручне місце для розміщення пристрою "Соловейко.Аудіо" біля підсилювача звуку та мережевого комутатора, або роутера.
- Переконайтеся, що поруч є доступ до **дротового інтернет-з'єднання (Ethernet)** та електроживлення.
- Підготуйте необхідні кабелі: мережевий (Ethernet), аудіокабель (3,5 мм або RCA) та блок живлення (У комплекті з Соловейчиком).

#### **2. Підключення пристрою**

- **Інтернет:** Підключіть пристрій до мережевого комутатора або роутера.
- **Аудіо:** З'єднайте аудіовихід пристрою із підсилювачем звуку за допомогою аудіокабелю.
- **Живлення:** Підключіть пристрій до електромережі через блок живлення.

#### **3. Перевірка підключення**

- Переконайтеся, що індикатори живлення та мережі на пристрої світяться (Індикатори знаходяться біля порту Ethernet).
- Перевірте, чи пристрій підключений до підсилювача звуку та звук надходить на систему гучномовців.

#### **4. Контакт із представником "Соловейко.Медіа"**

- Після завершення встановлення повідомте **технічного спеціаліста "Соловейко.Медіа"** для перевірки підключення пристрою.
- Спеціалісти проведуть дистанційну перевірку роботи пристрою та налаштують контент для відтворення.
- У разі виникнення питань звертайтеся до служби підтримки "Соловейко.Медіа".

# Інструкція для встановлення пристрою "Соловейко.Відео"

#### **1. Підготовка до встановлення**

- Виберіть зручне місце для розміщення пристрою "Соловейко.Відео" за телевізором.
- Переконайтеся, що поруч є доступ до **дротового інтернет-з'єднання (Ethernet)** та електроживлення.
- Підготуйте необхідні кабелі: мережевий (Ethernet), HDMI кабель та блок живлення (У комплекті з Соловейчиком).

#### **2. Підключення пристрою**

- **Інтернет:** Підключіть пристрій до мережевого комутатора або роутера.
- **Відео:** Телевізор та Соловейко з'єднайте HDMI-кабелем. Рекомендуємо підключати до порту HDMI1
- **Живлення:** Підключіть пристрій до електромережі через блок живлення.

#### **3. Перевірка підключення**

- Переконайтеся, що індикатори живлення та мережі на пристрої світяться (Індикатори знаходяться біля порту Ethernet).
- Перевірте, чи почалось відтворення відео на телевізорі.

#### **4. Контакт із представником "Соловейко.Медіа"**

- Після завершення встановлення повідомте **технічного спеціаліста "Соловейко.Медіа"** для перевірки підключення пристрою.
- Спеціалісти проведуть дистанційну перевірку роботи пристрою та налаштують контент для відтворення.
- У разі виникнення питань звертайтеся до служби підтримки "Соловейко.Медіа".

# Вимоги для встановлення та налаштування

### Фізичне підключення пристрою Соловейко:

##### Необхідні кабелі:

\- Мережевий кабель (Ethernet);  
\- Аудіокабель (3,5 мм або RCA);  
\- Кабель живлення з блоком живлення (У комплекті з Соловейчиком).

##### Процес підключення:

\- Мережевий кабель.   
Підключіть пристрій до мережевого комутатора або роутера.  
\- Аудіокабель.  
З'єднайте аудіовихід пристрою із підсилювачем звуку за допомогою аудіокабелю.  
\- Живлення.   
Підключіть пристрій до електромережі через блок живлення. Блок живлення потрібно вставити в розетку на серверній стійці (обладнану безперебійником).

##### Видача доступів:

Для коректної роботи пристроїв Соловейко, для них необхідно надати доступи до серверів Соловейко.Медіа.  
94.158.94.148  
195.189.226.201  
185.25.118.68  
185.69.154.217  
49.13.26.111

протокол ICMP

протокол TCP на порти 80, 53, 443, 123, 8443  
протокол UDP на порти 80, 53, 443, 123, 8443