Android Studio: Kotlin/Java и WebView
Используйте нативный Android SDK в обычных проектах Android Studio или собственной JavaScript-игре в WebView. Construct и Capacitor не нужны.
1. Скачайте исходники Android SDK
В архиве — Java-классы SDK, доступные из Kotlin, примеры Activity/Application/FCM, мост WebView, иконка уведомлений и полный README. Это исходники SDK, а не готовые AAR или APK.
Скачать SDK для Android StudioСкопируйте src/ru/gamesdk/dkpush в app/src/main/java/ru/gamesdk/dkpush, а иконку — в app/src/main/res/drawable. Нативным приложениям DKPushWebViewBridge.java не нужен; AndroidX WebKit требуется только для игр в WebView.
Создайте Android-проект в DK Push, получите Project ID и полный SDK / Client key с правами devices:write и events:write. Не помещайте серверные ключи и service-account реквизиты Firebase в APK.
<!-- Add to app/src/main/res/values/strings.xml -->
<string name="dk_project_id" translatable="false">YOUR_PROJECT_ID</string>
<string name="dk_sdk_key" translatable="false">YOUR_FULL_SDK_CLIENT_KEY</string>2. Подключите Firebase, сохранив существующие интеграции
Зарегистрируйте точный applicationId в Firebase и поместите google-services.json в app/google-services.json. В DK Push настройте FCM-провайдер того же Firebase-проекта. Если Firebase уже настроен, сохраните совместимые зависимости и Google services plugin.
Для нового проекта используйте инструкцию Firebase Android ниже. Полный README содержит примеры Gradle и manifest. Сохраните compileSdk/targetSdk, авторизацию, платежи, launcher и другие SDK. Современные версии Firebase могут требовать более новую Android, чем сам код DK Push.
Официальная инструкция Firebase Android →Создайте один клиент DKPush в существующем Application. Передайте начальный токен FirebaseMessaging и обновления onNewToken в registerPushToken. Добавьте вызовы в существующий FirebaseMessagingService вместо второго конкурирующего сервиса.
dkPush = new DKPush(this,
getString(R.string.dk_project_id), getString(R.string.dk_sdk_key));
dkPush.initialize(); // No permission prompt.
FirebaseMessaging.getInstance().getToken()
.addOnSuccessListener(dkPush::registerPushToken);3. Жизненный цикл Activity и разрешение уведомлений
Объедините пример GameActivity со своей Activity. Вызывайте sdk.onResume(this) и sdk.onPause(this), передавайте данные запуска/onNewIntent в handleNotificationIntent и результат onRequestPermissionsResult. Сохраните существующие обработчики.
// Your own Enable notifications button:
dkPush.requestNotificationPermission();
// Forward from Activity.onRequestPermissionsResult:
dkPush.onRequestPermissionsResult(requestCode);
// Forward launch Intent and onNewIntent:
dkPush.handleNotificationIntent(intent);Системный запрос используется на Android 13+. Зарезервируйте request code 46123 для DK Push. Initialize не запрашивает разрешение автоматически. На старых Android такого runtime-запроса нет; отключённые уведомления остаются отключёнными до изменения настроек пользователем.
4. Вызовы игры на Kotlin и Java
// Kotlin: your level result, after ads and transitions.
dkPush.showMessage("level_complete", level.toString(), 500)
// Ask for feedback at a separate event.
dkPush.showSurvey("level_complete", level.toString(), 500)
val unsubscribe = dkPush.addListener { event, data ->
if (event == "messageAction" && data.optString("action") == "open_store") {
openYourShopScreen()
}
if (event == "ratingSubmitted") {
val rating = data.optInt("rating") // 1–5
}
}
// Call unsubscribe.run() when this listener is no longer needed.В Java тот же API: передавайте String.valueOf(level). Триггеры — manual, session_start и level_complete; Level ID — число, преобразованное в строку, включая 0. Announcement / Store Offer / Rating определяется настройками кампании.
Нативные Android-диалоги поддерживают сообщения и вопросы опроса с выбором, оценкой и текстом. Контент и оформление берутся из кампании; пиксельное совпадение с Web/Construct не обещается. Решение о паузе управления, музыки и таймеров принимает игра.
Delay — 0–10000 миллисекунд, обычно 500. SDK ждёт активную Activity и свободное окно до 30 секунд. На время рекламы и переходов ставьте флаг занятости и обязательно снимайте его. Вызовы асинхронные; необязательный Result callback различает показ, отсутствие контента и ошибку.
dkPush.setGameBusy(true);
// Run your ad or transition; clear in its completion/finally path:
dkPush.setGameBusy(false);5. JavaScript-игра в обычном WebView
Также скопируйте assets/dk-push-android.js в app/src/main/assets. Пример WebGameActivity загружает игру через WebViewAssetLoader по адресу https://appassets.androidplatform.net/assets/index.html и подключает DKPushWebViewBridge перед loadUrl.
Мост использует точный HTTPS origin и принимает сообщения только основного фрейма. Нет wildcard, addJavascriptInterface и произвольного доступа к HTTP. Объедините пример с существующим WebViewClient, сохранив навигацию и рекламные интеграции игры.
<script src="/assets/dk-push-android.js"></script>
<script>
void DKPushAndroid.initialize().catch(() => {});
async function enableNotifications() {
try { return await DKPushAndroid.requestNotificationPermission(); }
catch { return false; }
}
async function levelCompleted(level) {
try { return await DKPushAndroid.showMessage('level_complete', level, 500); }
catch { return false; }
}
DKPushAndroid.on('messageAction', ({ action }) => {
if (action === 'open_store') openYourShopScreen();
});
</script>Для обратной связи используйте showSurvey, а для состояния устройства, разрешения и окон — await getState(). В отличие от обёртки Capacitor, здесь состояние возвращается асинхронно. Таймаут JS-ответа не отменяет нативный запрос или системный диалог разрешения.
6. Проверьте настоящую Android-сборку
Соберите Debug APK в Android Studio. На устройстве проверьте синхронизацию токена, вручную отправьте Test Push, затем проверьте foreground/фон, нажатие/холодный запуск, отказ в разрешении, пересоздание Activity, сообщения и отправку опросов. Компиляция SDK и тесты моста не подтверждают доставку на телефоне.
HTTP 401 — неверный ключ, 402 — истёкший доступ, 403 — недостаточные права или неверный проект. Принятие FCM не является подтверждением доставки. Сохраняйте работу игры при недоступном API и не выводите ключи и FCM-токены в логи.
Используете Capacitor? Откройте отдельную инструкцию SDK. →