開發者教程

從正確的路徑開始, 再逐步深入。

可執行的目標導向指南正在路上。在它們落地之前,下面每條路徑都指向對應儲存庫的 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、序列點、已讀游標與恢復邏輯全部以伺服器端為準 — 客戶端快取既快又可信。