Правила формирования диплинков

Обновлено 25 апреля 2025

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

Автоматический запуск плеера

• Диплинк должен сразу открывать страницу с запущенным плеером, без необходимости дополнительных действий со стороны пользователя (например, нажатия кнопки Смотреть).
• Плеер должен начинать воспроизведение контента автоматически (с учётом настроек автовоспроизведения браузера и платформы).

Схема

Диплинк должен иметь андроидную схему, а не веб-линки вида http:// или https://.

Передача параметров

Диплинк должен поддерживать передачу параметров, таких как:

• идентификатор фильма/сериала;
• идентификатор сезона и эпизода (для сериалов);
• таймкод для продолжения просмотра (если пользователь ранее начал смотреть фильм или сериал);
• профиль для того, чтобы пропустить его выбор;
• признак закрытия приложения по нажатию кнопки Назад.

Подписки и авторизация

• Диплинк должен учитывать статус авторизации пользователя. Если пользователь не авторизован, то его можно перенаправить на страницу входа, а после авторизации сразу запустить плеер.
• Диплинк должен учитывать активные подписки пользователя. Если у пользователя нет подписки, то его можно перенаправить на страницу выбора подписки, а после покупки сразу запустить плеер.

Минимальная задержка

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

Обратная совместимость

Новый формат диплинка должен быть обратно совместим с текущей реализацией, чтобы не нарушить работу уже интегрированных решений.

Обработка ошибок

• В случае недоступности контента (фильм удален или недоступен в регионе) пользователь должен получить соответствующее уведомление.
• Если плеер не может запуститься, должна быть предусмотрена fallback-страница с предложением выбрать другой контент или повторить попытку.

Тестирование и документация

• Необходимо предоставить тестовую apk для проверки работы новых диплинков.
• Должна быть предоставлена подробная документация по интеграции и использованию нового формата.

Поддержка разных типов контента

Диплинк должен корректно работать для разных типов контента: фильмы, сериалы, трейлеры, дополнительные материалы (если доступно).

Пример формата диплинка

Пример URL: kinoteatr://kinoteatr.ru/play?content_id=12345&season=1&episode=2&resume=120&profile=basic&close_app_on_back_press=true.

• content_id — идентификатор фильма/сериала.
• season и episode — для сериалов.
• resume — таймкод для продолжения просмотра.
• profile — выбор профиля children, basic
• close_app_on_back_press — признак закрытия приложения по нажатию кнопки Назад. Если true, то приложение закрывается по нажатию кнопки Назад без дополнительного уведомления.