# android五子棋

**Repository Path**: pgh1038/android-gobang

## Basic Information

- **Project Name**: android五子棋
- **Description**: 安卓五子棋，安卓课程大作业
- **Primary Language**: Android
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://panghai.top
- **GVP Project**: No

## Statistics

- **Stars**: 12
- **Forks**: 0
- **Created**: 2022-06-19
- **Last Updated**: 2024-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Android, APP, 五子棋

## README

# android五子棋

#### 介绍

安卓五子棋，安卓课程大作业

仓库地址https://gitee.com/pgh1038/android-gobang.git

#### 软件架构
##### 顶层数据流图

![](assets/顶层数据流图.png)

##### 1层数据流图

![1层数据流图](assets/1层数据流图.png)

##### ELO等级分计算原理

参考：https://www.xqbase.com/protocol/elostat.htm

![ELO等级分计算原理](assets/ELO等级分计算原理.png)

##### 匹配机制

![匹配机制](assets/匹配机制.png)

匹配算法

![匹配算法](assets/匹配算法.png)

##### 对战机制

![对战机制](assets/对战机制.png)

##### 技术实现

后端：
1.  spring-boot-starter-websocket，使用session保存连接用户状态和发送消息
2.  使用ELO匹配机制计算等级分，根据等级分匹配用户

Android：
1.  OkHttps，使用Thread创建子线程网络请求，使用Handler更新UI
2.  ListView，使用适配器渲染listview列表来展示用户积分


#### 安装教程

1. 下载后台代码：https://gitee.com/pgh1038/gobang.git

2. 配置好端口和数据库账号密码，打包发送到服务器

   ![端口和数据库账号密码匹配](assets/端口和数据库账号密码匹配.png)

3. 配置头像接口，下载代码：https://gitee.com/pgh1038/Multiavatar.git，同样配置好端口发送服务器运行即可。

   头像接口访问格式：http://ip:8095/头像名称.png

4. 下载安卓代码：https://gitee.com/pgh1038/android-gobang.git

5. 修改后台接口配置，去到top.panghai.fifthchess.config包下的OkHttpsConfig.java修改DefaultUrl为上面的接口

   ![接口配置](assets/接口配置.png)

6. 修改头像接口配置，全局修改remoteAvatarUrl为上面的接口（有多个remoteAvatarUrl，都需要修改）

   ![头像接口](assets/头像接口.png)

7. 调试运行即可

#### 使用说明

##### 主页

![主页](assets/主页.png)

##### 人机对战

![人机对战](assets/人机对战.png)

##### 玩家对战

![玩家对战](assets/玩家对战.png)

##### 积分排行

![积分排行](assets/积分排行.png)

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request