开发者教程

从正确的路径开始, 再逐步深入。

可运行的目标导向指南正在路上。在它们落地之前,下面每条路径都指向对应仓库的 README,从那里开始。

从这里开始

选择匹配你构建阶段的路径。

进入这套栈的三条路径。每张卡片链向该路径所属的仓库 — 完整的图文指南将落在本页。

01

构建你的第一个实时聊天

连接 TypeScript 客户端、鉴权、订阅 Channel,并收到第一条推送。

查看仓库
02

选择合适的 SDK

Web 与桌面用 TypeScript,移动端用 Kotlin,内核或原生集成用 Rust。

查看仓库
03

在本地跑起服务端

构建 Rust 服务端、配置环境、执行迁移,并通过 WebSocket 连接客户端。

查看仓库

开发者体验

连接、鉴权、订阅 — 核心流程就这三步。

下方代码展示真实的 API 形状:连接、鉴权、订阅。完整构建请从各仓库 README 开始。

TypeScript API 概览
$ # npm package coming soon — build from source: github.com/privchat/privchat-sdk-typescript

import { PrivchatClient } from "@privchat/sdk";

const client = new PrivchatClient({
  url: "wss://im.example.com:9080/",
});

await client.connect();
await client.authenticate(userId, accessToken, deviceId);

await client.subscribeChannel("900710001", 1);
client.onPushMessage((message) => {
  console.log("new message", message.server_message_id);
});

深入阅读

学架构,而不只是 API 表面。

协议文档用真实业务模块的例子讲解 Channel、transfer RPC、重连、本地缓存与服务端权威同步。

多传输通道

QUIC 提供现代低延迟链路,TCP 保证兼容性,WebSocket 覆盖浏览器 — 原生客户端可在传输间切换,协议始终不变。

Channel 优先

消息、在线状态、游戏事件、机器人回复与业务推送共用同一套 Channel 模型,学一次到处用。

Transfer RPC

在长连接上运行的强类型请求-响应路由,业务模块随时扩展能力,不动传输层。

服务端权威

消息 ID、序列点、已读游标与恢复逻辑全部以服务端为准 — 客户端缓存既快又可信。