Mobil SDK-lar

Mobil SDK-lar veb vidcetin öz tətbiqləriniz üçün ekvivalentidir: müştəriləriniz tam söhbət tarixçəsi və push bildirişləri ilə tətbiqdaxili dəstək alır, operatorlarınız isə bu söhbətləri eyni Gələnlər qutusunda görür. Onlar komandanız üçün operator tətbiqləri deyil; onlar ayrıca məhsul xəttidir.

Platformalar

Platforma	Dil və runtime	Yayım	Status
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	hazırlanır
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	hazırlanır
React Native	native SDK-ları əhatə edir	npm	planlaşdırılıb (beta)
Flutter	native SDK-ları əhatə edir	pub.dev	planlaşdırılıb (beta)

Native SDK-lar əsasdır; wrapper-lər onlardan sonra buraxılır. Saat və ya TV tətbiqləri və masaüstü SDK-lar əhatə dairəsindən kənardır; masaüstü üçün veb vidcetdən istifadə edin.

SDK nələri ehtiva edir

Mətn mesajları, qoşmalar, səsli mesajlar, şəkillər və video, anonim və tanınmış sessiyalar, mövzular, fərdi avatar və brendinq, 40 dil, AI konsyerj, söhbət tarixçəsi, oxunmamış nişanları, push bildirişləri, deep link-lər, telefonun yığıcısı vasitəsilə kliklə zəng, fon sinxronizasiyası ilə oflayn növbə, çat üçün biometrik kilid açma, VoiceOver və TalkBack dəstəyi, qaranlıq rejim. Kompilyasiyadan sonra hədəf ölçü: hər platforma üçün 5 MB və ya daha az.

Tətbiqdaxili WebRTC zəngləri və müştəri tərəfindən ekran paylaşımı sonrakı buraxılışda gələcək. Birgə baxış yalnız veb üçündür: mobil əməliyyat sistemləri üçüncü tərəf SDK-sının ekranı izləməsinə və ya idarə etməsinə icazə vermir.

SDK interfeysi

Tətbiqin həyat dövrünün əvvəlində bir dəfə inisializasiya edin:

// iOS
let config = RolChatConfig(
  siteId: "site_abc123",
  apiKey: "pk_live_…",      // public key - safe to ship in the app
  region: .eu,              // eu / us
  theme: RolChatTheme(primaryColor: .blue)
)
RolChat.shared.initialize(config: config)

// Android
val config = RolChatConfig.Builder()
  .siteId("site_abc123")
  .apiKey("pk_live_…")
  .region(Region.EU)
  .theme(RolChatTheme(primaryColor = Color.Blue))
  .build()
RolChat.initialize(context, config)

İstifadəçini daxil olduqdan sonra tanıdın və o çıxanda sessiyadan çıxın:

RolChat.shared.identify(userId: "user_12345", email: "alice@example.com", name: "Alice",
                        metadata: ["tier": "gold"])
RolChat.shared.logout()   // on host-app sign-out, or the next user sees this history

İnterfeysi göstərin:

RolChat.shared.openChat()                      // modal
RolChat.shared.openChat(conversationId: id)    // a specific conversation
RolChat.shared.openChatInline(view)            // inside your own layout
RolChat.shared.close()

Callback-lər: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Açıq API iOS-da əsas axın üçün, Android-də isə fon axınları üçün təhlükəsizdir; tətbiq fona keçəndə bağlantılar kəsilir və ön plana qayıdanda bərpa olunur.

Sessiyalar və kimlik

• Anonim: keychain-də və ya şifrələnmiş parametrlərdə saxlanılan cihaz sessiyası ID-si tətbiq yeniləmələrindən sonra da qalır və istifadəçiyə deyil, cihaza bağlıdır. 90 gün fəaliyyətsizlikdən sonra silinir.
• Tanınmış: identify-dan sonra sessiya yüksəldilir və birmənalı olduqda eyni cihazdakı anonim tarixçə ilə birləşdirilir. Kanallararası kimlik müəyyənləşdirilməsi kimlik qrafı qaydalarına və razılığa əməl edir.
• Etibarlı tanınma: backend-iniz istifadəçinin claim-ləri ilə tokeni imzalayır; SDK onu ötürür və RolChat sessiyanı yüksəltməzdən əvvəl imzanı yoxlayır. İmzasız identify işləyir, lakin etibarlılığı aşağıdır.

Tətbiqdəki açıq API açarı dizayn etibarilə təhlükəsizdir: o, sayt ilə məhdudlaşdırılıb və sorğu limitinə tabedir.

Push bildirişləri

Platforma	Nəqliyyat	Siz təqdim edirsiniz
iOS	APNs	RolChat panelində APNs autentifikasiya açarı
Android	FCM	FCM xidmət hesabının JSON faylı

RolChat.shared.setPushToken(deviceToken, type: .apns)
if RolChat.shared.handleNotification(userInfo) { return }   // consumed: a chat message

Bildiriş mətni serverdə istifadəçinin dilinə lokallaşdırılır. Zəngin bildirişlər avatarı, bildirişdən cavab verməyi və oxunmuş kimi işarələməni dəstəkləyir. SDK heç vaxt öz-özünə push icazəsi istəmir; requestPushPermission() funksiyasını tətbiqinizin başlanğıc axınına uyğun gələn anda çağırın. İmtina setPushEnabled(false) və ya əməliyyat sistemi parametrləri ilə edilir; hər ikisi qeydə alınır.

Versiyalaşdırma və dəstək

Ciddi semantik versiyalaşdırma. Eyni vaxtda iki əsas versiya dəstəklənir və əsas buraxılışdan sonra keçid üçün bir il verilir. Kiçik buraxılışlar aylıq olur; təhlükəsizlik düzəlişləri dərhal buraxılır; əsas buraxılışlar üç ay əvvəldən elan edilir. Köhnəlmiş və ya dəstəklənməyən SDK işə düşərkən xəbərdarlıq loglayır və panel bunu İnteqrasiyalar bölməsində göstərir.

Məxfilik

Sizin aktivləşdirdiklərinizdən kənar heç bir izləmə yoxdur, razılıq ekranları platformanın doğma nümunələrindən istifadə edir və GDPR, CCPA və LGPD üzrə məlumat subyektlərinin sorğuları SDK sessiyalarını da digər kanallar kimi əhatə edir. Qoşmalar cihazda sıxılır, imzalı URL-lərə yüklənir və operatorlar görməzdən əvvəl viruslara qarşı yoxlanılır.