Mobilie SDK

Mobilie SDK ir tīmekļa logrīka ekvivalents jūsu pašu lietotnēm: jūsu klienti saņem atbalstu lietotnē ar pilnu sarunu vēsturi un push paziņojumiem, un jūsu aģenti redz šīs sarunas tajā pašā iesūtnē. Tās nav aģentu lietotnes jūsu komandai; tās ir atsevišķa produktu līnija.

Platformas

Platforma	Valoda un izpildvide	Izplatīšana	Statuss
iOS	Swift 5.9+, iOS 15+	Swift Package Manager, CocoaPods	izstrādē
Android	Kotlin 1.9+, Android 8.0 (API 26)+	Maven Central	izstrādē
React Native	apvalks ap natīvajiem SDK	npm	plānots (beta)
Flutter	apvalks ap natīvajiem SDK	pub.dev	plānots (beta)

Natīvie SDK ir noteicošie; apvalki tiek izlaisti pēc tiem. Pulksteņu vai TV lietotnes un datora SDK neietilpst tvērumā; datoram izmantojiet tīmekļa logrīku.

Ko ietver SDK

Teksta ziņojumi, pielikumi, balss ziņojumi, attēli un video, anonīmas un identificētas sesijas, motīvi, pielāgots avatars un zīmols, 40 valodas, AI konsjeržs, sarunu vēsture, nelasīto nozīmītes, push paziņojumi, dziļās saites, zvanīšana ar klikšķi caur tālruņa numura sastādītāju, bezsaistes rinda ar fona sinhronizāciju, biometriska čata atbloķēšana, VoiceOver un TalkBack atbalsts, tumšais režīms. Mērķa kompilētais izmērs: 5 MB vai mazāk katrai platformai.

WebRTC zvani lietotnē un klienta ekrāna kopīgošana būs pieejami vēlākā laidienā. Kopīga pārlūkošana darbojas tikai tīmeklī: mobilās operētājsistēmas neļauj trešās puses SDK novērot vai vadīt ekrānu.

SDK saskarne

Inicializējiet vienreiz, agri lietotnes dzīves ciklā:

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

Identificējiet lietotāju pēc tam, kad viņš piesakās, un izrakstiet, kad viņš izrakstās:

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

Parādiet saskarni:

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

Atzvani: rolChatDidOpen, rolChatDidClose, rolChatDidReceiveMessage(_:), rolChatDidFailToSend(_:). Publiskais API ir drošs galvenajā pavedienā iOS un fona pavedienos Android; savienojumi pārtrūkst, kad lietotne pāriet fonā, un atjaunojas, kad tā atgriežas priekšplānā.

Sesijas un identitāte

• Anonīma: ierīces sesijas ID, kas glabāts atslēgu saišķī vai šifrētās preferencēs, saglabājas pēc lietotnes atjauninājumiem un ir piesaistīts ierīcei, nevis lietotājam. Tas tiek dzēsts pēc 90 dienu neaktivitātes.
• Identificēta: pēc identify sesija tiek paaugstināta un apvienota ar anonīmo vēsturi tajā pašā ierīcē, ja tas ir viennozīmīgi. Identitātes noteikšana starp kanāliem ievēro identitātes grafa noteikumus un piekrišanu.
• Uzticama identificēšana: jūsu serveris paraksta marķieri ar lietotāja apgalvojumiem; SDK to nodod, un RolChat pārbauda parakstu, pirms paaugstina sesiju. Neparakstīts identify darbojas, bet ar zemāku uzticamību.

Publiskā API atslēga lietotnē ir droša pēc būtības: tās tvērums ir ierobežots ar vietni, un tai ir ātruma ierobežojums.

Push paziņojumi

Platforma	Transports	Jūs nodrošināt
iOS	APNs	APNs autentifikācijas atslēgu RolChat informācijas panelī
Android	FCM	FCM servisa konta JSON

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

Paziņojumu teksts serverī tiek lokalizēts lietotāja lokalizācijā. Paplašinātie paziņojumi atbalsta avataru, atbildi no paziņojuma un atzīmēšanu kā izlasītu. SDK nekad pats neprasa push atļauju; izsauciet requestPushPermission(), kad tas atbilst jūsu ievadapmācībai. Atteikšanās notiek ar setPushEnabled(false) vai OS iestatījumos; abi tiek reģistrēti.

Versijas un atbalsts

Stingra semantiskā versiju numurēšana. Vienlaikus tiek atbalstītas divas galvenās versijas, un pēc galvenās versijas izlaišanas migrācijai ir gads. Mazās versijas tiek izlaistas katru mēnesi; drošības labojumi tiek izlaisti nekavējoties; galvenās versijas tiek paziņotas trīs mēnešus iepriekš. Novecojis vai neatbalstīts SDK palaišanas brīdī reģistrē brīdinājumu, un informācijas panelis to rāda sadaļā Integrācijas.

Privātums

Nekādas izsekošanas ārpus tā, ko ieslēdzat jūs, piekrišanas saskarnes izmanto platformas natīvos modeļus, un GDPR, CCPA un LGPD datu subjektu pieprasījumi aptver SDK sesijas tāpat kā jebkuru citu kanālu. Pielikumi tiek saspiesti ierīcē, augšupielādēti uz parakstītiem URL un pārbaudīti pret vīrusiem, pirms aģenti tos redz.