Документация Android Studio

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. →