В Android-приложении ОК есть возможность создания иконки игры на рабочем столе его устройства для более простого и быстрого доступа к вашей игре.

Иконка может создаваться различным способами:

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

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

Для реализации этой возможности необходимо использовать метод OKApp.suggestDesktopIcon().

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

/*
* Предложить пользователю создать иконку приложения на рабочем столе через OKAndroidSDK
*/
function suggestDesktopIcon() {
    if (OKApp && OKApp.suggestDesktopIcon) {
        OKApp.suggestDesktopIcon();
    }
}

Обратите внимание, что это void-метод, который не возвращает никакого результата и не требует передачи callback-функции.

Условия показа меню создания иконки

Для того, чтобы меню создания иконки успешно показалось, учтите, что:

• пользователь не должен был в текущей игровой сессии вызывать это меню каким-либо из доступных способов;
• пользователь ранее не создавал иконку вашей игры на рабочем столе через наше приложение.

Если оба условию соблюдены, то при вызове метода будет показано меню, в котором пользователь может создать иконку. В ином случае меню показано не будет. При повторном вызове метода меню показано также не будет.