FindMaimaiUltra

FindMaimaiUltra 是一个 Android 应用程序，用于查询和展示 Maimai（舞萌）游戏的成绩数据。它提供了丰富的功能，包括成绩查询、歌曲成绩展示、地图功能、搜索和排序功能等。

特性

• 成绩查询：从服务器获取用户的成绩数据。
• 歌曲成绩展示：以列表形式展示用户的歌曲成绩，并提供详细信息。
• 地图功能：展示 Maimai 机厅的位置信息。
• 搜索功能：根据歌曲名称搜索特定歌曲的成绩。
• 排序功能：按分数对歌曲成绩进行排序。
• 更新功能：从服务器更新最新的成绩数据。

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/Spaso1/FindMaimaiDX_Phone.git cd FindMaimaiUltra

2. 打开项目：

   • 打开 Android Studio。
   • 导入项目文件夹 FindMaimaiUltra。

3. 配置项目依赖项：

   • 确保项目依赖项已正确配置。主要依赖项包括：
     • Glide: 用于图片加载。
     • OkHttp: 用于网络请求。
     • Gson: 用于 JSON 解析。
     • 其他依赖项请参考 build.gradle 文件。

4. 构建和运行项目：

   • 在 Android Studio 中点击 Build -> Rebuild Project。
   • 连接 Android 设备或启动模拟器。
   • 点击 Run 按钮运行项目。

使用说明

1. 绑定机器人账号：

   • 打开应用后，首先需要绑定机器人账号以获取成绩数据。

2. 更新数据：

   • 点击右下角的 FloatingActionButton，选择“更新数据”选项。

3. 分数排序：

   • 点击右下角的 FloatingActionButton，选择“分数排序”选项。

4. 搜索指定歌曲：

   • 点击右下角的 FloatingActionButton，选择“搜索指定歌曲”选项。

5. 查看歌曲详情：

   • 在歌曲成绩列表中点击某首歌曲，将弹出详细信息对话框。

排卡功能开发

目前Host: https://mais.godserver.cn

队列第一第二是上级位置

功能描述	请求方式	请求 URL	参数说明	返回值示例
获取party的排卡队列	GET	/api/mai/v1/party?party={party}	party: 房间名称	["a1","a2","a3"}]
排卡	POST	/api/mai/v1/party?party={party}&people={people}	party: 房间名称 people:排卡名称	["a1","a2","a3"}]
排卡插队位置	PUT	/api/mai/v1/party?party={party}&people={people}&changeToPeople={changeToPeople}	party: 房间名称 people:排卡名称 changeToPeople:插队对象名称	["a1","a2","a3"}]
退勤	DELETE	/api/mai/v1/party?party={party}&people={people}	party: 房间名称 people:排卡名称	["a1","a2","a3"}]
完成一次上机	POST	/api/mai/v1/partyPlay?party={party}	party: 房间名称	["a2","a3","a1"}]

依赖项

• com.google.android.gms:play-services-location:21.0.1
• androidx.appcompat:appcompat:1.6.1
• com.google.android.material:material:1.9.0
• androidx.recyclerview:recyclerview:1.3.2
• junit:junit:4.13.2
• androidx.test.ext:junit:1.1.5
• com.otaliastudios:zoomlayout:1.9.0
• androidx.work:work-runtime:2.7.1
• androidx.test.espresso:espresso-core:3.5.1
• com.squareup.okhttp3:okhttp:4.9.1
• com.google.code.gson:gson:2.8.8
• com.github.bumptech.glide:glide:4.12.0
• com.github.bumptech.glide:compiler:4.12.0
• org.nanohttpd:nanohttpd:2.2.0
• com.baidu.lbsyun:BaiduMapSDK_Map:7.6.3
• com.squareup.retrofit2:retrofit:2.9.0
• com.squareup.retrofit2:converter-gson:2.9.0
• org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.1
• com.journeyapps:zxing-android-embedded:4.3.0
• com.github.yalantis:ucrop:2.2.8
• com.github.chrisbanes:PhotoView:2.3.0
• androidx.appcompat:appcompat:1.6.1
• com.google.android.material:material:1.8.0
• androidx.constraintlayout:constraintlayout:2.1.4
• androidx.navigation:navigation-fragment:2.5.3
• androidx.navigation:navigation-ui:2.5.3
• jp.wasabeef:glide-transformations:4.3.0

贡献指南

提交问题和功能请求

• 如果你发现任何问题或有功能建议，请在 Issues 页面提交问题或功能请求。

贡献代码

创建 Pull Request：

• 在 GitHub 页面上，点击 Compare & pull request 按钮。
• 填写 Pull Request 描述并提交。

许可证

本项目遵循 MIT 许可证。详细信息请参考 LICENSE 文件。

项目地址

• GitHub 项目地址

开发者

• Spaso1 欢迎合作或者提意见！