# 内容展示框安卓App

**Repository Path**: lonely-shadow/content-display-box-android-App

## Basic Information

- **Project Name**: 内容展示框安卓App
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-17
- **Last Updated**: 2025-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 内容展示盒安卓应用

这是一个内容展示盒的安卓应用程序，主要用于展示Web内容。该项目包含一个Android应用和一个Web播放服务器。

## 项目结构

```
.
├── app                 # Android应用源代码
│   └── src
│       └── main
│           └── java    # Java/Kotlin源代码
├── Server              # Web播放服务器
│   ├── public          # 静态资源目录
│   ├── routes          # API路由
│   ├── middleware      # 中间件
│   └── config          # 配置文件
```

## 功能特性

- **Web内容展示**：通过WebView展示Web内容
- **资源下载管理**：支持离线资源下载和管理
- **全屏模式**：提供沉浸式全屏浏览体验
- **响应式布局**：适配不同屏幕尺寸和方向变化
- **服务器集成**：与Web播放服务器集成，支持动态内容加载

## 安装和运行

### Android应用

1. 克隆仓库
```bash
git clone https://gitee.com/lonely-shadow/content-display-box-android-App.git
```

2. 使用Android Studio打开项目
3. 连接Android设备或使用模拟器
4. 点击"Run"按钮构建并安装应用

### Web播放服务器

1. 进入Server目录
```bash
cd Server
```

2. 安装依赖
```bash
npm install
```

3. 启动服务器
```bash
npm start
```

或使用Docker:
```bash
docker-compose up -d
```

## 使用说明

1. 打开应用后，会自动进入加载界面
2. 应用会检查并下载必要的离线资源
3. 资源下载完成后，自动进入主界面
4. 在主界面中，可以通过点击书本图标浏览不同内容
5. 使用悬浮按钮可以返回主页
6. 支持横竖屏切换，自动调整布局

## API接口

服务器提供以下API接口：

- `/api/static` - 静态资源访问
- `/api/version` - 版本信息查询
- 其他自定义API请查看Server/routes目录下的路由文件

## 配置说明

- 应用配置：在AndroidManifest.xml中配置应用基本信息
- 服务器配置：在Server/config目录下配置服务器参数
- 环境变量：通过.env文件配置环境变量

## 贡献指南

欢迎贡献代码和改进建议。请遵循以下步骤：

1. Fork仓库
2. 创建新分支
3. 提交代码更改
4. 创建Pull Request

## 许可证

本项目采用MIT许可证。详情请查看项目根目录下的LICENSE文件。