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

Обновлено 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, то приложение закрывается по нажатию кнопки Назад без дополнительного уведомления.