# RoamAndroid

**Repository Path**: thedq/roam-android

## Basic Information

- **Project Name**: RoamAndroid
- **Description**: RoamAndroid
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2021-10-19
- **Last Updated**: 2025-04-12

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

### 谷歌学生发展项目-旅蜀道安卓软件前端源码

### 项目介绍


本项目通过漫画式的情景游戏和景点论坛，向旅客提供四川省内各个景区的旅游指南以及当地流行的风尚习俗。在每个景区的模块内，通过景点人物的对话以及游戏向旅客介绍当前景点，让旅客充分了解这个景区的民俗文化以及优美的风景。

### 项目功能


一、普通用户功能

1、用户注册：

填写邮箱和密码后，通过邮箱验证码激活邮箱，此时注册成功返回首页

2、用户登录：

按照注册好的邮箱和密码登录，第一次登录用户需填写用户名，选择头像和景点精灵，并通过选择性别和性格,生成独特的虚拟形象。

1）选择头像和景点精灵。

头像:
用户可以选择本APP提供的多种不同的民俗风格的头像或选择用户相册中的图片作为头像。
景点精灵:
当用户使用此APP时，景点精灵将出现在界面与用户进行互动,增加用户的乐趣。

2）选择性别,性格,生成独特的虚拟形象。 

当用户第一次使用此APP时,需要选择性别和本APP提供的多个性格标签。根据选择结果，为用户生成独一无二的虚拟人物角色。并在后续的景点游戏中用户会使用此角色参与游戏。

3、个人资料修改：

用户可以在个人中心中修改个人资料，包括修改用户名、头像和景点精灵；当用户选择新的性别和性格后，会重新生成新的虚拟形象。

4、景点精灵：

点击景点精灵会出现APP使用指南, 民俗普及, 旅蜀道论坛等气泡框。

1) APP使用指南:

用户可以再次进入APP引导界面和帮助界面。

2)民俗普及:

用户可以选择感兴趣的景点了解对应的民俗科普知识。

3）旅蜀道论坛：

分为官方和广场两个模块。官方模块包括景点介绍板块、民俗科普板块、旅游指南板块；广场模块是用户交流板块，所有用户的发帖都会呈现在此。

（1）官方模块：

景点介绍板块:
对景点的风景和民俗提供大致的介绍。
民俗科普板块:
本APP显示的民俗科普,由所有用户通过点赞和留言判断此条科普是否正确。通过此方式让用户自发地参与到景点的民俗科普。
旅游指南板块:
本APP提供的旅游指南,通过所有用户的点赞,留言等信息让用户自行判断最适合自己的旅游指南。

（2）广场模块

用户可以在其中和全球用户进行互动,和志同道合的朋友一起交流讨论。

5、景点地图：

用户点击地图上的景点即可进入情景游戏中,在游戏中通过操作自己的虚拟人物去与景点人物对话,了解相关的风景和民俗。并且在对话过程中穿插了抢红包、捉妖、会飞的小鸟等小游戏，通过参与游戏加深用户的体验感.在通过景点游戏后,用户将点亮相应的景点徽章。
### 安装教程


1. 下载软件源码，使用Andriod Studio打开
2. 导入软件所需依赖后，使用真机或虚拟机启动软件即可

### 软件架构


1. java目录说明
   1.1 api存放接口
1.2 game存放景点游戏
1.3 model存放实体类
1.4 ui存放ui界面设计
1.5 utils 存放工具类
1.6 view 存放公共的界面
2. res目录说明
   2.1 anim存放动画资源
2.2 drawable和mipmap存放图片资源
2.3 layout存放布局资源
2.4 menu存放菜单资源
2.5 values存放字符串、颜色等资源
2.6 navigation存放公共页面资源

### 参与贡献

邓情、陈威、李德慧