Android SDK'da abonelik durumunu kontrol etme

Adapty ile abonelik durumunu takip etmek çok kolaydır. Ürün kimliklerini kodunuza manuel olarak eklemenize gerek yoktur. Bunun yerine, aktif bir access level olup olmadığını kontrol ederek kullanıcının abonelik durumunu zahmetsizce doğrulayabilirsiniz.

Abonelik durumunu kontrol etmeye başlamadan önce Gerçek Zamanlı Geliştirici Bildirimleri (RTDN) kurulumunu yapın.

Access level ve AdaptyProfile nesnesi

Access level’lar, AdaptyProfile nesnesinin özellikleridir. Profili uygulamanız başladığında, örneğin bir kullanıcı tanımladığınızda alıp değişiklikler gerçekleştiğinde güncellemenizi öneririz. Bu sayede profil nesnesini tekrar tekrar istek göndermeden kullanabilirsiniz.

Profil güncellemelerinden haberdar olmak için, aşağıdaki Profil güncellemelerini dinleme, access level dahil bölümünde açıklandığı gibi profil değişikliklerini dinleyin.

Sunucudan access level alma

Sunucudan access level almak için .getProfile() metodunu kullanın:

Adapty.getProfile { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
            // check the access
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getProfile(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        // check the access

    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Yanıt parametreleri:

.getProfile() metodu, kullanıcı profilini size sağlar ve bu profilden access level durumunu öğrenebilirsiniz. Uygulama başına birden fazla access level tanımlayabilirsiniz. Örneğin, bir gazete uygulamanız varsa ve farklı konulara bağımsız abonelikler satıyorsanız “sports” ve “science” gibi access level’lar oluşturabilirsiniz. Ancak çoğu durumda yalnızca bir access level’a ihtiyaç duyarsınız; bu durumda varsayılan “premium” access level’ı kullanabilirsiniz.

Varsayılan “premium” access level’ını kontrol etmeye yönelik bir örnek:

Adapty.getProfile { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value

            if (profile.accessLevels["premium"]?.isActive == true) {
                // grant access to premium features
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getProfile(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        
        AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("premium");
        
        if (premium != null && premium.isActive()) {
            // grant access to premium features
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Abonelik durumu güncellemelerini dinleme

Kullanıcının aboneliği her değiştiğinde Adapty bir olay tetikler.

Adapty’den mesaj alabilmek için bazı ek yapılandırmalar yapmanız gerekir:

Adapty.setOnProfileUpdatedListener { profile ->
    // handle any changes to subscription state
}

Adapty.setOnProfileUpdatedListener(profile -> {
    // handle any changes to subscription state
});

Adapty, uygulamanın başlangıcında da bir olay tetikler. Bu durumda önbellekteki abonelik durumu iletilir.

Abonelik durumu önbelleği

Adapty SDK’da uygulanan önbellek, profilin abonelik durumunu saklar. Bu sayede sunucu kullanılamaz olsa bile, profil abonelik durumuna ilişkin bilgilere önbellekteki verilerden erişilebilir.

Ancak önbellekten doğrudan veri talep etmenin mümkün olmadığını belirtmek gerekir. SDK, profille ilgili güncellemeleri ve değişiklikleri kontrol etmek için sunucuyu periyodik olarak her dakika sorgular. Yeni işlemler veya başka güncellemeler gibi değişiklikler olduğunda, bunlar önbellekteki veriyle sunucuyla senkronize kalması için önbelleğe gönderilir.