ecard module

ecard module#

class ecard.eCard(parent)[源代码]#

基类：object

初始化 eCard 实例

参数:

parent – 父对象

get_balance() → float[源代码]#

获取校园卡余额

返回:

校园卡余额

返回类型:

float

async get_balance_async() → float[源代码]#

异步获取校园卡余额

返回:

校园卡余额

返回类型:

float

get_default_room() → str[源代码]#

获取账户默认房间

返回:

默认的房间

async get_default_room_async() → str[源代码]#

异步获取账户默认房间

返回:

默认的房间

get_remaining_energy(room: str | None = None) → float[源代码]#

获取剩余电量

参数:

room (str) – 房间 ID 。格式应为 ‘areaid-buildingid–unitid-roomid’，可通过 get_room_dict() 获取

返回:

剩余能源

返回类型:

float

async get_remaining_energy_async(room: str | None = None) → float[源代码]#

异步获取剩余电量

参数:

room (str) – 房间 ID 。格式应为 ‘areaid-buildingid–unitid-roomid’，可通过 get_room_dict() 获取

返回:

剩余能源

返回类型:

float

get_remaining_power(room: str | None = None) → float[源代码]#

获取剩余电量

已被废弃，请使用 get_remaining_energy()

参数:

room (str) – 房间 ID 。格式应为 ‘areaid-buildingid–unitid-roomid’，可通过 get_room_dict() 获取

返回:

剩余能源

返回类型:

float

get_room_dict(id: str) → dict[源代码]#

获取房间的字典

参数:

id (str) – 已知房间 ID 。例如: ‘’, ‘99’, ‘99-12’, ‘99-12–33’

返回:

对应的字典

返回类型:

dict

async get_room_dict_async(id: str) → dict[源代码]#

异步获取房间的字典

参数:

id (str) – 已知房间 ID 。例如: ‘’, ‘99’, ‘99-12’, ‘99-12–33’

返回:

对应的字典

返回类型:

dict

async init_async()[源代码]#

异步初始化 eCard 实例

recharge_electricity(payment_password: str, amt: int, room: str | None = None) → Tuple[bool, str][源代码]#

为 room 充值电费

已被废弃，请使用 recharge_energy()

参数:

  • room (str) – 房间 ID 。格式应为 ‘areaid-buildingid–unitid-roomid’，可通过 get_room_dict() 获取

  • payment_password (str) – 支付密码

  • amt (int) – 充值金额

返回:

Tuple[bool, str]

  • success (bool) – 充值是否成功

  • msg (str) – 服务端返回信息。

返回类型:

Tuple[bool,str]

async recharge_electricity_async(payment_password: str, amt: int, room: str | None = None) → Tuple[bool, str][源代码]#

异步为 room 充值电费

已被废弃，请使用 recharge_energy_async()

参数:

  • room (str) – 房间 ID 。格式应为 ‘areaid-buildingid–unitid-roomid’，可通过 get_room_dict() 获取

  • payment_password (str) – 支付密码

  • amt (int) – 充值金额

返回:

Tuple[bool, str]

  • success (bool) – 充值是否成功

  • msg (str) – 服务端返回信息。

返回类型:

Tuple[bool,str]

recharge_energy(payment_password: str, amt: int, room: str | None = None) → Tuple[bool, str][源代码]#

为 room 充值电费

参数:

  • room (str) – 房间 ID 。格式应为 ‘areaid-buildingid–unitid-roomid’，可通过 get_room_dict() 获取

  • payment_password (str) – 支付密码

  • amt (int) – 充值金额

返回:

Tuple[bool, str]

  • success (bool) – 充值是否成功

  • msg (str) – 服务端返回信息。

返回类型:

Tuple[bool,str]

async recharge_energy_async(payment_password: str, amt: int, room: str | None = None) → Tuple[bool, str][源代码]#

异步为 room 充值电费

参数:

  • room (str) – 房间 ID 。格式应为 ‘areaid-buildingid–unitid-roomid’，可通过 get_room_dict() 获取

  • payment_password (str) – 支付密码

  • amt (int) – 充值金额

返回:

Tuple[bool, str]

  • success (bool) – 充值是否成功

  • msg (str) – 服务端返回信息。

返回类型:

Tuple[bool,str]

async start_token_refresh_loop()[源代码]#

启动异步的 token 刷新循环

目录