73 lines
4.0 KiB
Markdown
73 lines
4.0 KiB
Markdown
# Lampa Plugin — «Мои фильмы»
|
||
|
||
Плагин добавляет в меню Lampa раздел **«Мои фильмы»**: каталог фильмов с обложками,
|
||
описанием и торрентами. Клик по фильму → детали → «Смотреть» → воспроизведение
|
||
через настроенный в Lampa torrserver (localhost:8090).
|
||
|
||
## Структура на сервере
|
||
|
||
Всё раздаётся по одному базовому URL (например `https://movies.example.com/`):
|
||
|
||
```
|
||
server-root/
|
||
├── catalog.json описание каталога (массив фильмов)
|
||
├── covers/
|
||
│ ├── inception.jpg
|
||
│ └── interstellar.jpg
|
||
├── torrents/
|
||
│ ├── inception.torrent
|
||
│ └── interstellar.torrent
|
||
└── plugin.js (можно раздавать отсюда же или с отдельного хоста)
|
||
```
|
||
|
||
`catalog.json` — см. `catalog.example.json`. Поля фильма:
|
||
|
||
| поле | обязательно | назначение |
|
||
|-----------------|-------------|---------------------------------------------|
|
||
| `id` | да | уникальный id |
|
||
| `title` | да | название |
|
||
| `original_title`| нет | оригинальное название |
|
||
| `year` | нет | год |
|
||
| `genre` | нет | массив жанров |
|
||
| `rating` | нет | рейтинг |
|
||
| `description` | нет | описание |
|
||
| `poster` | нет | путь к обложке в `covers/` (или полный URL) |
|
||
| `torrent` | да* | путь к `.torrent` в `torrents/` (или URL) |
|
||
| `magnet` | нет | magnet-ссылка (приоритетнее `torrent`) |
|
||
|
||
\* нужен либо `torrent`, либо `magnet`.
|
||
|
||
## Требования к серверу
|
||
|
||
- Отдавать `catalog.json`, `covers/*`, `torrents/*` по HTTPS (или HTTP, если Lampa на
|
||
том же устройстве).
|
||
- **CORS**: заголовок `Access-Control-Allow-Origin: *` на `catalog.json` и обложки
|
||
(Lampa грузит их из WebView). Торрент torrserver забирает сам — CORS для него не нужен,
|
||
но файл должен отдаваться с корректным типом.
|
||
- Любой статический хостинг: nginx, Caddy, GitHub Pages, хостинг торрент-бокса и т.п.
|
||
|
||
Пример nginx:
|
||
|
||
```nginx
|
||
location / {
|
||
add_header Access-Control-Allow-Origin *;
|
||
try_files $uri $uri/ =404;
|
||
}
|
||
```
|
||
|
||
## Установка плагина в Lampa
|
||
|
||
1. Положи `plugin.js` на доступный по URL хост, запомни прямую ссылку
|
||
(например `https://movies.example.com/plugin.js`).
|
||
2. В Lampa: **Настройки → Плагины → Добавить плагин** → вставить URL `plugin.js` → OK.
|
||
3. В **Настройки → Плагины → Мои фильмы** (параметр «Адрес сервера каталога»)
|
||
вписать базовый URL сервера (с `/` на конце), напр. `https://movies.example.com/`.
|
||
4. В главном меню появится пункт **«Мои фильмы»**.
|
||
|
||
## Поток воспроизведения
|
||
|
||
При нажатии «Смотреть» плагин передаёт torrent/magnet в `Lampa.Player`. Дальше
|
||
работает уже настроенный в Lampa torrserver (локально `localhost:8090`), который
|
||
раздаёт видеопоток плееру. Плагин сам torrserver не трогает.
|
||
|