全部开发者教程

企业级在线办公系统

本课程用到的项目一共有5个,分别是emos-wx-apiemos-wxemos-workflowemos-apiemos-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项目是微信小程序项目,所以想要跑起来本课程的各种项目,必须要提供微信小程序的appidsecret。只要我们正常注册微信开发者账号,就能拿到自己的appidsecret了。

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.jarapplication.yml两个文件。

1. 修改yml文件

修改解压缩出来的application.yml文件内容,里面有很多东西要修改。因为emos-wx-api项目包含了很多功能,配置这些功能的过程非常繁琐,所以这里我们暂且把其中的核心功能配置出来,至于其他的功能后续再说。因为yml文件的内容太多,要修改哪些地方和内容,请大家参考视频的讲解。

2. 运行JAR文件

必须把emos-wx-api.jarapplication.yml文件放在同一个目录之下,然后执行下面的命令运行JAR文件。

java -jar -Dfile.encoding=utf-8 emos-wx-api.jar --spring.config.location=application.yml