491a1ce8d3
- 添加 SDK 配置管理、网络请求客户端和令牌存储功能 - 实现即时通讯 IM 模块，包括消息收发、群组管理和会话功能 - 集成推送服务和应用更新功能模块 - 创建示例应用演示 SDK 使用方法 - 配置项目依赖管理和构建设置
3.1 KiB
3.1 KiB
Vue3 SDK 概览
包名：@xuqm/vue3-sdk · 版本：0.1.0 · 支持：Vue 3.4+、Vite 5+
功能模块
| 导出 | 功能 |
|---|---|
useXuqm() |
全局初始化 Composable |
useIm() |
IM 单聊/群聊响应式状态 |
useUpdate() |
版本检查与热更新 |
XuqmProvider |
可选根组件（自动初始化） |
安装
npm install @xuqm/vue3-sdk
从私有 Nexus 安装时，在 .npmrc 中添加：
@xuqm:registry=https://nexus.xuqinmin.com/repository/npm-hosted/
快速接入
1. 全局初始化（main.ts）
import { createApp } from 'vue'
import { createXuqm } from '@xuqm/vue3-sdk'
import App from './App.vue'
const app = createApp(App)
app.use(createXuqm({
appId: 'your_app_id',
appKey: 'your_app_id',
appSecret: 'your_app_secret',
apiBaseUrl: 'https://dev.xuqinmin.com',
imWsUrl: 'wss://dev.xuqinmin.com/ws/im',
debug: import.meta.env.DEV,
}))
app.mount('#app')
2. IM 登录与消息监听
<script setup lang="ts">
import { onMounted, onUnmounted } from 'vue'
import { useIm } from '@xuqm/vue3-sdk'
const { messages, connected, login, sendMessage, revokeMessage } = useIm()
onMounted(() => login('user_001', '张三'))
</script>
<template>
<div>
<span :class="connected ? 'green' : 'gray'">
{{ connected ? '已连接' : '未连接' }}
</span>
<div v-for="msg in messages" :key="msg.id">
<b>{{ msg.fromUserId }}</b>: {{ msg.content }}
</div>
</div>
</template>
3. 发送消息
// 文本
await sendMessage('user_002', 'SINGLE', 'TEXT', 'Hello!')
// 图片
await sendMessage('user_002', 'SINGLE', 'IMAGE', JSON.stringify({
url: 'https://cdn.example.com/img.jpg',
width: 1200, height: 800,
}))
4. 撤回消息
const revoked = await revokeMessage(msg.id)
5. 群聊
const { createGroup, listGroups, subscribeGroup, groupMessages } = useIm()
// 创建群
const group = await createGroup('开发群', ['user_001', 'user_002'])
// 订阅群消息
subscribeGroup(group.id)
// 发群消息
await sendMessage(group.id, 'GROUP', 'TEXT', '大家好')
6. 检查 App/RN 更新
import { useUpdate } from '@xuqm/vue3-sdk'
const { checkAppUpdate, checkRNUpdate } = useUpdate()
const appInfo = await checkAppUpdate(1) // 当前 versionCode
const rnBundle = await checkRNUpdate('home', '1.0.0')
响应式状态
useIm() 返回的响应式 ref：
const {
messages, // Ref<ImMessage[]> 单聊消息列表
groupMessages, // Ref<ImMessage[]> 当前群消息列表
connected, // Ref<boolean> WS 连接状态
currentUser, // Ref<string | null> 当前登录用户
} = useIm()
消息气泡组件（内置）
SDK 内置基础气泡组件，开箱即用：
<script setup lang="ts">
import { ImMessageBubble } from '@xuqm/vue3-sdk'
</script>
<template>
<ImMessageBubble
v-for="msg in messages"
:key="msg.id"
:message="msg"
:is-own="msg.fromUserId === currentUser"
@revoke="revokeMessage(msg.id)"
/>
</template>
