本课程用到的项目一共有5个,分别是emos-wx-api
、emos-wx
、emos-workflow
、emos-api
和emos-vue
,这些项目的具体用途,大家请看下面的表格。
序号 | 项目名称 | 备注 |
---|---|---|
1 | emos-wx-api | 在线办公小程序的后端SpringBoot项目 |
2 | emos-wx | 在线办公小程序的移动端uni-app项目 |
3 | emos-workflow | 在线办公的工作流项目 |
4 | emos-api | 在线办公Web系统的后端SpringBoot项目 |
5 | emos-vue | 在线办公Web系统的前端VUE3.0项目 |
一、注册微信开发者账号
因为本课程案例具有跟微信小程序交互的功能(例如扫码登陆、支付罚款等),而且emos-wx
项目是微信小程序项目,所以想要跑起来本课程的各种项目,必须要提供微信小程序的appid
和secret
。只要我们正常注册微信开发者账号,就能拿到自己的appid
和secret
了。
1. 注册开发者账号
同学们打开浏览器,访问微信公众平台官网(https://mp.weixin.qq.com/),然后点击右上角的“立即注册”超链接。
注册的开发者账号类型选择成“小程序”。
然后填写自己的注册信息,注意账号的用户名是你的Email地址。注册成功之后,腾讯的服务器会向你的邮箱发送激活邮件,所以大家要填写真实有邮箱地址,否则收不到激活邮件。
你收到激活邮件之后,点击邮件中的超链接,浏览器会跳转到实名登记的网页。开发者账号的类型暂且选择成个人,因为企业类型的账号需要你提交真实的企业信息(工商登记、银行开户证明,法人信息等)。你按照网页的提示要求,填写真实的个人信息即可。
2. 获取appid和密钥
微信开发者账号注册成功之后,我们登陆微信公众平台,然后在左侧菜单中找到“开发”-> “开发管理”。跳转页面后,点击“开发设置”选项卡,就能看到你微信小程序的appid
和密钥
了。如果是新用户,你点击旁边的“生成”按钮,就能看到密钥字符串了。大家把你自己的appid
和密钥
保存下来,我们在项目中要用到。
二、开通腾讯云TRTC服务
1. TRTC业务介绍
腾讯实时音视频(TRTC)将腾讯21年来在网络与音视频技术上的深度积累,以多人音视频通话和低延时互动直播两大场景化方案,通过腾讯云服务向开发者开放,致力于帮助开发者快速搭建低成本、低延时、高品质的音视频互动解决方案。
【多人音视频通话方案】:依靠腾讯云覆盖全球的专线网络,全球均可互通,提供覆盖手机、桌面全平台的客户端 SDK 以及云端 API,终端用户还可以在微信、QQ、企业微信的小程序中使用 TRTC 服务,Web 网页也可轻松使用。
【低延时互动直播方案】:凭借行业领先的网络与音视频技术,结合腾讯云优质的节点资源,帮助开发者搭建卡顿率更低、延时1秒以内的互动直播,让直播走进 CDN 2.0 时代。
2. 为什么不使用阿里云的实时音视频服务,偏要选用腾讯云TRTC服务?
因为咱们的在线办公系统,无论是浏览器版本还是小程序版本,都可以进行在线视频会议。其实很多云计算运营商都开放了在线视频会议服务。 虽然阿里也有实时音视频服务,但是并不支持微信小程序,所以我们想要在微信小程序上面做在线视频会议,就必须使用腾讯的TRTC服务。包括浏览器端的在线音视频会议,我们使用腾讯云的TRTC服务也能有不错的效果。
同学们在体验案例的时候,随便填写一个会议房间号,点击进入即可
腾讯现在为开发者免费提供10000分钟的流量包,足够我们开发在线会议模块。如果正式上线运营,TRTC音视频流量包也很便宜。
3. 开通TRTC服务
登陆腾讯云之后,访问TRTC控制台,选择新建应用。
创建应用之后,根据系统提示,领域免费的流量包,下面的内容引用自腾讯云。
4. 领取TRTC的AppID和密钥
在TRTC应用管理界面选择快速上手,标题文字旁边的就是AppID,把这个字符串复制下来。
在页面的中部可以获取TRTC的密钥,把密钥复制下来。
三、导入 emos-api 项目
上一个小节,我们在本地把工作流项目运行起来了,接下来咱们要去运行Emos工程的后端SpringBoot项目,这个项目我已经放在Git上面了,在“初始化项目”目录中,你把emos-api.zip
文件解压缩,然后导入到IDEA里面。至于说后端项目是怎么从零搭建起来的,同学们可以看手册的附录部分,你只要按照附录的指引,自己也能搭建出后端项目。
1. 导入 Maven 依赖
导入项目之后,首先要找到pom.xml
文件,选中文件然后点击鼠标右键,选择“添加为Maven项目”,然后Maven就会帮我们初始化Java项目。
2. 修改数据库连接信息
你打开application.yml
文件,把里面的MySQL连接信息改成你本地的。
接下来我们还要修改Redis和MongoDB的连接信息,也是改成你本地的连接信息。
最后你要把自己的TRTC的appid
和密钥
,以及微信小程序appid
和密钥
填写到yml文件中。
做好了上述的操作,我们先启动MySQL、Redis、MongoDB和RabbitMQ,包括工作流项目也要运行起来,接下来我们运行EmosApiApplication.java
主类。如果控制台没有报错,说明emos-api
这个项目已经没有问题了。
四、运行 emos-wx-api 项目
在“项目”目录中存放着emos-wx-api.zip
文件,你把这个文件下载到本地,解压缩之后会看到emos-wx-api.jar
和application.yml
两个文件。
1. 修改yml文件
修改解压缩出来的application.yml
文件内容,里面有很多东西要修改。因为emos-wx-api
项目包含了很多功能,配置这些功能的过程非常繁琐,所以这里我们暂且把其中的核心功能配置出来,至于其他的功能后续再说。因为yml文件的内容太多,要修改哪些地方和内容,请大家参考视频的讲解。
2. 运行JAR文件
必须把emos-wx-api.jar
和application.yml
文件放在同一个目录之下,然后执行下面的命令运行JAR文件。
java -jar -Dfile.encoding=utf-8 emos-wx-api.jar --spring.config.location=application.yml