FAPI.UI.showInvite

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

В отличие от showNotification не допускает отправки приглашений пользователям, которые уже используют это приложение.

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

Пример

/*
* Пример использования диалога приглашения друзей
*/
function showInvite() {
    FAPI.UI.showInvite("Поиграй в мою игру!", "arg1=val1");
    // в случае успеха возвращает в API_callback третьим параметром строку, в которой через запятую указаны id приглашенных друзей
}

Пример с использованием selected_uids

/*
* Пример использования диалога приглашения друзей с предварительным выделением
*/
function showInvite2() {
    var callback = function(status, result, data) {
        if(result.length > 0) {
            FAPI.UI.showInvite("Поиграй в мою игру!", "arg1=val1", result[0]);
            // в случае успеха возвращает в API_callback третьим параметром строку, в которой через запятую указаны id приглашенных друзей
        } else {
            alert("Не хватает друзей для примера");
        }
    }
    FAPI.Client.call({"method":"friends.get"}, callback);
}