Запуск игры в iframe на мобильных платформах

Срок перевода всех игр на открытие в iframe - 15.11.2019

Сейчас на мобильных платформах игры, выпущенные до 2019 года, открываются не внутри фрейма Одноклассников, а редиректятся на URL разработчика. В мобильных браузерах это выглядит странно для пользователя, как будто он переходит из Одноклассников на незнакомый ему сайт.

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

Плюсы нового формата запуска

Запуск в iframe позволяет игре получать ряд выгодных преимуществ по сравнению с предыдущим вариантом запуска:

  • Единое для всех платформ SDK.
  • Новое SDK лишено всех недостатков старого SDK, больше не надо делать кастомные реализации платежей и соц. механик разных браузеров и платформ. Эти задачи решает само SDK.
  • Все новые возможности платформы будут поддерживаться только для iframe. Например, для iframe уже собирается расширенная статистика по проведенному в игре времени, а в скором времени планируется добавить игровые подписки, которые уже давно доступны на вебе, и упростить SDK для показа рекламы.
  • Более надежная поддержка сессии пользователя силами самой платформы ОК.
  • Пользователь не редиректится из ОК на URL игры, а остается на ОК. Это удобно для пользователя, а разработчику игры не требуется размещать на странице игры виджет возврата в ОК.

Подготовка к переводу на новый формат запуска

Уже сейчас вы можете протестировать, как ваша игра будет работать, используя этот URL:

https://m.ok.ru/dk
   ?st.cmd=appLauncher
   &st.appShortName=[SHORTNAME]
   &st.originalUrl=/app/[SHORTNAME]

Вместо [SHORTNAME] нужно подставить shortname вашей игры. Например, для игры https://m.ok.ru/game/kiss URL будет выглядеть вот так: https://m.ok.ru/dk?st.cmd=appLauncher&st.appShortName=kiss&st.originalUrl=/app/kiss

Также вы можете создать тестовое приложение, дублирующее ваше продакшн приложение. В нём iframe и поддержка единого SDK будут включены по умолчанию.

Миграция на единое SDK

После перехода на запуск в iframe у вас появится возможность интеграции с ОК через FAPI SDK, которое ранее было доступно только на вебе.

Все основные методы FAPI уже поддерживаются на мобильных платформах:

Именно это SDK в будущем будет дорабатываться и обрастать новой функциональностью.

Завершение перевода на iframe

Если всё работает корректно, то для полного перевода на запуск в iframe и подключение FAPI SDK вам надо обратиться к команде платформы Игры ОК любым из возможных способов. Например:

  • api-support@ok.ru;
  • чат с командой платформы в любом из мессенджеров;
  • задача вашей игры на jira.apiok.ru.