Плагин Trakt в Lampa: настройка скробблинга и истории серий

Одной из главных проблем при использовании медиаоболочки Lampa на нескольких домашних устройствах является разрозненность истории просмотров. Если встроенная экосистема учетных записей CUB отлично справляется с синхронизацией установленных плагинов, закладок и пользовательских настроек, то детальный учет просмотренных эпизодов многосезонных сериалов и фиксация прогресса в минутах часто сбиваются при переустановке приложения или смене телевизора.

Решением этой задачи выступает интеграция с международным облачным сервисом Trakt.tv через официальный JS-плагин. Сервис берет на себя роль независимого агрегатора метаданных: фиксирует точное время завершения каждой серии, автоматически переводит статус фильма в «Просмотрено» (Scrobbling) и формирует динамическую ленту «Up Next» (Что смотреть дальше) прямо на главной странице Lampa.

Возможности и архитектура расширения Trakt для Lampa

Расширение Trakt представляет собой модульный клиент к REST API v2 сервиса api.trakt.tv. Модуль подключается в рантайм Lampa через стандартный механизм расширений и взаимодействует с внутренними событиями встроенного HTML5-видеоплеера и внешних декодеров.

Ключевые функции, которые добавляет плагин в пользовательский интерфейс:

Автоматический двусторонний скробблинг: во время запуска воспроизведения плагин отправляет событие scrobble/start. Во время просмотра передаются контрольные пакеты прогресса, а при пересечении порога в 80% хронометража на сервер отправляется запрос scrobble/stop с флагом завершения.
Лента Up Next на главном экране: оболочка автоматически запрашивает следующий не просмотренный эпизод для всех сериалов из вашей истории. Вам больше не нужно вспоминать, на каком сезоне и серии вы остановились.
Облачные списки Watchlist и Собрания (Collection): доступ к вашим закладкам Trakt без привязки к конкретной операционной системе (Android TV, Tizen или webOS).
Индивидуальный календарь премьер: список дат выхода новых серий именно тех сериалов, которые добавлены в ваш профиль.

Если вы активно используете каталог верифицированных плагинов для Lampa, модуль Trakt работает с ними в полной синергии: карточки фильмов с онлайн-балансеров и торрент-раздач автоматически сопоставляются по идентификаторам TMDB ID и IMDb ID.

Установка плагина Trakt в медиаоболочку

Для подключения расширения используется стабильный скрипт из проверенного репозитория сообщества. Установка выполняется в несколько стандартных шагов:

Запустите Lampa на вашем телевизоре или ТВ-боксе.
Перейдите в раздел Настройки (иконка шестеренки) -> Расширения (Плагины).
Нажмите кнопку Добавить плагин.
В появившемся поле ввода URL с помощью экранной клавиатуры укажите рабочий адрес скрипта:

https://lampame.github.io/main/trakttv.js

Нажмите клавишу ввода и подтвердите добавление.
Выйдите в главное меню и полностью перезапустите Lampa (на Android TV — через принудительное закрытие в диспетчере задач, на Smart TV — перезапуском приложения).

После повторного запуска в основном боковом меню Lampa появится новый раздел Trakt, а в системных настройках отобразится блок управления параметрами учетной записи.

Авторизация через протокол OAuth Device Code

Плагин не требует небезопасного ввода пароля учетной записи на экране телевизора. Сопряжение выполняется по отраслевому стандарту RFC 8628 (OAuth 2.0 Device Authorization Grant):

Откройте Настройки -> Расширения -> Trakt.tv.
Выберите пункт Авторизоваться (или Подключить аккаунт).
На экране появится модальное окно с инструкцией, ссылкой trakt.tv/activate и персональным 8-значным алфавитно-цифровым кодом (например, 78B4-29C1).
На смартфоне или компьютере откройте браузер, войдите в свой профиль Trakt и перейдите по адресу trakt.tv/activate.
Введите код, отображаемый на экране телевизора, и подтвердите доступ кнопкой Authorize.
Через 2–4 секунды Lampa получит постоянный токен access_token и обновит статус авторизации на «Подключено».

Диалоговое окно сопряжения аккаунта Trakt с кодом активации и QR кодом на экране телевизора

Токен сохраняется в локальном хранилище localStorage профиля. Время жизни базового токена Trakt составляет 90 дней, после чего плагин автоматически выполняет тихий запрос обновления через refresh_token без участия пользователя.

Тонкая настройка скробблинга и списков

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

Автоскробблинг (Autoscrobble): установите переключатель в положение «Включено». Это активирует отправку телеметрии прогресса каждые 15 минут фонового воспроизведения.
Порог отметки о просмотре (Completion Threshold): оптимальное инженерное значение — 80%. Титры в полнометражных фильмах и сериалах нередко занимают от 5 до 12 минут. Если оставить порог 95–100%, плагин не успеет зафиксировать факт просмотра, если вы выключите плеер на финальных титрах.
Синхронизация истории при запуске: включите эту опцию, если смотрите контент на нескольких устройствах (например, днем на планшете, а вечером на телевизоре). При старте Lampa подгрузит актуальный статус серий из облака.
Скрытие просмотренного из каталогов: позволяет очистить витрины рекомендаций от уже просмотренных картин.

Меню параметров плагина Trakt в интерфейсе Lampa с включенным автоскробблингом

Специфика работы с внешними видеоплеерами

Если во встроенном плеере Lampa отслеживание прогресса работает нативно через события HTML5 Media API, то при перенаправлении потока во внешние плееры Vimu, Just Player или VLC процесс синхронизации требует внимания:

Плеер Vimu Media Player: полностью поддерживает передачу метаданных обратно в Lampa. Для корректного скробблинга убедитесь, что в настройках Vimu включен параметр «Сохранять позицию и передавать статус выхода». При нажатии кнопки «Назад» Vimu возвращает в Android Intent точное значение времени остановки (position) и общую длительность (duration). Плагин считывает эти значения и немедленно отправляет финальный scrobble-пакет в Trakt.
Внутренний плеер Lampa (Web): наиболее надежен для скробблинга на Tizen и webOS, так как работает в одном потоке с веб-оболочкой.
Сбои синхронизации при обрыве сети: если во время просмотра пропал интернет или перезагрузился роутер, плагин сохраняет недоставленный статус в локальной очереди IndexedDB и повторяет отправку при следующем успешном сетевом рукопожатии.

Для более точного выбора аудиодорожек и субтитров перед началом сеанса используйте связку с плагином Tracks-MediaInfo, который позволяет заранее оценить параметры медиаконтейнера.

Устранение неполадок при работе с Trakt

Ошибка 401 Unauthorized при попытке скробблинга: токен авторизации устарел либо был отозван в настройках безопасности Trakt. Зайдите в меню плагина, нажмите «Выйти» и повторите процедуру сопряжения через код на trakt.tv/activate.
Серии не отмечаются автоматически: проверьте установленный порог завершения. Если файл завершается до достижения планки (например, из-за поврежденного таймкода раздачи), отметка не ставится. Снизьте порог до 75–80%.
Бесконечная загрузка окна с кодом активации: сетевые запросы к домену api.trakt.tv могут блокироваться региональными фильтрами провайдера. Проверьте работу DNS на телевизоре или настройте безопасный протокол DoH на домашнем роутере.

Чек-лист готовности интеграции Trakt в Lampa

Плагин trakttv.js добавлен в меню расширений Lampa и успешно инициализирован.
Устройство привязано к аккаунту Trakt через ввод 8-значного кода на trakt.tv/activate.
В настройках плагина активирован автоскробблинг с порогом завершения 80%.
В главном меню появились разделы Up Next и Watchlist с персональной историей.
При просмотре через внешний плеер проверен корректный возврат Intent-параметров позиции.