- Notifications
You must be signed in to change notification settings - Fork7
用于国服舞萌相关开发的最佳Python工具库, 封装水鱼/落雪查分器常用函数.
License
TrueRou/maimai.py
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
maimai.py (文档)
用于国服舞萌相关开发的最佳Python工具库, 封装水鱼/落雪查分器常用函数.
提供了基于日服舞萌标准的数据模型和接口, 为水鱼和落雪分别做了数据源实现.
支持从数据源查询歌曲、谱面、玩家信息、分数、Rating、姓名框、牌子进度.
另外, 支持联动微信 OpenID 获取玩家分数, 解析分数HTML, 并上传至数据源.
pip install maimai-py
升级方式:
pip install -U maimai-py
另外, 您也可以下载 maimai.py 客户端, 使用任何编程语言进行开发.
importasynciofrommaimai_pyimportMaimaiClient,MaimaiPlates,MaimaiScores,MaimaiSongs,PlayerIdentifier,DivingFishProvider# 全局创建 MaimaiClient 实例maimai=MaimaiClient()divingfish=DivingFishProvider(developer_token="your_token_here")asyncdefquick_start():# 获取所有歌曲及其元数据songs:MaimaiSongs=awaitmaimai.songs()# 获取水鱼查分器用户 turou 的分数scores:MaimaiScores=awaitmaimai.scores(PlayerIdentifier(username="turou"),provider=divingfish)# 获取水鱼查分器用户 turou 的舞将牌子信息plates:MaimaiPlates=awaitmaimai.plates(PlayerIdentifier(username="turou"),"舞将",provider=divingfish)song=awaitsongs.by_id(1231)# 生命不詳 by 蜂屋ななしprint(f"歌曲 1231 是:{song.artist} -{song.title}")print(f"TuRou 的 Rating 为:{scores.rating}, b15 中最高 Rating 为:{scores.scores_b15[0].dx_rating}")print(f"TuRou 的 舞将 完成度:{awaitplates.count_cleared()}/{awaitplates.count_all()}")asyncio.run(quick_start())
更多内容请查看文档:https://maimai.turou.fun/.
maimai.py 默认采用全异步, 且暂时没有提供同步方法和接口的计划.
如果您不希望采用异步, 可以使用asyncio.run
包裹方法, 将异步方法同步调用.
maimai.py 提供了 RESTful API 客户端, 您可以通过任何语言通过HTTP请求来调用 maimai.py 的特性.
客户端使用 Nuitka 编译, 请在Releases 页面下载.
我们的客户端支持 Windows, Linux, 请根据您的系统下载对应的版本.
客户端 Swagger 文档请查看:https://openapi.maimai.turou.fun/.
如果您想要贡献代码, 请阅读CONTRIBUTING.md
About
用于国服舞萌相关开发的最佳Python工具库, 封装水鱼/落雪查分器常用函数.
Topics
Resources
License
Code of conduct
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Uh oh!
There was an error while loading.Please reload this page.
Contributors5
Uh oh!
There was an error while loading.Please reload this page.