Январь 2023. Подписка на служебные события в SDK

В JS SDK появилась возможность подписываться на важные события, происходящие на устройстве пользователя, которые могут оказаться полезными для игр:

  • смена темы устройства;
  • смена ориентации устройства;
  • появление меню с настройками игры;
  • появление клавиатуры (только android).

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

Например, если пользователь сменил ориентацию экрана, то игре будет сообщено об этом факте, а также передана информация о текущей ориентации экрана на устройстве пользователя.

Кому доступно обновление

  • Платформы: android, iOS, mobile web

Как это работает

Для того, чтобы подписаться на служебные событии, вам нужно вызвать метод FAPI.UI.observeServiceCallbacks:

FAPI.invokeUIMethod("observeServiceCallbacks");

После этого при совершении события из списка поддерживаемых вам будет приходить коллбек с информацией об этом событии.

Например, если пользователь сменил ориентацию экрана на альбомную, то вам придет такой коллбек:

method: “observeServiceCallbacks”

result: “ok”

data: “DEVICE_ORIENTATION:landscape”

Дальнейшее развитие

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

Кроме того, если у вас есть идеи и предложения о том, какие события могло быть полезным добавить еще, то мы открыты к предложениям по развитию данного инструмента.

Ваши вопросы и предложения, как всегда, можно адресовать на api-support@ok.ru, в канал разработчиков игр в ОК, в рабочий чат с командой игровой платформы ОК, либо в jira.apiok.ru