FAPI.UI.showNotification

Общая информация

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

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

Сигнатура метода

FAPI.UI.showNotification(text, params, selected_uids);
ПараметрОбязателенОписание
textДаТекст, который будет отправлен в оповещении
paramsНетКастомные данные, передаваемые приложению, когда пользователь принимает приглашение. Данные будут переданы в параметре «custom_args», подробную информацию см. в разделе Параметры приложения.
Максимальная длина: 120 символов.
selected_uidsНетСписок идентификаторов друзей, которые будут уже выбраны при открытии окна приглашения.
Максимум 20 ID за запрос.
Пользователи должны быть в списке друзей, выделяются только те пользователи, которые играли в последнее время в игры.

Ограничения

На отправку нотификаций есть ограничение, 20 в день для одного пользователя (для незапущенных приложений 50). Перед вызовом метода можно проверить ограничение с помощью метода 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”

Пример диалога отправки уведомления

В результате выполнения функции пользователю будет показан диалог для выбора и отправки приглашений в игру друзьям:

Пример диалога для веб-версии приложения

Пример диалога для мобильной версии приложения