更新记录

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:

  1. 注册 App ID(Identifiers → 新建)
    • 主 App 的 Bundle ID:本项目默认是 com.bgyx.utsdemo。Bundle ID 全局唯一,若已被占用请改成你自己的,例如 com.你的团队名.utsdemo。
    • 需要屏幕共享时,再建一个广播扩展的 App ID:<主BundleID>.broadcast(本项目为 com.bgyx.utsdemo.broadcast)。
  2. 创建开发证书:用「钥匙串访问 → 证书助理 → 从证书颁发机构请求证书」生成 CSR,上传后下载 Apple Development 证书,导出为 .p12(记下设置的密码)。
  3. 注册测试设备:Devices → 新建,把要调试的 iPhone UDID 加进去。
  4. 创建描述文件:Profiles → 新建,类型选 iOS App Development,勾选上面的证书和设备,下载 .mobileprovision。
    • 屏幕共享需再给广播扩展单独建一份描述文件。
  5. 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
  • 测试账号:user01 ~ user09,密码 123456;也可自行注册。
  • 若要连你本机的后端:改 request/index.uts 的 resolveBaseUrl() 基址即可(填局域网 IP,iOS 首次访问会弹「本地网络」授权,需允许)。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

摄像头 麦克风

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议