ガイド
モバイル SDK
手作りの iOS、Android、Flutter、React Native クライアント。
API の形が完全に同一の、手作りされた 4 つの Tier 1 SDK——1 つ学べば、ほかも分かります。それぞれ monorepo の sdks/<platform>/ にあります。
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 },
});共通の設計
- アプリごとに 1 つの
SingChatClient(同一バイナリ内でマルチテナントの場合はワークスペースごとに 1 つ) identify()は JWT、コンタクト、WS URL を返します- WebSocket は指数バックオフで自動再接続し、25 s ごとに ping します
- イベントは型付き enum / sealed class として現れます——文字列マッチングは不要です
- エラーは型付きです(
SingChatError/SingChatException)
ロードマップ(モバイル UI コンポーネント)
現在の SDK はロジックのみです——チャット UI はご自身で用意してください。SwiftUI、Jetpack Compose、Flutter ウィジェット、React Native コンポーネントによるビルド済みチャットビューはロードマップにあります。