更新记录
1.2(2026-11-17) 下载此版本
解决苹果屏幕共享联调通知问题,解决苹果手机切换后台语音持续推流的问题,解决苹果和安卓端小窗视频会议时的兼容问题
平台兼容性
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
优聊 U聊
一个支持音视频通话视频会议室的全端App —— 基于 uni-app x 开发,一套代码同时运行在 Android 和 iOS以及H5。
说明
- 没有证书和开发者但需要测试苹果端效果的 可以联系我,我会提供测试用的环境
- 本系统服务端采用NODE.js + Express 框架
项目优势
- 保活稳定,使用前台服务和重连机制
- 苹果和安卓,H5都实现了屏幕共享功能 且画质和延迟都比较稳
- 功能完善,支持聊天、群组、朋友圈、音视频通话、多人视频会议、红包与钱包、通讯录与群管理等功能
测试
- H5端直接访问即可 https://bgyx02.haoleen.com/
- 安卓APP (直接真机调试 或者下载测试APP http://xiazai.haoleen.com/UNI4796575_1108235305.apk)
- 苹果APP (需要联系我提供UUID进行测试;自有开发者账号可直接真机运行,见文末《苹果 App 真机运行教程》)
- 测试账户 user01 ~ user09 密码都是 123456,也可以自行注册
关于
优聊是一套完整的即时通讯应用。聊天、群组、朋友圈、音视频通话、多人视频会议这些常用功能都做进去了,不是零散组件的堆叠。项目拿到手就能编译运行,界面和交互都按日常聊天软件的习惯来做,也可以在这套基础上继续加自己的功能,适合二开。
功能
聊天 单聊、群聊,支持文字、图片、语音消息;有已读未读、消息引用、消息转发和聊天记录。会话列表、置顶、免打扰这些也都齐全。
音视频通话 1v1 语音 / 视频通话,带呼叫等待、来电铃声与通话记录。
多人视频会议 可以创建会议室,用房间号(或密码)邀请别人进入,多人同时视频,画面自动宫格排布,并支持屏幕共享。
朋友圈 发布图文动态,好友可以点赞、评论。
红包与钱包 单聊、群聊都能发红包,配有余额和账单流水。
通讯录与群管理 搜索加好友、好友申请与验证、备注、黑名单;建群、邀请成员、设置管理员、踢人、群公告。
优聊的优势
- 保活够强:退到后台也能继续收消息,不容易被系统清掉,用起来接近原生聊天软件。
- 音视频是原生的:通话和会议走原生音视频链路,不是网页套壳,画质和延迟都比较稳。
- 一套代码两端跑:Android 和 iOS 共用同一套 uni-app x 代码,维护成本低。
- 界面统一、克制:整体风格干净,没有花哨的动画和大片渐变,偏实用的聊天软件审美。
- 开箱即用:账号、好友、会话、消息这些逻辑都已经配好,配套服务端连上就能用。
运行环境
- HBuilderX 4.x 及以上
- uni-app x(Vue 3)
- Android 6.0+ / iOS 13+
- 音视频相关功能需要真机调试
苹果 App 真机运行教程
面向已拥有 Apple 开发者账号 的开发者,
一、前置条件
- 一台 macOS 电脑(iOS 原生只能在 Mac 上编译)
- Xcode ≥ 15.2 + Command Line Tools(终端执行
xcode-select --install) - HBuilderX 4.x 及以上(建议与作者一致,当前为 5.26)
- HBuilderX 插件市场安装:「uts开发扩展-iOS」
- iPhone(iOS 15.0+)、数据线,且与 Mac 处于同一 Wi-Fi
- 已加入 Apple Developer Program 的账号
二、获取工程
克隆或复制 utsdemo/(含 manifest.json 的那一层)到 Mac,用 HBuilderX 直接打开 utsdemo 目录。
三、Apple 开发者后台准备
进入 Certificates, Identifiers & Profiles:
- 注册 App ID(Identifiers → 新建)
- 主 App 的 Bundle ID:本项目默认是
com.bgyx.utsdemo。Bundle ID 全局唯一,若已被占用请改成你自己的,例如com.你的团队名.utsdemo。 - 需要屏幕共享时,再建一个广播扩展的 App ID:
<主BundleID>.broadcast(本项目为com.bgyx.utsdemo.broadcast)。
- 主 App 的 Bundle ID:本项目默认是
- 创建开发证书:用「钥匙串访问 → 证书助理 → 从证书颁发机构请求证书」生成 CSR,上传后下载 Apple Development 证书,导出为
.p12(记下设置的密码)。 - 注册测试设备:Devices → 新建,把要调试的 iPhone UDID 加进去。
- 创建描述文件:Profiles → 新建,类型选 iOS App Development,勾选上面的证书和设备,下载
.mobileprovision。- 屏幕共享需再给广播扩展单独建一份描述文件。
- App Group(屏幕共享需要):Identifiers → App Groups 新建一个(本项目为
group.com.bgyx.utsdemo), 并在主 App 与广播扩展的 App ID 上都勾选它。
如果暂不需要屏幕共享,第 1、4、5 步只做主 App 的即可,后续再补。
四、HBuilderX 里配置 iOS 打包信息
打开 manifest.json → 左侧「App图标配置」→ iOS,填写:
- Bundle ID(与后台一致)
- 证书文件
.p12+ 证书密码 - 描述文件
.mobileprovision
(图标仓库已自带,无需重新上传。)
五、制作 iOS 自定义调试基座
HBuilderX 菜单:运行 → 运行到手机或模拟器 → 制作自定义调试基座 → 平台选 iOS → 选「使用本地证书」→ 打包。
打包完成后基座会自动安装到已连接的 iPhone;若未自动安装,可用 Xcode 的 Devices 窗口或 Apple Configurator 手动安装生成的 ipa。
六、首次信任开发者证书
iPhone 上:设置 → 通用 → VPN与设备管理 → 开发者App → 选择你的证书 → 信任。 未信任前 App 会闪退 / 无法打开。
七、运行到手机 + 迭代节奏
- HBuilderX:运行 → 运行到手机或模拟器 → 运行到 iOS App 基座 → 选择你的设备。
- 日常改页面与业务逻辑(
.uvue、store/*.uts、业务.uts)走热更新,不消耗基座打包次数。 - 改到原生层(
uni_modules/*/utssdk/app-ios/*、Info.plist、manifest.json、config.json)必须重做自定义基座(次数有限,改前先自查)。
八、联调说明
- 本项目默认连生产后端,无需本地起服务:
- API / WebSocket:
https://ustchatapi.haoleen.com(WS 为wss://.../ws) - LiveKit 信令地址由后端签发,端侧不需要 apiKey/secret
- API / WebSocket:
- 测试账号:
user01 ~ user09,密码123456;也可自行注册。 - 若要连你本机的后端:改 request/index.uts 的
resolveBaseUrl()基址即可(填局域网 IP,iOS 首次访问会弹「本地网络」授权,需允许)。

收藏人数:
下载插件并导入HBuilder
下载插件ZIP
赞赏(0)
下载 4181
赞赏 0
下载 12770713
赞赏 1959
赞赏
京公网安备:11010802035340号