构建并部署AUI Kits课堂AppServer_音视频终端 SDK(Apsara Video SDK)-阿里云帮助中心

AUI Kits课堂AppServer提供了登录服务和教室（直播间）管理服务等后台服务，通过与AUI Kits课堂场景SDK搭配使用，可以快速实现互动直播应用，助力业务创新快速上线。本文介绍如何使用Java版本的源码构建并部署AUI Kits课堂AppServer。

项目原理

AppServer的作用

集成方基于AUI Kits框架快速搭建互动课堂应用时，场景SDK对接了以下产品能力，AppServer对此进行封装，提供一套标准化的HTTP接口供场景SDK使用，降低了集成方的开发成本。

视频直播：用于直播推流、观看及音视频连麦。
互动消息：用于教室（直播间）传递信令消息。
视频点播（可选）：用于直播录屏、回放。
互动白板：用于线上学科辅导等课堂场景，教师可借助涂鸦、文本、直线、激光笔等基础教具，边演示课件边勾画要点，由网易云信互动白板服务提供。

AppServer除了封装上面4个产品的能力外，还实现了互动课堂管理服务，例如创建、修改、删除课堂、开始、结束互动课堂等常见功能。AppServer不直接依赖视频直播提供的接口，而是按照视频直播推拉流协议拼接地址实现推拉流地址获取。同时，AppServer也实现了监听视频直播的推流状态回调，以解决主播端异常退出而直播间状态不对的问题。

项目框架

基于主流的Java8 + Springboot2搭建框架。
基于Mybatis plus作为Repository层选型。
基于SpringSecurity + JWT实现权限控制。

项目部署

前提条件

已完成控制台配置相关操作。
环境中已安装了Java8。
在Web端使用该服务时正确设置CORS，以允许跨域请求。详见Web端配置并运行。

创建数据库

以MySQL为例，创建数据库，并执行该SQL文件。

正确创建后应该有如下7个表。

部署方式

方式一（推荐）：通过源码部署。
本示例主要通过源码构建并部署AppServer。根据源码的说明文档配置并执行，详细信息，请参见AUI Kits课堂AppServer。
方式二：如果熟悉函数计算，也可以使用Serverless平台快速部署，参见快速创建函数。

重要

在首次部署服务器时，请务必编辑代码文件code/src/main/java/com/aliyuncs/aui/common/utils/JwtUtils.java，给属性SECRET随机设置一个字符串。

项目参数配置

下载互动课堂源码至服务器。

打开源码Server\Java\code\src\main\resources目录下的application.yml文件，配置相关参数。

参数配置信息	说明
`server: port: 8080`	默认监听端口是8080，开发者可以自行更改。
`# DB连接信息，连接到MySQL数据库 url: jdbc:mysql://****:3306/*?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai username: "**" password: "****"`	`jdbc:mysql://MySQL数据库服务器的主机名或IP地址:3306/数据库的名称?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai` username：数据库用户名 password：数据库密码
`# pop配置。需要配置账号的AccessKey ID和AccessKey Secret，用于调用IM及VOD相关服务 openapi: access: key: "*******" secret: "*******"`	调用阿里云IM及VOD相关服务API时，您需要使用AccessKey完成身份验证。AccessKey包括AccessKey ID和AccessKey Secret。具体如下： AccessKey ID：用于标识用户。 AccessKey Secret：用于验证用户的密钥。AccessKey Secret必须保密。更多信息，请参见创建AccessKey。
`# IM服务的应用Id new_im: appId: "*******" appKey: "*****" appSign: "*******"`	直播互动消息AppId、AppKey和AppSign，请参见创建直播互动消息应用获取。
`# 直播推拉流配置 live_stream: #推流域名 push_url: push.***.vip #拉流域名 pull_url: pull.*.vip #推流对应的authkey push_auth_key: zJl4** #拉流对应的authkey pull_auth_key: mDZs****** app_name: live auth_expires: 604800`	push_url: 推流域名 pull_url: 拉流域名 push_auth_key: 推流域名的鉴权主KEY pull_auth_key: 播流域名的鉴权主KEY app_name: 转推后直播流地址中的*AppName，默认为live*，可自定义。说明若您需要为转推后的流绑定转码、录制、截图等模板，需要设置该AppName与模板中的AppName一致模板才会生效。请参见查看鉴权值获取。
`# 连麦应用信息 live_mic: app_id: 7c61****** app_key: c461b*******`	视频连麦应用ID和AppKey，请参见创建实时音视频应用获取。
`# 推流状态回调的authKey live_callback: auth_key: avdsd*******`	如果需要监听某个推流地址的推流状态，请配置该参数。请参见回调设置获取该参数值。
`# 白板信息 room: boards: app_key: "*******" app_secret: "*******"`	网易云信互动白板服务应用的AppKey、AppSecret，请参见白板配置获取。
`# 配置允许跨域的请求域名 http: cors: host: "*"`	Web端使用该服务时请正确设置CORS，以允许跨域请求。

面向服务的鉴权配置说明

本项目需要先调用/login接口获取鉴权的token，将token放到请求头中，然后再调用其它接口。但是本项目token的生成方式较为简易，仅适用于测试，用户基于Demo开发时需要自行调整鉴权策略。用户可按自身业务需求实现鉴权配置，包括token的生成算法也可以自定义，要确保生成及检验token使用相同的算法。

说明

鉴权token的相关代码文件见code/src/main/java/com/aliyuncs/aui/common/utils/JwtUtils.java。

/login接口说明详见登录的详细接口定义。

项目打包和运行

打包

使用IDEA自带的Maven打包，jar在target目录下。
在Server\Java\code路径下使用以下命令执行打包操作。
```
mvn package -DskipTests
```
将target目录下的jar包发送到服务器。
```
scp xxx.jar root@ip:/root
```

运行项目

在jar包所在目录下打开终端。

终端运行，日志打印到终端。
```
java -jar ***.jar
```
后台运行，将日志打印输出到nohup.out文件。
```
nohup java -jar ***.jar &
```
查看是否启动成功。
访问对应接口，显示如下，说明AppServer启动成功。