Android SDK

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://center.abrova.ir/api/packages/abrova/maven") }
    }
}

dependencies {
    implementation("ir.abrova:abrova-push-android:0.1.15")
}

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

import android.app.Application
import ir.abrova.push.sdk.AbrovaPush
import ir.abrova.push.sdk.AbrovaPushConfig

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        val config = AbrovaPushConfig(
            apiKey = "ab_live_your_api_key"
        )
        AbrovaPush.init(this, config)
    }
}

<application
    android:name=".MyApplication"
    ...>

import android.os.Build
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import ir.abrova.push.sdk.AbrovaPush
import ir.abrova.push.sdk.AbrovaPushCallbackAdapter
import ir.abrova.push.sdk.AbrovaPushMessage

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Request notification permission on Android 13+
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            requestPermissions(arrayOf(android.Manifest.permission.POST_NOTIFICATIONS), 1)
        }

        // Listen for messages and connection events
        AbrovaPush.setCallback(object : AbrovaPushCallbackAdapter() {
            override fun onMessageReceived(message: AbrovaPushMessage) {
                // New push notification arrived
            }

            override fun onConnectionStateChanged(connected: Boolean) {
                // Real-time connection state changed
            }

            override fun onRegistered(deviceId: String) {
                // Device registered with the Abrova backend
            }

            override fun onError(error: String) {
                // Connection or registration error
            }
        })

        // Register on every launch: it keeps the device's token, app version
        // and last-seen time current on the server
        AbrovaPush.register(
            userId = "user_123",
            metadata = mapOf(
                "tier" to "premium",
                "language" to "en"
            )
        )
    }
}

val initialMessage = AbrovaPush.getInitialMessage()
if (initialMessage != null) {
    // Navigate based on initialMessage.deepLink or message data
    AbrovaPush.clearInitialMessage()
}

// Set user ID after login
AbrovaPush.setUserId("user_123")

// Clear user ID after logout — also detaches the user on the server,
// so this device stops receiving the previous user's notifications
AbrovaPush.clearUserId()

AbrovaPush.subscribeTopic("news")
AbrovaPush.subscribeTopic("sports")

// Later, when the user opts out
AbrovaPush.unsubscribeTopic("news")

import ir.abrova.push.sdk.inapp.InAppMessage
import ir.abrova.push.sdk.inapp.InAppButton
import ir.abrova.push.sdk.inapp.InAppMessageCallback

// Built-in UI: in your Activity's onResume()
AbrovaPush.setCurrentActivity(this)

// Optional, only to render messages yourself (disables the built-in UI)
AbrovaPush.setInAppMessageCallback(object : InAppMessageCallback {
    override fun onMessageReady(message: InAppMessage) {
        // Render the message with your own UI
    }

    override fun onButtonClicked(message: InAppMessage, button: InAppButton) {
        // Built-in UI only
    }

    override fun onMessageDismissed(message: InAppMessage) {
        // Built-in UI only
    }

    override fun onError(error: String) {
        // Failed to fetch or display a message
    }
})

// Trigger on app open
AbrovaPush.triggerInAppOnAppOpen()

// Trigger on custom event
AbrovaPush.triggerInAppEvent("viewed_product")

import ir.abrova.push.sdk.inbox.InboxFilter
import ir.abrova.push.sdk.inbox.InboxCallback
import ir.abrova.push.sdk.inbox.InboxMessage
import ir.abrova.push.sdk.inbox.InboxMessageStatus

// Fetch inbox messages
AbrovaPush.getInboxMessages(
    filter = InboxFilter(limit = 50),
    onSuccess = { response ->
        val messages = response.messages
        val unread = response.unreadCount
    },
    onError = { error -> /* handle */ }
)

// Listen for real-time inbox updates
AbrovaPush.getInboxManager().setCallback(object : InboxCallback {
    override fun onMessageReceived(message: InboxMessage) {
        // New inbox message arrived
    }

    override fun onMessageStatusChanged(messageId: String, status: InboxMessageStatus) {
        // Read / unread / archived state changed
    }
})

// Unread count for badges
val count = AbrovaPush.getInboxManager().getUnreadCount()

val config = AbrovaPushConfig(
    apiKey = "ab_live_your_api_key",
    notificationIcon = "ic_notification",
    showServiceNotification = true,
    showNotificationInForeground = true,
    autoRefresh = true
)

dependencies {
    implementation("ir.abrova:abrova-push-android:0.1.15")
    implementation("ir.abrova:abrova-push-voip:0.1.0")  // Optional
}

import ir.abrova.push.voip.AbrovaPushVoip
import ir.abrova.push.voip.VoipConfig
import ir.abrova.push.voip.VoipCallback
import ir.abrova.push.voip.CallData

AbrovaPushVoip.initialize(this, VoipConfig(appName = "MyApp"))

AbrovaPushVoip.setCallback(object : VoipCallback {
    override fun onCallAccepted(callData: CallData) {
        // Connect to your calling service (Jitsi, WebRTC, etc.)
    }

    override fun onCallDeclined(callData: CallData) { }
    override fun onCallTimeout(callData: CallData) { }
})