SDK'nın init edilmesi
init() metodunun Application sınıfının içerisinde çağırılması önerilir. Application sınıfını AndroidManifest.xml dosyasında <application tag ı içerisinde android:name ile tanımlamayı unutmayınız.
init metodu 4 parametre(hepsi zorunlu) almaktadır. SDK yı aşağıdaki gibi init edebilirsiniz.
RelatedDigital.init( context = applicationContext, organizationId = "buraya organization id nizi yazınız", profileId = "buraya profile id nizi yazınız", dataSource = "buraya datasource değerini yazınız" )
Bu bilgilere RMC paneli üzerinden ulaşabilirsiniz.
Kullanılacak Modüllerin Aktifleştirilmesi
RelatedDigital SDK 3 ayrı modülden oluşmaktadır :
Push Notification Modülü (Euromessage)
In-App Notification Modülü (Visilabs)
Geofence Modülü
Kullanmak istediğiniz modülleri aşağıdaki gibi etkinleştirmeniz gerekmektedir.
Modüllerin etkinleştirilmesi işleminin Application sınıfı içerisinde yapılması önerilir. Aşağıda SDK yı init eden ve tüm modülleri etkinleştiren örnek bir Application sınıfı bulunmaktadır
AndroidManifest.xml
<application android:name=".MainApplication"
MainApplication.kt
class MainApplication : Application() { override fun onCreate() { super.onCreate() // RelatedDigital SDK nın init edilmesi RelatedDigital.init( context = applicationContext, organizationId = "organizationIdDeğeri", profileId = "profileIdDeğeri", dataSource = "dataSourceDeğeri") // In-App Notification Modülünün etkinleştirilmesi RelatedDigital.setIsInAppNotificationEnabled( context = applicationContext, isInAppNotificationEnabled = true ) // Push Notification Modülünün Etkinleştirilmesi if(GoogleUtils.checkPlayService(this)) { getFirebaseToken() } else { getHuaweiToken() } // Geofence Modülünün Etkinleştirilmesi RelatedDigital.setIsGeofenceEnabled( context = applicationContext, isGeofenceEnabled = true ) } private fun getFirebaseToken(){ FirebaseMessaging.getInstance().token .addOnCompleteListener(OnCompleteListener { task -> if (!task.isSuccessful) { Log.e("Firebase Token : ", "Getting the token failed!!!") return@OnCompleteListener } val token = task.result // Push Notification Modülünün Etkinleştirilmesi RelatedDigital.setIsPushNotificationEnabled( context = applicationContext, isPushNotificationEnabled = true, googleAppAlias = "googleAppAliasDeğeri", huaweiAppAlias = "huaweiAppAliasDeğeri", token = token ) }) } private fun getHuaweiToken() { object : Thread() { override fun run() { try { val appId = AGConnectOptionsBuilder().build(applicationContext) .getString("client/app_id") val token = HmsInstanceId.getInstance(applicationContext).getToken(appId, "HCM") if (TextUtils.isEmpty(token) || token == null) { Log.e("Huawei Token : ", "Empty token!!!") return } Log.i("Huawei Token", "" + token) // Push Notification Modülünün Etkinleştirilmesi RelatedDigital.setIsPushNotificationEnabled( context = applicationContext, isPushNotificationEnabled = true, googleAppAlias = "googleAppAliasDeğeri", huaweiAppAlias = "huaweiAppAliasDeğeri", token = token ) } catch (e: ApiException) { Log.e("Huawei Token", "Getting the token failed! $e") } } }.start() } }
Push Notification Modülü (Euromessage)
Bu modül mobil bildirim kampanyalarınız içindir. Yukarda belirtildiği gibi etkinleştirilmesi gerekmektedir.
RelatedDigital.setIsPushNotificationsEnabled() metodu 5 zorunlu, 8 opsiyonel parametrede almaktadır.
Zorunlu parametreler:
context: Context
isPushNotificationEnabled: Boolean
googleAppAlias: String
huaweiAppAlias: String
token: String
Opsiyonel Parametreler
notificationSmallIcon: Int
notificationSmallIconDarkMode: Int
isNotificationLargeIcon: Boolean
notificationLargeIcon: Int
notificationLargeIconDarkMode
notificationPushIntent: String
notificationChannelName: String
notificationColor: String
Opsiyonel Parametreler | Açıklama |
---|---|
| Status Bar’da ve bildirim alanının sol üstünde görüntülenecek ikonu girmek içindir. Projenizdeki herhangi bir resource un id sini vermeniz gerekmektedir. |
| Cihaz koyu temadayken görünecek |
| Bildirim alanının sağında bir ikon bulunup bulunmamasına karar vermek içindir. true → bulunur false → bulunmaz |
| Bildirim alanının sağında görünecek büyük ikonu girmek içindir. Projenizdeki herhangi bir resource un id sini vermeniz gerekmektedir. |
| Cihaz koyu temadayken görünecek |
| Bildirime tıklandığında açılacak Activity'e karar vermek içindir. Burda Activity'nin tam yolunun girilmesi gerekmektedir. |
| Bildirim kanalına verilecek ismi girmek içindir. |
| Bildirim alanında kullanılacak accent color değerini girmek içindir. |
Tüm parametreleri içeren örnek bir kullanım aşağıdaki gibidir.
RelatedDigital.setIsPushNotificationEnabled( context = applicationContext, isPushNotificationEnabled = true, googleAppAlias = Constants.GOOGLE_APP_ALIAS, huaweiAppAlias = Constants.HUAWEI_APP_ALIAS, token = token, notificationSmallIcon = R.drawable.text_icon, notificationSmallIconDarkMode = R.drawable.text_icon_dark_mode, isNotificationLargeIcon = true, notificationLargeIcon = R.mipmap.ic_launcher, notificationLargeIconDarkMode = R.mipmap.ic_launcher, notificationPushIntent = "com.relateddigital.androidexampleapp.PushNotificationActivity", notificationChannelName = "relateddigital-android-test", notificationColor = "#d1dbbd" )