Игровые оповещения

Оповещения это отдельный канал связи с пользователем, который игры могут использовать в своих целях.

Все отправляемые пользователю оповещения доступны для просмотра на всех платформах в отдельном разделе оповещений:

https://ok.ru/notifications на десктопе;
https://m.ok.ru/notifications на мобильных платформах.

По типу взаимодействия оповещения делятся на:

user-to-user оповещения, которые пользователи шлют друг другу сами:
- приглашение в игру;
- оповещение из игры;
единичные app-to-user оповещения, которые игра может слать пользователю;
массовые app-to-user оповещения, которые игра может рассылать сразу на группу пользователей.

user-to-user оповещения отправляются через FAPI SDK. app-to-user оповещения отправляются через REST API

FAPI.UI.showNotification: user-to-user оповещение

Для отправки этого оповещения используется FAPI SDK метод FAPI.UI.showNotification. Это оповещение, которое пользователи могут отправлять друг другу внутри игры.

Процесс отправки оповещения выглядит так:

отправитель инициирует отправку оповещения в UI игры;
игра вызывает метод отправки;
в появившемся окне отправительно выбирает получателей оповещения, и также (опционально) текст оповещения;
оповещение отправляется получателю.

В итоге получателю придет оповещение, в котором будет видно как отправителя оповещения, так и игру, из которой это оповещение пришло:

FAPI.UI.showInvite: user-to-user приглашение в игру

Для отправки этого оповещения используется FAPI SDK метод FAPI.UI.showInvite. Это приглашение в игру, которое пользователи могут друзьям, которые еще не запускали игру.

Процесс отправки оповещения выглядит так:

отправитель инициирует отправку приглашения в UI игры;
игра вызывает метод отправки;
в появившемся окне отправительно выбирает получателей приглашения, и также (опционально) текст оповещения;
приглашение отправляется получателю.

notifications.sendSimple: app-to-user оповещение

Для отправки этого оповещения используется REST API метод notifications.sendSimple. Это информационное оповещение от игры пользователю, которое можно отправить любому пользователю, играющему в игру.

Если метод вызван корректно, то пользователь получит оповещение с указанным текстом от игры:

notifications.sendMass: массовые app-to-user оповещения

Для отправки этого оповещения используется REST API метод notifications.sendMass. Это информационное оповещение от игры пользователю, которое можно отправить сразу группе пользователей на основе фильтров, которые поддерживаются при вызове метода, например, пол пользователей или время последнего запуски игры пользователями.

Если метод вызван корректно, то все пользователи, попавшие под условия отправки оповещения, в течение 30 минут получат оповещение с указанным текстом от игры: