Skip to content

区域

区域(日语:ちほー,中文:区域)是自 maimai でらっくす 起引入的概念,指的是游戏中的跑图区域。

区域中包含了可解锁的旅行伙伴、收藏品,以及课题曲等相关内容。

image.png

maimai.areas() 方法

通过 maimai.areas() 方法可以获取区域的封装对象,以 MaimaiAreas 的形式返回。

阅读 MaimaiAreas 定义,可以了解获取单个区域、遍历所有区域等方法。

参考 Area 模型,可以了解具体数据结构。

INFO

maimai.areas() 方法可以提供 lang 参数来指定语言,默认为 jp (日语),可选值包括:(jp, zh)。

目前的区域数据来自于本地 JSON 文件,如果你希望更新或贡献区域数据,请参考 CONTRIBUTING.md

通过 ID 获取区域

python
areas = await maimai.areas()
heaven4 = await areas.by_id("heaven4")
assert heaven4 is not None
print(heaven4.name)  # 天界ちほー4
print(heaven4.description)  # ……この身は穢れ、もう天界には戻れない。

遍历所有区域

python
areas = await maimai.areas()
all_areas = [area.name for area in await areas.get_all()]
print(all_areas) # ['天界ちほー1', '天界ちほー2', '天界ちほー3', '天界ちほー4', ...]

MIT License