Guias
SDKs para mobile
Clientes iOS, Android, Flutter e React Native feitos à mão.
Quatro SDKs Tier 1 feitos à mão que compartilham um formato de API idêntico — depois de aprender um, você conhece os outros. Cada um fica em sdks/<platform>/ no monorepo.
iOS — Swift
// Package.swift
.package(url: "https://github.com/singlink/singlink-ios", from: "0.1.0")import AskAIs Customer Service
let client = SingChatClient(baseUrl: URL(string: "https://cs.askais.com")!)
let id = try await client.identify(.init(appId: "ws_abc", email: "ada@example.com"))
try await client.startRealtime { event in
if case .messageNew(let msg) = event { print(msg.content) }
}Android — Kotlin
// build.gradle.kts
implementation("app.singchat:sdk:0.1.0")import app.singchat.sdk.SingChatClient
import app.singchat.sdk.models.IdentifyRequest
val client = SingChatClient("https://cs.askais.com")
client.identify(IdentifyRequest(appId = "ws_abc", email = "ada@example.com"))
client.startRealtime()
client.events.collect { event -> /* ... */ }Flutter — Dart
# pubspec.yaml
dependencies:
singlink_sdk: ^0.1.0import 'package:singlink_sdk/singlink_sdk.dart';
final client = SingChatClient('https://cs.askais.com');
await client.identify(IdentifyRequest(appId: 'ws_abc'));
client.startRealtime();
client.events.listen((e) { /* ... */ });React Native — TypeScript
npm install @singlink/react-nativeimport { useAskAIs Customer Service } from "@singlink/react-native";
const { client, identity, lastEvent } = useAskAIs Customer Service({
baseUrl: "https://cs.askais.com",
identify: { appId: "ws_abc", email: user.email },
});Design compartilhado
- Um
SingChatClientpor aplicativo (ou um por workspace se houver multitenância no mesmo binário) identify()retorna JWT, contato e URL do WS- O WebSocket reconecta automaticamente com backoff exponencial, ping de 25 s
- Os eventos aparecem como enum tipado / sealed class — não é necessário comparar strings
- Os erros são tipados (
SingChatError/SingChatException)
Roadmap (componentes de UI móvel)
Os SDKs atuais são apenas lógica — traga sua própria UI de chat. Uma visualização de chat pré-construída em SwiftUI, Jetpack Compose, widgets Flutter e componentes React Native está no roadmap.