Mobiili-SDK-d

Mobiili-SDK-d on veebividina vaste sinu enda rakendustele: sinu kliendid saavad rakendusesisese toe koos täieliku vestlusajaloo ja tõuketeavitustega ning sinu agendid näevad neid vestlusi samas postkastis. Need ei ole sinu meeskonna agendirakendused; need on eraldi tootesari.

Platvormid

Platvorm	Keel ja käituskeskkond	Levitamine	Olek
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	arendamisel
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	arendamisel
React Native	ümbritseb natiivseid SDK-sid	npm	kavas (beeta)
Flutter	ümbritseb natiivseid SDK-sid	pub.dev	kavas (beeta)

Natiivsed SDK-d on autoriteetsed; ümbrised ilmuvad pärast neid. Kella- või telerirakendused ja lauaarvuti SDK-d ei kuulu ulatusse; lauaarvutis kasuta veebividinat.

Mida SDK sisaldab

Tekstisõnumid, manused, häälsõnumid, pildid ja video, anonüümsed ja tuvastatud seansid, teemad, kohandatud avatar ja bränding, 40 keelt, AI concierge, vestlusajalugu, lugemata märgised, tõuketeavitused, sügavlingid, klõpsuga helistamine telefoni valijaga, võrguühenduseta järjekord koos taustsünkroonimisega, biomeetriline avamine vestluse jaoks, VoiceOveri ja TalkBacki tugi, tume režiim. Kompileeritud suuruse eesmärk: kuni 5 MB platvormi kohta.

Rakendusesisesed WebRTC-kõned ja kliendi ekraanijagamine tulevad hilisemas väljalaskes. Kaassirvimine töötab ainult veebis: mobiilsed operatsioonisüsteemid ei luba kolmanda osapoole SDK-l ekraani jälgida ega juhtida.

SDK liides

Initsialiseeri üks kord, rakenduse elutsükli alguses:

// 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)

Tuvasta kasutaja pärast tema sisselogimist ja logi ta välja, kui ta välja logib:

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

Kuva liides:

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

Tagasikutsed: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Avalik API on iOS-is põhilõime suhtes ohutu ja Androidis taustlõime suhtes ohutu; ühendused katkevad, kui rakendus läheb taustale, ja taastuvad esiplaanile tulekul.

Seansid ja identiteet

• Anonüümne: võtmehoidjas või krüpteeritud eelistustes salvestatud seadme seansi ID püsib rakenduse uuendustest hoolimata ja on seotud seadme, mitte kasutajaga. See kustutatakse pärast 90 päeva tegevusetust.
• Tuvastatud: pärast identify väljakutset tõstetakse seanss kõrgemale tasemele ja ühendatakse samas seadmes oleva anonüümse ajalooga, kui see on üheselt mõistetav. Kanalitevaheline identiteedi tuvastamine järgib identiteedigraafi reegleid ja nõusolekut.
• Usaldusväärne tuvastamine: sinu taustsüsteem allkirjastab tokeni kasutaja väidetega; SDK edastab selle ja RolChat kontrollib allkirja enne seansi tõstmist. Allkirjastamata identify töötab, kuid on madalama usaldusväärsusega.

Rakenduses olev avalik API-võti on ülesehituselt ohutu: see on piiratud saidiga ja selle kasutus on piiratud.

Tõuketeavitused

Platvorm	Transport	Sina annad
iOS	APNs	APNs-i autentimisvõti RolChati töölaual
Android	FCM	FCM-i teenusekonto JSON

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

Teavituse tekst lokaliseeritakse serveris kasutaja lokaadile. Rikkalikud teavitused toetavad avatari, teavitusest vastamist ja loetuks märkimist. SDK ei küsi kunagi ise tõuketeavituste luba; kutsu välja requestPushPermission(), kui see sobib sinu alustamisvooga. Loobumine käib käsuga setPushEnabled(false) või operatsioonisüsteemi seadetest; mõlemad salvestatakse.

Versioonimine ja tugi

Range semantiline versioonimine. Korraga toetatakse kahte põhiversiooni ning pärast põhiversiooni väljalaset on üleminekuks aega aasta. Väiksemad väljalasked ilmuvad kord kuus; turvaparandused ilmuvad kohe; põhiversioonidest teatatakse kolm kuud ette. Aegunuks märgitud või toetamata SDK logib käivitamisel hoiatuse ja töölaud näitab seda jaotises Integratsioonid.

Privaatsus

Jälgimist pole rohkem, kui sa ise lubad, nõusolekuliidesed kasutavad platvormi natiivseid mustreid ning GDPR-, CCPA- ja LGPD-andmesubjekti taotlused hõlmavad SDK seansse nagu mis tahes muud kanalit. Manused tihendatakse seadmes, laaditakse üles allkirjastatud URL-idele ja kontrollitakse viiruste suhtes enne, kui agendid neid näevad.