盒子IM付费服务

7. 联系方式

如果您需购买或有还有其他疑问，请加V联系作者，加v时请备注”商业版”：

• 加微信前请务必先阅读本文档的全部内容，如果大量询问本文档已有内容，可能会不回复您的消息
• 为避免源码被用于非法用途，境外微信账号一律不予通过

  2.付费-远程协助

  1. 前言

  目前作者可以为您提供以下服务：

  • • 服务部署过程中遇到问题无法解决的，可以邀请作者进行远程协助
    • 对项目架构和代码有不明白的地方的，可以邀请作者进行一对一讲解

  当然，这是收费的。

  注: 因最近事务繁忙，本服务目前仅对购买了商业版的客户开放

  2. 付费标准

  费用： ¥150/小时（0.5小时起步）

  支付渠道：微信/支付宝

  3. 说明

  • 对于代码讲解服务，可通过腾讯会议(支持录屏)或者todesk+微信语音(更方便)的方式进行
  • 如需讲解代码，请先把要咨询的问题和本地开发环境准备好，以节省双方时间
  • 如果问题最后没有得到解决，则不收费
  • 如果是由于盒子IM的代码或者问题错误导致的异常，则不收费

  4. 常见问题

  如果问题最终花了很长时间才解决怎么办，也是按150/小时收费吗？

  • 作者给已经很多小伙伴处理过各种问题，一般不会消耗很长时间
  • 如果问题确实不易解决，作者一般会及时放弃，此时不会收费
  • 作者的时间成本¥200/小时左右，提供本服务其实并不是单纯为了¥, 也不必担心作者在服务过程会刻意消磨时间骗取收益

  5. 联系方式

  由需要联系作者，加v时请备注”远程协助”：

  

  3.付费-环境搭建

  1. 前言

  如果有老板需要作者帮忙搭建服务器，可以联系作者，当然，这是收费的

  虽然作者提供环境搭建服务，但是如果自身具备部署能力，还是更推荐您根据文档自行部署，这样其实更有利于您长期的维护

  注: 因最近事务繁忙，本服务目前仅对购买了商业版的客户开放

  2. 付费标准

  费用： 500¥/次

  支付渠道：微信/支付宝

  支付时间： 先支付后搭建

  3. 付费须知

  请务必知悉以下内容：

  • 如您未购买商业版源码，则部署的将是最新的开源版本
  • 部署前需自备一台干净的服务器，配置在4核8G(最低2核4G)以上，要求linux系统，可以是宝塔环境
  • 部署前需自备域名和ssl证书，域名需自行备案
  • 网站标题、APP名称、logo、网站备案号，请在部署前发给作者
  • 如果需要离线通知功能，需您提前准备并提供unipush账号
  • 默认仅支持用户名注册，如果需要手机注册和邮箱注册，请将相关配置发给作者
  • uniapp只能打包成安卓APP和h5，因为ios和小程序都需要上架才能访问
  • 如果需要打包ios，需要自行提供打包用的p12和profile文件，并且需要自行签名，否则无法安装
  • 如果因您自身原因(如更新代码、更换域名、logo等)导致需要重新打包，需另收费150/次
  • 本服务仅负责系统环境搭建，不参与未来的维护工作
  • 暂时不接受远程您的pc电脑进行打包部署
  • 为了避免用于非法用途，目前仅支持使用内地的服务器

  4. 严正声明

  请勿将软件用于非法用途，一旦发现，将立即停止部署，且费用不退还，必要时甚至可能报警处理！

  5. 联系方式

  由需要联系作者，加v时请备注”环境搭建”：

  

  功能介绍-音视频通话

  1. 功能介绍

  本模块支持单人和多人的音视频通话，且移动端和web端支持互相呼叫。

  本模块基于原生webrtc实现，并非封装的第三方库或云厂商接口,不会产生额外费用

  由于uniapp本身并未支持webrtc接口，所以uniapp端的音视频通话功能需通过与webview组件交互实现。此webview组件源码修改后需要进行编译才会生效，具体请参考组件编译说明

  2. 购前须知

  • • 音视频功能支持web、ios、安卓、 h5，不支持微信小程序，4.1为什么不兼容微信小程序
    • 并非所有设备都能支持音视频通话,兼容性跟手机的型号、操作系统、浏览器都有关系，实际效果以演示环境为准，购买前请先在体验环境进行测试，确认是否达到要求。4.2目前uniapp端音视频通话兼容性如何？
    • 多人通话可通过配置项webrtc.max-channel修改单个群聊最大通话人数，默认9人，建议不要超过16人(微信就是限制16人)
    • 跨网段通话需要搭建coturn,并修改配置项webrtc.iceServers

  3. 组件编译说明

  3.1.1. 介绍

  uniapp的音视频功能通过webview实现，以下两个目录分别是”多人通话”和”单人通话”的webview组件源码。

  

  这两个webview组件本质上分别是一个H5页面，基于vue2开发，经过编译打包后，自动拷贝到uniapp的hybrid目录，成为音视频通话的webview组件。

  3.1.2. 编译

  编译本组件十分简单，基本上就是跟打包vue项目一致，以编译”单人通话”组件为例，操作如下：

  安装node:v18.19,进入im-webview-private-rtc目录，打开命令行执行:

  npm install
  
  npm run build

  编译通过后，会在im-uniapp的/hybrid/html生成代码：

  

  编译完成，正常启动uniapp即可！

  4. 常见问题

  4.1. 为什么不兼容微信小程序

  • 微信小程序与webview组件无法很好的进行实时通信，难以通过原生webrtc实现
  • 如果要微信小程序上实现音视频通话，一般要通过腾讯云提供的音视频sdk来实现

  4.2. 目前uniapp端音视频通话兼容性如何？

  这是作者和一些朋友手机的兼容性测试情况(仅供参考)：

  • 安卓手机主流机型基本都支持，但是部分浏览器不支持，例如小米手机的默认浏览器
  • 安卓13的app有webview存在bug,有可能不支持（如果打包成h5则正常）
  • 苹果手机：不支持较旧的机型，网上资料是系统在ios14.3以上支持webrtc，实际测试结果是需要iphone12，系统ios15以上，才能比较稳定支持

  4.3. uniapp端如何打开/去掉右下角的vconsole绿色按钮？

  打开/注释组件中以下代码，重新编译即可

  

  4.4. 通话失败应该如何排查？

  服务器配置问题请排查：

  • 服务器是否部署了ssl证书？
  • coturn是否安装并通过测试：coturn测试网站？
  • coturn信息是否已配置到im-platform的配置文件？

  设备问题请排查

  • 摄像头是否损坏、被禁用或被其他进程占用
  • 如果是苹果手机，iphone11或ios14以下不支持webrtc
  • 如果是安卓手机访问h5, 默认浏览器可能不支持webrtc，建议用其他浏览器，或者直接用微信点开
  • 如果是安卓app, 安卓13系统的webview有bug，尽管做了一些适配，但仍可能无法兼容webrtc。如需兼容安卓13，需要在打包时将targetSdkVersion降至29（但可惜的是targetSdkVersion必须30以上打的包才能上架）

  5. 效果截图

  h5单人通话：

  

  h5多人通话：

  

  web多人通话：

  

  功能介绍-消息提醒

  1. 功能介绍

  本模块开启后，可以使APP在处于离线状态时，依然能够收到消息通知和通话呼叫邀请。

  本模块是通过接入unipush1.0实现，为何选择unipush1.0作为离线推送的sdk?

  2. 购前须知

  1. 支持国内的主流品牌：苹果、华为、小米、oppo、vivo、荣耀，但海外推送还未完成调试
  2. 华为、小米、oppo、荣耀，这几个品牌需要用户手动开启消息通知权限
  3. 本模块需调用unipush(个推)的sdk，所以服务器需要访问外网的能力
  4. 为节约服务器资源，超过30天未登录的用户不会收到离线通知
  5. 由于盒子IM不能像微信一样具备常驻后台权限，加上开发时间有限，实现的效果跟微信等知名社交软件还是有差距的，请老板们购买前务必在体验环境进行体验，确认效果能达到预期
  6. 启用本功能需老板们自行开通unipush权限，并在手机厂商开发者后台开通推送服务
  7. 开通消息推送有一定的门槛，小米、oppo、vivo均要求app上架后才可开通推送权限

   

  3. 使用说明

  3.1. 配置说明

  配置项	默认值	说明
  notify.enable	false	是否开启离线通知。当不需要离线通知或unipush权限未开通时，请设置为false,否则会有报错且有性能损耗
  notify.debug	false	是否调试模式。当华为或荣耀厂商的账号未申请消息分类时，一天只能推2条消息，此时将此参数设置为true后，一天可以发500-1000条消息，但此参数在生产环境必须设置为false
  notify.app-name	盒子IM	应用名称。同时也是通知栏上显示的默认名称
  notify.package-name	com.boxim	应用包名。需跟unipush后台配置的一致
  notify.active-days	30	用户最近活跃天数。为节约服务器资源，大于30天内未登陆的用户不推送离线通知
  notify.max-size	-1	最大消息数量,-1表示不限制。为节省服务器资源和减少对用户的打扰，用户接收消息数量超过此值时不再推送，用户每次在APP登陆时，消息数量会重置
  notify.uni-push		unipush的账号信息。位置:dcloud开发者中心->unipush->消息推送->配置管理->应用配置
  notify.manufacturer.xm-channel-id		小米消息类别channelId。
  notify.manufacturer.hw-category	IM	华为消息分类类型，开通推送服务后自行申请
  notify.manufacturer.op-category	IM	oppo消息分类类型，开通推送服务后自行申请
  notify.manufacturer.vv-category	IM	vivo消息分类类型，开通推送服务后自行申请

  配置样例参考：

  application.yml

  notify:
    enable: true # 是否开启推送功能
    debug: false # 调试模式,生产环境必须关闭，华为手机在调试模式下，一天可发送500条消息
    app-name: 盒子IM # app名称，也是默认title
    package-name: com.boxim # 应用包名，跟unipush后台配置的一致
    active-days: 30   # 用户最近活跃天数，30天内未登陆的用户不推送
    max-size: -1   # 最大消息数量,未读数量超过此值不再推送，-1表示不限制
    uni-push:
      app-id: nyK71XQYUy9s7vasoutlp1
      app-key: XtG6NkUSL98evt23gSE0jYA
      master-secret: MxApXxsx05231jcPCeC0cXk6
    manufacturer:
      xm-channel-id: 100142 # 小米消息类别channelId
      hw-category: IM # 华为消息类别
      op-category: IM # oppo消息类别
      vv-category: IM # vivo消息类别

  3.2. 开通unipush

  离线通知功能需要您自行开通unipush权限。

  开通unipush权限不难，但是还需要在每个手机厂商注册账号并开通推送消息权限，每个手机厂商还有自己的一些规则和限制，里面还涉及到不少概念和术语，整个过程还是相当繁杂的。

  这里为汇总一些作者认为比较重要的文档链接，希望对您有所帮助：

  uniapp对于unipush1.0的官方文档：

  https://uniapp.dcloud.net.cn/unipush-v1.html

  unipush开通指南：

  https://ask.dcloud.net.cn/article/35716

  最新厂商限额规则（安卓离线推送必读）：

  https://docs.getui.com/getui/mobile/vendor/qps/

  个推说明文档(unipush其实用的是个推的sdk)：

  https://docs.getui.com/getui/server/rest_v2/push/

  安卓常见问题：

  https://docs.getui.com/getui/question/android/

  如果对于unipush相关的问题还有疑虑，可以使用微信扫描下面二维码，进行技术咨询，会有专业的个推专业人员为您解答:

  

  4. 常见问题

  4.1. 为何选择unipush1.0作为离线推送的sdk?

  • unipush1.0目前可以免费使用，而其他如极光、unipush2.0等sdk均需要收费
  • unipush2.0虽然是uniapp推荐的版本，但unipush2.0依赖unicloud云环境，主要是用于消息不走自己服务器的场景，而我们是有自己的服务器的
  • unipush2.0如果需要在后台进行推送，需要通过定义云函数的方式，概念比较抽象。而unipush1.0有现成的java sdk，接入更简单
  • 综合以上，作者认为unipush1.0更适合盒子IM的场景

  5. 效果截图

  离线消息通知：

  

  离线呼叫通知：

  

  功能介绍-系统消息

  1. 功能介绍

  本模块可以在后台编辑富文本格式的系统消息，然后在指定的时间推送给用户，支持全体用户推送和指定用户推送。

  2. 使用指南

  登陆盒子IM后台管理系统，进入菜单：消息管理->系统消息->新增：

  

  编辑完成后，返回列表发起推送：

  

  推送记录在:消息管理->推送任务

  

  此时用户收到系统消息;

  

  点击查看详情：

  

  移动端效果：

  功能介绍-自动更新

  1. 功能介绍

  app的更新有两种方式：

  • 整包更新: 本质上是重新下载最新的完整app，然后重新安装
  • 增量更新: 下载最新的wgt文件，进行增量更新，无需重新安装

  盒子IM采用的是增量更新的方式，用户在启动APP时，会向后台发送版本校验请求，如果发现不是最新版本，就会自动下载最新的wgt文件并完成更新。

  注意：如果打包时如果新增了模块，自动更新会失败，此时用户只能手动更新

  2. 配置说明

  本章节以v3.5.0升级到v3.5.1为例，介绍相关的配置

  2.1. 打包wgt文件

  首先，我们需要升级mainfest里面的app的版本为3.5.1：

  

  点击菜单，发行->App-制作应用wgt包（弹窗后继续点确定）：

  

  大概30s后就会编译完成：

  

  再把这个wgt重命名后上传到一个用户能下载地方，通常是上传到nginx，此时你会得到一个wgt文件的下载url，以我线上环境为例，url为：https://www.boxim.online/download/boxim.wgt

  2.2. 前端配置

  修改im-uniapp的.env.js的UNI_APP.WGT_URL变量，内容为上面的wgt下载url

  

  2.3. 后端配置

  修改im-platform的配置文件，修改为最新的版本号，以及相关的升级日志

  

  3. 效果截图

  功能介绍-后台保活

  1. 功能介绍

  app在进入后台时：

  • 大约5-60s后, 网络会断开，app停止运行
  • 大约10-30min后，系统会杀掉app进程

  简单的说，盒子IM在进入后台一段时候，就无法接受消息了，解决这个问题有两个方案：

  • 用户手动开启app的后台运行或自启动权限

  优点：保活率极高，几乎100%

  缺点：麻烦，用户不一定会操作

  • 引入保活插件

  优点：简单，用户无需多余操作

  缺点：保活成功率低，消耗电量可能更高

  2. 保活插件介绍

  我们引入的插件名为：android-keeplive，虽然名字带andriod，但其实是支持ios保活的，不过里面大部分api确实只支持安卓，插件地址为：

  https://ext.dcloud.net.cn/plugin?id=20316

  具体的插件使用细节，可以参考上面官方的文档，这里补充几点说明：

  1. 该插件虽然是收费插件，但我们已经将源码买下，您无需重复付费购买（已得到插件作者同意，集成到项目后，可以出售源码）
  2. 任何插件都无法保证100%保活成功，本插件亦是如此
  3. 引入保活插件后，app的耗电量会有所增加
  4. 引入保活插件后，据说会增加上架难度
  5. 引入本插件后，打包是必须使用“传统打包”，不能使用“安心打包”，原因暂不清楚

  3. 配置说明

  开启保活，只需配置.env.js的KEEPALIVE_LEVEL变量即可（默认值为1）：

  

  0：完全不开启保活

  1: 普通保活：开启后后会生成通知栏信息，多数情况下，可以在后台保活10-30min

  2：强力保活：在普通保活的基础上，开启电池优化选项，会弹出“后台运行”的权限请求，相比“普通保活”，有更高的保活概率和保活时长

  再次强调：即使是开启强力保活，也不能保证一定能保活成功

  4. 效果截图

  商业版更新日志

  2025-08-01（版本：3.8）

  新增：web端多人通话增加投屏功能

  新增：移动端支持播放消息提示音，增加提示音开关

  新增：支持显示消息发送中状态

  新增：支持app后台保活

  优化：会话置顶优化

  优化：”我的”页面优化，增加”关于我们”页面

  2025-06-27（版本：3.7）

  新增：发布electron桌面端，支持消息提醒和截图功能

  新增：消息免打扰

  新增：用户投诉功能

  优化：本地消息缓存卡顿优化

  2025-05-30（版本：3.6）

  新增：消息转发(单条)

  新增：个人名片、群名片

  新增：扫一扫、个人二维码、群二维码

  优化：消息滚动时支持一键回到底部

  2025-05-05（版本：3.5）

  新增： 查询历史聊天记录

  新增： 群聊设置管理员

  新增： APP自动更新

  新增: 重复文件校验，自动删除过期文件

  2025-04-09（版本：3.4）

  新增: 手机号注册、邮箱注册

  新增：好友审核（默认关闭，用户可以在设置中开启）

  新增：群消息置顶

  优化：群成员使用虚拟列表，成员数量上限放宽至1万人

  优化：支持拉取已删除好友的离线消息

  优化：支持对方在离线状态下撤回消息

  2025-02-25（版本：3.3）

  新增： 消息内容url识别

  新增：引用消息

  新增：好友备注

  新增: 群成员禁言设置

  2025-01-12（版本：3.2）

  新增： 授权用途提示涂层（安卓）

  新增： 消息提醒权限开启引导弹窗

  优化： 移动端消息输入框支持回显emoji表情

  优化： 启动界面优化

  重做： 后台管理使用ruoyi-vue-plus重做

  2024-11-24（版本：3.1）

  新增： 群成员列表标签显示

  新增： 视频消息，仅支持mp4格式

  新增： app后台运行时增加消息提醒和呼叫提醒

  优化： ui整体效果优化

  2024-10-01（版本：3.0 商业版上线）

  新增： 后台管理上线（独立工程，基于maku-boot开发）

  新增： 系统消息

  新增： 用户封禁、群聊封禁

  优化： 离线消息加载性能提升

  优化： 界面整体效果优化

  升级： 组件版本全面升级（jdk17、srpingboot3）