SuperAPI AI 工具集

blink-realtime

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:为应用提供基于 WebSocket 的实时发布/订阅通信,覆盖聊天、协作、通知推送、游戏状态同步和实时仪表盘等场景。

主要能力:支持频道(channel)发布与订阅、在线状态(presence)追踪、消息历史查询。消息包含 id、type、data、timestamp、userId、metadata 等字段;presence 包含 userId、metadata、joinedAt、lastSeen。提供 MCP 工具 blink_realtime_publish,以及 SDK 的 subscribe/publish 简写方法和更完整的 Channel API(subscribe、onMessage、onPresence、publish、getMessages、getPresence、unsubscribe)。

使用方式:需先认证,初始化时设置 auth: { mode: 'managed' },否则 realtime 无法工作。命令行示例:blink realtime publish chat-room --type message --data '{"text":"Hello everyone!"}'。SDK 可先 subscribe 再 publish,并调用返回的 unsubscribe 取消订阅;高级用法通过 blink.realtime.channel('game-lobby') 获取频道对象,订阅时传入 userId 与 metadata,用 onMessage、onPresence 处理回调,用 getMessages({ limit: 50 }) 取历史、getPresence() 取在线用户。

限制与注意:React 中清理逻辑必须同步返回,不能从 async 函数内部返回 cleanup,否则会丢失;应在外部保存 channel 引用并在 useEffect 返回的同步函数中调用 unsubscribe。资料未提供收费、价格、平台支持范围等更多信息。