更新记录

1.0.0（2026-08-26）

百搜速推即时通讯组件（JS SDK）

需要后台完整源码的联系客服获取！ 插件 ID：sutuyun-InstantMsg

面向 uni-app 的 自建 IM 前端 SDK，覆盖私信、群聊、会话列表、消息搜索、红包转账、音视频信令、消息收藏、实时推送等。消息走 NativeIm 协议。

重要：本插件 不含后台源码。买家需自备 NativeIm 兼容服务端（HTTP API + WebSocket 网关）。购买插件 = 获得前端 SDK，不等于获得整套后台。

需要后台完整源码的联系客服获取完整的后台和AI虚拟聊天人物。

快速开始

1. 安装

将 sutuyun-InstantMsg 放入 uni_modules/，在插件市场购买后绑定 AppID。

2. 配置

在 App.vue 的 onLaunch 中：

import { configureInstantMsg } from '@/uni_modules/sutuyun-InstantMsg/js_sdk'

export default {
  onLaunch() {
    configureInstantMsg({
      baseUrl: 'https://your-api.example.com',
      websocketUrl: 'wss://your-ws.example.com/im',
      realtimePushEnabled: true
    })
  }
}

3. 引入

import {
  getImDriver,
  buildOneToOneConversationId,
  getConversationList,
  getMessageList,
  sendTextMessage,
  ensureImRealtimeConnected,
  subscribeImRealtime,
  startImGlobalHub,
} from '@/uni_modules/sutuyun-InstantMsg/js_sdk'

4. 示例

const uid = 10001
const token = 'your-login-token'
const chat = { driver: getImDriver() }

const list = await getConversationList(chat, uid, token)
const convId = buildOneToOneConversationId(uid, 10002)
await sendTextMessage(chat, convId, '你好', uid, token)

SDK 模块（js_sdk 目录，共 30+ 文件）

完整文件列表见插件包 js_sdk/ 目录。

后端要求

HTTP：{baseUrl}/appapi/?service=NativeIm.{action}

最低必备：conversationsList、messageList、send、markRead、messageUndo、myGroups、groupCreate、searchGlobal

推荐：WebSocket 网关、Upload.uploadLocal（媒体上传）、User.searchForIm（加好友）

完整接口清单见 上传材料/09-后端接口要求.txt。

WebSocket 协议（摘要）

鉴权：{ "op": "auth", "uid": "...", "token": "..." }

下行：{ "op": "im", "scope": "message", "conversationID": "C2C10002" }

不含

• 后台 NativeIm API 源码与数据库
• IM 网关部署包
• 完整聊天 UI 页面（宿主自行实现，引用本 SDK）

平台

• App（vue / nvue）：完整能力
• 小程序 / H5：部分能力可降级

平台兼容性

uni-app(3.8.2)

上架上传清单（JS SDK · 即时通讯）

一键填写：打开 10-上架表单-全文可直接填写.txt，按页面上到下逐项复制即可。

发版命令

cd sutui-im-plugin-market\scripts
.\sync-sdk.ps1
.\build-plugin-zip.ps1
.\build-example-zip.ps1

核对

• 插件 ID：sutuyun-InstantMsg
• 分类：UTS插件
• zip 根目录：package.json + utssdk/ + js_sdk/（正斜杠，无外层文件夹）
• 详情页务必写明：不含后台，需买家自备 NativeIm 服务端
• 示例 manifest：appid 为空