Общая информация
Отображает диалог оповещения пользователя. Позволяет указать текст приглашения по умолчанию и кастомные аргументы приложения.
Оповещение аналогично приглашению, за исключением того, что его можно отправить пользователям, которые уже используют приложение.
Сигнатура метода
FAPI.UI.showNotification(text, params, selected_uids);| Параметр | Обязателен | Описание |
|---|---|---|
| text | Да | Текст, который будет отправлен в оповещении |
| params | Нет | Кастомные данные, передаваемые приложению, когда пользователь принимает приглашение. Данные будут переданы в параметре «custom_args», подробную информацию см. в разделе Параметры приложения. Максимальная длина: 120 символов. |
| selected_uids | Нет | Список идентификаторов друзей, которые будут уже выбраны при открытии окна приглашения. Максимум 20 ID за запрос. Пользователи должны быть в списке друзей, выделяются только те пользователи, которые играли в последнее время в игры. |
Ограничения
На отправку нотификаций есть ограничение, 40 в день для одного пользователя. Перед вызовом метода можно проверить ограничение с помощью метода users.getCallsLeft, указав специальную константу notifications.sendFromUser.
Пример вызова
/*
* Пример использования диалога оповещения
*/
function showNotification(){
FAPI.UI.showNotification("Поиграй в мою игру!", "arg1=val1");
// в случае успеха возвращает третьим параметром строку, в которой через запятую указаны id друзей, которым отправлено оповещение
}Пример с использованием selected_uids
/*
* Пример использования диалога оповещения с предварительным выделением
*/
function showNotification2(){
var callback = function(status, result, data){
if(result.length > 2){
FAPI.UI.showNotification("Поиграй в мою игру!", "arg1=val1", result[0] + ";" + result[1]);
// в случае успеха возвращает третьим параметром строку, в которой через запятую указаны id друзей, которым отправлено оповещение
} else {
alert("Не хватает друзей для примера");
}
}
FAPI.Client.call({"method":"friends.get"},callback);
}Пример коллбека
В зависимости от действия пользователя в диалоге отправки уведомления функция API_callback может быть вызвана со следующими параметрами:
Коллбек для случая, когда пользователь отменил отправку уведомления
Веб-версия
method: “showNotification”
result: “cancel”
data: “null”
Мобильная версия
method: “showNotification”
result: “error”
data: “cancel”
Коллбек для случая, когда пользователь отправил уведомление одному другу
method: “showNotification”
result: “ok”
data: “1234567890”
Коллбек для случая, когда пользователь отправил уведомление нескольким друзьям
method: “showNotification”
result: “ok”
data: “1234567890,1234567891”
Коллбек для случая, когда не было найдено пользователей для отправки уведомления (mobile only)
method: “showNotification”
result: “error”
data: “noUsers”
Пример диалога отправки уведомления
В результате выполнения функции пользователю будет показан диалог для выбора и отправки приглашений в игру друзьям:
Пример диалога для веб-версии приложения
Пример диалога для мобильной версии приложения
