# 广告屏管理系统Java微服务版

**Repository Path**: deng-xiaodai/advertscreen

## Basic Information

- **Project Name**: 广告屏管理系统Java微服务版
- **Description**: 广告屏管理系统JAVA微服务版，帮助企业进行多终端广告管理，总部一键配置，终端及时更新，广告随心而动。基于 Spring Boot/Spring Cloud & Alibaba 和  Vue/Element UI 前后端分离的分布式微服务架构。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-06-08
- **Last Updated**: 2026-06-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

广告屏管理系统JAVA微服务版，帮助企业进行多终端广告管理，总部一键配置，终端及时更新，广告随心而动。基于 Spring Boot/Spring Cloud & Alibaba 和  Vue/Element UI 前后端分离的分布式微服务架构。

# 开发环境
- jdk 1.8
- Android Studio 
- mysql 5.7+
- Node.Js 16.20+

# 目录结构

~~~
├── android_app -- 安卓广告屏客户端
├── RuoYi-Cloud-Vue3 -- 前端框架，基于开源项目RuoYi-Cloud-Vue3二次开发
└── RuoYi-Cloud -- 服务端，基于开源项目RuoYi-Cloud二次开发
	├── ruoyi-gateway         // 网关模块 [8080]
	├── ruoyi-auth            // 认证中心 [9200]
	├── ruoyi-api             // 接口模块
	│       └── ruoyi-api-system                          // 系统接口
	├── ruoyi-common          // 通用模块
	│       └── ruoyi-common-core                         // 核心模块
	│       └── ruoyi-common-datascope                    // 权限范围
	│       └── ruoyi-common-datasource                   // 多数据源
	│       └── ruoyi-common-log                          // 日志记录
	│       └── ruoyi-common-redis                        // 缓存服务
	│       └── ruoyi-common-seata                        // 分布式事务
	│       └── ruoyi-common-security                     // 安全模块
	│       └── ruoyi-common-sensitive                    // 数据脱敏
	│       └── ruoyi-common-swagger                      // 系统接口
	├── ruoyi-modules         // 业务模块
	│       └── ruoyi-system                              // 系统模块 [9201]
	│       └── ruoyi-gen                                 // 代码生成 [9202]
	│       └── ruoyi-job                                 // 定时任务 [9203]
	│       └── ruoyi-file                                // 文件服务 [9300]
	│       └── ruoyi-screen                              // 广告屏服务[9301]
	├── ruoyi-visual          // 图形化管理模块
	│       └── ruoyi-visual-monitor                      // 监控中心 [9100]
	├──pom.xml                // 公共依赖
	├──sql		              // 数据库脚本
~~~

# 操作步骤
- 在mysql中新建三个数据库ry-cloud，ry-config，ry-seata，分别运行RuoYi-Cloud的sql目录下的三个数据库脚本。如果要支持定时任务功能，还需要在ry-cloud数据库中运行quartz.sql
- 部署服务端，请参考RuoYi-Cloud官方文档：https://doc.ruoyi.vip/ruoyi-cloud/ ，注意：业务模块中新增了一个“广告屏服务”模块，需要启动这个模块。另外还要启动这几个模块：文件服务、网关模块、认证中心、系统模块。其他模块可以根据你的需要启动。
- 前端框架的启动
```bash

# 进入项目目录
cd RuoYi-Cloud-Vue3

# 安装依赖
npm install --registry=https://registry.npmmirror.com

# 启动服务
npm run dev

# 前端访问地址 http://localhost:80  ，默认账户/密码 admin/admin123
```
详情可参考RuoYi-Cloud-Vue3官方文档：https://gitcode.com/yangzongzhuan/RuoYi-Cloud-Vue3
- 启动前端框架并登录，点击左侧菜单栏“广告屏管理”->“素材”，在素材页面上传图片和视频
- 使用Android Studio编译打包“安卓广告屏客户端”，注意修改MainActivity.java文件中的    private String serverUrl="http://192.168.1.107:8080/";这一行代码，请更改为您的服务端网关模块网址
- 在您的安卓设备上运行“安卓广告屏客户端”，“安卓广告屏客户端”会调用接口screen/device/register，自动在数据库设备表“adv_device”中添加一条设备记录
- 打开前端框架，点击左侧菜单栏“广告屏管理”->“广告屏设备”，在设备管理页面修改设备名称
- 打开前端框架，点击左侧菜单栏“广告屏管理”->“设备播放素材”，在设备播放素材页面添加设备要播放的素材
- 稍等几分钟，安卓设备上运行的“安卓广告屏客户端”会自动到服务端下载素材，并自动播放