xplay

/usr/bin/xplayrun — запуск скрипта (можно настроить параметры запуска)
/usr/bin/xplay — основная программа
/usr/bin/xplayctl — инструмент командной строки
/etc/xplay/log4qt.properties — файл конфигурации логов
/etc/xplay/simsun.ttc — шрифт по умолчанию
/etc/xplay/xplay.pid — идентификатор процесса во время выполнения
/etc/ld.so.conf.d/00-xplay.conf — указание на файлы библиотек
/usr/local/lib/... — каталог файлов связанных библиотек

git clone https://github.com/nulijiabei/xplay.git # (последняя версия из ветки Master)
git clone https://github.com/nulijiabei/xplay.git -b v1.0.22.v20220406 # (последнюю версию можно найти по тегам)
или
git clone https://gitee.com/nljb/xplay.git # (последняя версия из ветки Master)
git clone https://gitee.com/nljb/xplay.git -b v1.0.22.v20220406 # (последнюю версию можно найти по тегам)

cd xplay/raspios/
sh -x rpi_drm_install.sh или sh -x rpi_x11_install.sh

// Разрешение экрана 1920x1080 (по умолчанию)
// Частота кадров 30 кадров в секунду (по умолчанию)
export LD_LIBRARY_PATH=/usr/local/lib/
/usr/bin/xplay

// Разрешение экрана 1920x1080
// Частота кадров 30 кадров в секунду
// (если не указано иное, используются значения по умолчанию)
export LD_LIBRARY_PATH=/usr/local/lib/
/usr/bin/xplay -R 0,0,1920,1080 -fps 30

// Тестовый материал
cp autotest/yiyezi.mp4 /root/yiyezi.mp4
// Тестирование воспроизведения
export LD_LIBRARY_PATH=/usr/local/lib/
/usr/bin/xplay -playing /root/yiyezi.mp4
``` **4. Просмотр журнала**

**Частые проблемы**

**1. Ошибка нехватки памяти**

> Скрипт установки по умолчанию уже настроил для вас память, после установки перезагрузите Raspberry Pi.

| Файл | Настройка | Описание |
| --- | --- | --- |
| /boot/config.txt | gpu_mem=256 (выделение памяти GPU не менее 192M) | Вступает в силу после перезагрузки |

> Примечание: тестирование показало, что при воспроизведении видео 720P требуется не менее 192 МБ памяти, а при воспроизведении 1080P — не менее 256 МБ или больше !!!

**2. Настройки звука**

> Настройка файла конфигурации (/etc/asound.conf) для указания режима вывода звука

> Если во время использования возникает проблема со звуком, можно попробовать следующие решения:
1. Обновите систему до последней версии

2. Настройте режим микширования звука (/etc/asound.conf)

---

**Управление воспроизведением**
* Установите TCP-соединение с проигрывателем через Socket API и отправьте команды на проигрыватель, чтобы получить ответ.
* Можно использовать различные языки программирования для разработки программы управления (Java, Python, C++, Golang и т. д.).
* Примечание: перед запуском примера программы сначала запустите основную программу xplay (/usr/bin/xplay).

[Пример на Golang](example/example.go)  
[Пример на Python](example/example.py)  
[Пример на Java](example/XplayCtl.java)  

---

**Инструменты командной строки**

[Инструмент командной строки xplayctl](example/xplayctl.go)  
[Сценарий на основе инструмента командной строки example_x1_xplayctl.sh](example/example_x1_xplayctl.sh)  
[Сценарий на основе инструмента командной строки example_x4_xplayctl.sh](example/example_x4_xplayctl.sh)

Пожалуйста, обратитесь к разделу «Команды» ниже, чтобы использовать следующие параметры командной строки:

| Параметр командной строки (base) | Значение по умолчанию | Описание |
| --- | --- | --- |
| -addr | 127.0.0.1:8700 | Сетевой адрес и порт |

| Параметр командной строки (type) | Описание |
| --- | --- |
| -play | Команда воспроизведения |
| -stop | Команда остановки |
| -move | Команда перемещения |
| -snap | Команда создания снимка экрана |
| -query | Команда запроса |
| -change | Команда изменения |

| Параметр командной строки (query) | Описание |
| --- | --- |
| -all | Запрос всех слоёв |

| Параметр командной строки (stop) | Значение по умолчанию | Дополнительные параметры | Описание |
| --- | --- | --- | --- |
| -start | -1 | Нет | Время остановки (мс) |
| -all | Нет | Нет | Остановить все слои |
| -ids | Нет | Нет | Остановить указанные слои |

| Параметр командной строки (move) | Значение по умолчанию | Дополнительные параметры | Описание |
| --- | --- | --- | --- |
| -zIndex | 10  | 0–999  | Слой |
| -rect   | 0,0,1920,1080  | left,top,width,height |   Размер и положение отображения материала |

| Параметр командной строки (change) | Значение по умолчанию | Дополнительные параметры | Описание |
| --- | --- | --- | --- |
| -zIndex | 10  | 0–999  | Слой |
| -newIndex | 0  | 0–999  | Слой |

| Параметр командной строки (snap) | Значение по умолчанию | Описание |
| --- | --- | --- |
| -path | snap.jpg | Путь сохранения снимка экрана |

| Параметр командной строки (play) | Значение по умолчанию | Дополнительные параметры | Описание |
| --- | --- | --- | --- |
| -start | -1 | Нет | Начальное время (мс) |
| -libName | Нет | video, pic, sequence, gif, qrcode, camera, text, scroll, datetime, toast | Тип материала |

| Параметр командной строки (sequence) | Значение по умолчанию | Дополнительные параметры | Описание |
| --- | --- | --- | --- |
| -zIndex        | 10            | 0–999                 | Слой |
| -rect          | 0,0,1920,1080 | left,top,width,height   | Размер и положение отображения материала |
| -screen_mode   | landscape     | landscape, portrait     | Режим горизонтального и вертикального экрана |
| -screen_rotate | 0             | 0, 180, 90, 270         | Угол поворота |
| -path          | Нет            | Материал пути 1, материал пути 2, материал пути 3,... | Несколько путей материалов разделены запятыми (,) |
| -duration      | 5             | Нет                      | Время воспроизведения невидеоматериалов (с) |

| Параметр командной строки (video) | Значение по умолчанию | Дополнительные параметры | Описание |
| --- | --- | --- | --- |
| -zIndex        | 10            | 0–999               | Слой |
| -rect          | 0,0,1920,1080 | left,top,width,height | Размер и положение отображения материала |
| -screen_mode   | landscape     | landscape, portrait   | Режим горизонтального и вертикального экрана |
| -screen_rotate | 0             | 0, 180, 90, 270       | Угол поворота |
| -path          | Нет            | Нет                    | Путь материала |
| -offset        | -1            | Нет                    | Смещение (мс) |
| -timeout       | -1            | Нет                    | Тайм-аут отключения (мс) | | Команда                  | Значение по умолчанию | Возможные значения | Описание                                                                       |
| ------------------------- | -------------------- | ------------------ | ----------------------------------------------------------------------------- |
| -path                     | 无                    | 无                   | Путь к материалам                                                              |
| -zIndex                   | 10                    | 0–999                | Уровень (слой)                                                                   |
| -rect                     | 0, 0, 1920, 1080       | left, top, width, height | Размеры и положение материала на экране                                          |
| -screen_mode              | landscape             | landscape, portrait | Режим экрана: горизонтальный или вертикальный                                    |
| -screen_rotate            | 0                     | 0, 180, 90, 270      | Угол поворота экрана                                                            |
| -content                  | 无                    | 无                    | Текстовое содержимое                                                             |

| Команда                  | Значение по умолчанию | Возможные значения | Описание                                                                       |
| ------------------------- | -------------------- | ------------------ | ----------------------------------------------------------------------------- |
| -device                   | /dev/video0           | 无                   | Адрес устройства                                                                |
| -camera_width             | 1280                  | 无                   | Ширина видео с камеры                                                           |
| -camera_height            | 720                   | 无                   | Высота видео с камеры                                                            |

| Команда                  | Значение по умолчанию | Возможные значения | Описание                                                                       |
| ------------------------- | -------------------- | ------------------ | ----------------------------------------------------------------------------- |
| -font_ttf                 | 无                    | 无                    | Указанный шрифт TrueType                                                        |
| -font_size                | 18                    | 12–72                | Размер шрифта                                                                    |
| -color                    | rgba(0, 128, 0, 100)   | 无                   | Цвет текста и его прозрачность                                                    |
| -bgcolor                  | rgba(0, 0, 0, 20)     | 无                   | Фон и его прозрачность                                                           |
| -align                    | center                | center, right, left | Выравнивание текста                                                               |
| -style                    | normal                | normal, bold, italic, underline, strikethrough | Стиль текста                                                                     |

| Команда                  | Значение по умолчанию | Возможные значения | Описание                                                                       |
| ------------------------- | -------------------- | ------------------ | ----------------------------------------------------------------------------- |
| -orientation              | horizontal            | horizontal, vertical | Направление перемещения                                                         |
| -speed                    | 1                     | Каждый кадр перемещается на указанное количество пикселей | Скорость перемещения                                                              |

| Команда                  | Значение по умолчанию | Возможные значения | Описание                                                                       |
| ------------------------- | -------------------- | ------------------ | ----------------------------------------------------------------------------- |
| -duration                 | 0                     | Без ограничения (0) | Время отображения (в секундах), если 0 — то бесконечно                           |

    zIndex: 10
    path: "/root/sample.mp4"
    offset: 5000
    left: 0
    top: 0
    width: 1920
    height: 1080
    screen_mode: "landscape"
    screen_rotate: 0  

| Потоковое воспроизведение видео | Описание |
| --- | --- |
| timeout | Таймаут при потере потока (мс) |

>Таймаут при потере потока: когда в потоке видео не удаётся получить данные, текущий декодер завершается. Состояние декодера можно запросить с помощью команды query.

params:
    path: "http://ivi.bupt.edu.cn/hls/cctv1hd.m3u8"
    timeout: 5000
    height: 1080
    width: 1920
    left: 0
    top: 0
    screen_mode: "landscape"
    screen_rotate: 0
    zIndex: 10  

params:
    zIndex: 10
    path: "/root/cat.jpg"
    top: 0
    left: 0
    height: 1080
    width: 1920
    screen_mode: "landscape"
    screen_rotate: 0   

| Последовательное воспроизведение (sequence) | Описание |
| --- | --- |
| path | Несколько путей к материалам через запятую |
| duration | Время воспроизведения для материалов, отличных от видео (с) |

params:
    zIndex: 10
    path: "/root/a1.mp4,/root/b1.jpg,/root/a2.mp4,/root/b2.jpg"
    duration: 10
    top: 0
    left: 0
    width: 1920
    height: 1080
    screen_mode: "landscape"
    screen_rotate: 0    

| Последовательное воспроизведение (sequence) | Описание |
| --- | --- |
| deps[] | Данные последовательности |
| deps[].path | Путь к материалу |
| deps[].type | Соответствующий тип libName (video, pic) |
| deps[].duration | Время воспроизведения для материалов, отличных от видео (с) |

params:
    zIndex: 10
    top: 0
    left: 0
    width: 1920
    height: 1080
    screen_mode: "landscape"
    screen_rotate: 0     

deps:
    {
        duration: -1
        path: "/root/a1.mp4"
        type: "video"
    }

    {
        duration: 10
        path: "/root/b1.jpg"
        type: "pic"
    }

    {
        duration: -1
        path: "/root/a2.mp4"
        type: "video"
    }

    {
        duration: 10
        path: "/root/b2.jpg"
        type: "pic"
    }    

| Информационное всплывающее окно (toast) | Значение | Описание |
| --- | --- | --- |
| toast_type | notice, success, warning, error | Тип сообщения |
| duration | 0 (бессрочно) | Время отображения (с), закрывается по таймауту |

params:
    toast_type: "notice"
    duration: 5    

| Камера (camera) | Значение | Описание |
| --- | --- | --- |
| device | /dev/video0 | Адрес устройства |
| camera_width | 1280 | Ширина видео с камеры |
| camera_height | 720 | Высота видео с камеры |  

params:
    device: "/dev/video0"
    camera_width: 1280
    camera_height: 720
    top: 0
    left: 0
    width: 1920
    height: 1080
    screen_mode: "landscape"
    screen_rotate: 0      

| Текст (text) | Значение | Описание |
| --- | --- | --- |
| color     | rgba(0, 128, 0, 100) | Цвет и прозрачность текста |
| bgcolor   | rgba(0, 0, 0, 0)     | Цвет и прозрачность фона |
| font_ttf  | /etc/xplay/simsun.ttc | Указанный шрифт |
| font_size | 14                    | Размер шрифта |
| align     | center, right, left   | Выравнивание |
| style     | normal, bold, italic, underline, strikethrough | Стиль | | Тип | Описание |
| --- | --- |
| **Текст** |  
| \t | \t\t123,456,789\n987,654,321 | 
|  | Форматирование с помощью символа табуляции. |
| \n | ABC\nBCD | 
| | Форматирование с помощью переноса строки. |
| Пробел | ABCDEF ABCDEF ABCDEF | 
| | Текст переносится на следующую строку при превышении ширины строки, если есть свободное место. |

| **Прокрутка (scroll)** | Значение | Описание |
|---|---|---|
| Цвет | rgba(0, 128, 0, 100) | Цвет и прозрачность текста. |
| Фон | rgba(0, 0, 0, 0) | Цвет и прозрачность фона. |
| Шрифт TTF | /etc/xplay/simsun.ttc | Указанный шрифт. |
| Размер шрифта | 14 | Размер шрифта. |
| Стиль | normal, bold, italic, underline, strikethrough | Стиль текста. |
| Скорость | 1 (кадр перемещается вперёд на N пикселей) | Скорость перемещения. |
| Содержание | ABCDEFGHIJKLMNOPQRSTUVWXYZ | Содержимое текста. |
| Ориентация | горизонтальная, вертикальная | Направление перемещения. |

| **Параметры прокрутки** | Значение | Описание |
|---|---|---|
| Ширина | Вертикальная — действует / горизонтальная — не действует = screen.width | Действительность ширины. |
| Высота | Горизонтальная — действует / вертикальная — не действует = screen.height | Действительность высоты. |
| Левая сторона | Вертикальная — действует / горизонтальная — не действует = 0 | Действительность левой стороны. |
| Верхняя часть | Горизонтальная — действует / вертикальная — не действует = 0 | Действительность верхней части. |

| **Дата и время (datetime)** | Значение | Описание |
|---|---|---|
| Цвет | rgba(0, 128, 0, 100) | Цвет и прозрачность текста. |
| Фон | rgba(0, 0, 0, 0) | Цвет и прозрачность фона. |
| Шрифт TTF | /etc/xplay/simsun.ttc | Указанный шрифт. |
| Размер шрифта | 30 | Размер шрифта. |
| Выравнивание | center, right, left | Способ выравнивания. |
| Стиль | normal, bold, italic, underline, strikethrough | Стиль текста. |

> Если анимация отображается неправильно, вы можете попробовать сохранить её заново в Photoshop.

| --- | --- | --- |
| zIndex | 0 - 999 | Слой |
| newIndex | 0 - 999 | Слой |  

>Когда целевой слой существует, исходный слой будет обмениваться с целевым слоем.  
>Если целевой слой не существует, исходный слой изменится на целевой слой.