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

Метод для приглашения пользователя-друга в игру с помощью виджета приглашения/рекомендации.

Приглашение можно отослать только пользователям, которые:

• являются друзьями отправителя;
• разрешили прием приглашений в игры в настройках профиля;
• еще не играют в приглашаемую игру.

OKSDK.Widgets.invite(returnUrl, options)

Где:

• returnUrl - URL, на который будет отправлен пользователь при закрытии окна с виджетом. Необязательный параметр;
• options - дополнительные параметры виджета:
  • autosel - количество автоматически выбираемых друзей;
  • comment - текст приглашения по умолчанию;
  • custom_args - дополнительные параметры, которые будут переданы в оповещение, а далее в игру в неизменном виде;
  • popup - выполнять ли автоматическое центрирование и подгонку размеров окна;
  • nohead - отображать ли вверху виджета шапку Одноклассников;
  • state - дополнительные параметры, которые в неизмененном виде вернуться в скрипт-обработчик;
  • target - список пользователей, которых следует выбрать по умолчанию в общем списке;
  • target_only - показывать ли только друзей, переданных в параметре target;

Полное описание дополнительных параметров доступно здесь - виджет приглашения/рекомендации

Return URL message

Если при вызове виджета был указан параметр returnUrl, то после выхода пользователя из окна виджета (успешная отправка приглашения, отмена отправки, ошибка), он будет перенаправлен на указанный URL с передачей в URL дополнительных параметров.

Список параметров следующий:

• code - код результата
  • OK - приглашение отправлено успешно;
  • CANCELLED - отправка приглашения отменена пользователем;
  • PARAM_SIGNATURE и др. коды - произошла ошибка отправки. В таком случае смотрите описание ошибки на странице обработка ошибок
• selected - список ID пользователей, которым было отослано приглашение;
• result - объект с результатом работы виджета. Содержит в себе все остальные служебные параметры из URL;
• error_code - код ошибки;
• error_msg - описание ошибки;
• sig - подпись запроса для валидации.

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

Пример при отмене отправки

Пример при ошибке отправки

Window postMessage

Если при вызове виджета не был указан параметр returnUrl, то после выхода пользователя из окна виджета (успешная отправка приглашения, отмена отправки, ошибка) в родительское окно будет отправлен postMessage с информацией о результате работы виджета.

Параметры сообщения (message.data) аналогичны тем, что передаются в параметре result при указании return URL.

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

{
    "code": "OK",
    "selected": "[1234567890]"
}

Пример при отмене отправки

{
    "error_code": "12",
    "code": "CANCELLED",
    "error_msg": "Operation was cancelled by user",
    "message": "Operation was cancelled by user"
}

Пример при ошибке отправки

{
    "error_code": "104",
    "code": "PARAM_SIGNATURE",
    "error_msg": "Bad signature ",
    "message": "Bad signature "
}

Таким образом, можно задать eventListener, который будет каким-то образом обрабатывать это сообщение:

    window.addEventListener('message', function (widgetMessage) {
        console.log(JSON.stringify(widgetMessage.data));
        // обрабатываете сообщение от виджета здесь
    }, false);
    

Пример вызова

OKSDK.Widgets.invite(
    null,
    {
        "autosel": 3,
        "nohead": false,
        "popup": true
    }
)

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