mijiaAPI 1.4.5__tar.gz → 2.0.0__tar.gz

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mijiaAPI
-Version: 1.4.5
+Version: 2.0.0
 Summary: A Python API for Xiaomi Mijia
 License: GPLv3
 Author: Do1e
@@ -30,6 +30,12 @@ Description-Content-Type: text/markdown
 [![PyPI](https://img.shields.io/badge/PyPI-mijiaAPI-blue)](https://pypi.org/project/mijiaAPI/)
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-green.svg)](https://opensource.org/licenses/GPL-3.0)
 
+## ⚠️ 重要提醒
+
+**自 v1.5.0 版本以来，本项目包含多项破坏性变更！**
+
+如果您正在从旧版本升级，请务必查看 [CHANGELOG.md](CHANGELOG.md) 以了解详细的变更内容和迁移指南。
+
 ## 安装
 
 ### 从 PyPI 安装（推荐）
@@ -53,6 +59,13 @@ pip install .
 poetry install
 ```
 
+### aur
+如果你使用 Arch Linux 或基于 Arch 的发行版，可以通过 AUR 安装：
+
+```bash
+yay -S python-mijia-api
+```
+
 ## 使用
 
 使用实例可以参考 `demos` 文件夹下的示例代码，以下是基本使用说明。
@@ -84,15 +97,18 @@ poetry install
 
 #### 设备与场景获取与控制：
 
+下述方法可参考 [demos/test_apis.py](demos/test_apis.py) 中的示例。
+
 * `get_devices_list() -> list`：获取设备列表
 * `get_homes_list() -> list`：获取家庭列表（包含房间信息）
 * `get_scenes_list(home_id: str) -> list`：获取手动场景列表
   - 在米家 App 中通过 **米家→添加→手动控制** 设置
 * `run_scene(scene_id: str) -> bool`：运行指定场景
-* `get_consumable_items(home_id: str) -> list`：获取设备的耗材信息
+* `get_consumable_items(home_id: str, owner_id: Optional[int] = None) -> list`：获取设备的耗材信息，如果是共享家庭，需要额外指定 `owner_id` 参数
 * `get_devices_prop(data: list) -> list`：获取设备属性
 * `set_devices_prop(data: list) -> list`：设置设备属性
 * `run_action(data: dict) -> dict`：执行设备的特定动作
+* `get_statistics(data: dict) -> list`：获取设备的统计信息，如空调每个月的耗电量，参考 [demos/test_get_statistics.py](demos/test_get_statistics.py)
 
 设备属性和动作的相关参数（`siid`, `piid`, `aiid`）可以从 [米家产品库](https://home.miot-spec.com) 查询：
 * 访问 `https://home.miot-spec.com/spec/{model}`（`model` 在设备列表中获取）
@@ -115,12 +131,12 @@ device_info = get_device_info('yeelink.light.lamp4')  # 米家台灯 1S 的 mode
 
 ### 设备控制封装
 
-`mijiaDevices`：基于 `mijiaAPI` 的高级封装，提供更简便的设备控制方式。
+`mijiaDevice`：基于 `mijiaAPI` 的高级封装，提供更简便的设备控制方式。
 
 #### 初始化：
 
 ```python
-mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: str = None, sleep_time: float = 0.5)
+mijiaDevice(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: str = None, sleep_time: float = 0.5)
 ```
 
 * `api`：已初始化的 `mijiaAPI` 对象
@@ -138,9 +154,9 @@ mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: st
 
 #### 使用方法控制：
 
-* `set(name: str, did: str, value: Union[bool, int]) -> bool`：设置设备属性
-* `get(name: str, did: str) -> Union[bool, int, float, str]`：获取设备属性
-* `run_action(name: str, did: str = None, value: Any = None, **kwargs) -> bool`：执行设备动作
+* `set(name: str, value: Union[bool, int, float, str], did: Optional[str] = None) -> bool`：设置设备属性
+* `get(name: str, did: Optional[str] = None) -> Union[bool, int, float, str]`：获取设备属性
+* `run_action(name: str, did: Optional[str] = None, value: Optional[Union[list, tuple]] = None, **kwargs) -> bool`：执行设备动作
 
 #### 属性样式访问：
 
@@ -148,7 +164,7 @@ mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: st
 
 ```python
 # 示例：控制台灯
-device = mijiaDevices(api, dev_name='台灯')
+device = mijiaDevice(api, dev_name='台灯')
 device.on = True                 # 打开灯
 device.brightness = 60           # 设置亮度
 current_temp = device.color_temperature  # 获取色温
@@ -248,6 +264,23 @@ mijiaAPI --run 明天天气如何
 mijiaAPI --run 打开台灯并将亮度调至最大 --quiet
 ```
 
+## 常见问题
+
+### 账号密码登录失败
+
+现在登录似乎100%遇到验证码，建议使用扫码登录。
+
+### XXX设备的XXX如何获取/设置
+
+我拥有的设备有限，无法保证能解答这类问题，但也欢迎提交 [issue](https://github.com/Do1e/mijia-api/issues)，可能需要你将设备共享给我进行抓包或者自行抓包给我提供请求和响应，提供har文件的话注意自行删除cookie等敏感信息。
+
+### 如何抓包
+
+小米官方给了一个[抓包教程](https://iot.mi.com/new/doc/accesses/direct-access/extension-development/troubleshooting/packet_capture)，我没试过，不确定是否能行，如果抓包成功数据是加密的，可以使用 [demos/decrypt.py](demos/decrypt.py) 解密。
+
+我自己的解决方案是使用一个获取了root的手机，安装 [reqable](https://reqable.com/zh-CN/) 进行抓包，导出 HAR 文件后使用 [demos/decrypt_har.py](demos/decrypt_har.py) 解密。
+
+
 ## 致谢
 
 * [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/README.md

@@ -6,6 +6,12 @@
 [![PyPI](https://img.shields.io/badge/PyPI-mijiaAPI-blue)](https://pypi.org/project/mijiaAPI/)
 [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-green.svg)](https://opensource.org/licenses/GPL-3.0)
 
+## ⚠️ 重要提醒
+
+**自 v1.5.0 版本以来，本项目包含多项破坏性变更！**
+
+如果您正在从旧版本升级，请务必查看 [CHANGELOG.md](CHANGELOG.md) 以了解详细的变更内容和迁移指南。
+
 ## 安装
 
 ### 从 PyPI 安装（推荐）
@@ -29,6 +35,13 @@ pip install .
 poetry install
 ```
 
+### aur
+如果你使用 Arch Linux 或基于 Arch 的发行版，可以通过 AUR 安装：
+
+```bash
+yay -S python-mijia-api
+```
+
 ## 使用
 
 使用实例可以参考 `demos` 文件夹下的示例代码，以下是基本使用说明。
@@ -60,15 +73,18 @@ poetry install
 
 #### 设备与场景获取与控制：
 
+下述方法可参考 [demos/test_apis.py](demos/test_apis.py) 中的示例。
+
 * `get_devices_list() -> list`：获取设备列表
 * `get_homes_list() -> list`：获取家庭列表（包含房间信息）
 * `get_scenes_list(home_id: str) -> list`：获取手动场景列表
   - 在米家 App 中通过 **米家→添加→手动控制** 设置
 * `run_scene(scene_id: str) -> bool`：运行指定场景
-* `get_consumable_items(home_id: str) -> list`：获取设备的耗材信息
+* `get_consumable_items(home_id: str, owner_id: Optional[int] = None) -> list`：获取设备的耗材信息，如果是共享家庭，需要额外指定 `owner_id` 参数
 * `get_devices_prop(data: list) -> list`：获取设备属性
 * `set_devices_prop(data: list) -> list`：设置设备属性
 * `run_action(data: dict) -> dict`：执行设备的特定动作
+* `get_statistics(data: dict) -> list`：获取设备的统计信息，如空调每个月的耗电量，参考 [demos/test_get_statistics.py](demos/test_get_statistics.py)
 
 设备属性和动作的相关参数（`siid`, `piid`, `aiid`）可以从 [米家产品库](https://home.miot-spec.com) 查询：
 * 访问 `https://home.miot-spec.com/spec/{model}`（`model` 在设备列表中获取）
@@ -91,12 +107,12 @@ device_info = get_device_info('yeelink.light.lamp4')  # 米家台灯 1S 的 mode
 
 ### 设备控制封装
 
-`mijiaDevices`：基于 `mijiaAPI` 的高级封装，提供更简便的设备控制方式。
+`mijiaDevice`：基于 `mijiaAPI` 的高级封装，提供更简便的设备控制方式。
 
 #### 初始化：
 
 ```python
-mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: str = None, sleep_time: float = 0.5)
+mijiaDevice(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: str = None, sleep_time: float = 0.5)
 ```
 
 * `api`：已初始化的 `mijiaAPI` 对象
@@ -114,9 +130,9 @@ mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: st
 
 #### 使用方法控制：
 
-* `set(name: str, did: str, value: Union[bool, int]) -> bool`：设置设备属性
-* `get(name: str, did: str) -> Union[bool, int, float, str]`：获取设备属性
-* `run_action(name: str, did: str = None, value: Any = None, **kwargs) -> bool`：执行设备动作
+* `set(name: str, value: Union[bool, int, float, str], did: Optional[str] = None) -> bool`：设置设备属性
+* `get(name: str, did: Optional[str] = None) -> Union[bool, int, float, str]`：获取设备属性
+* `run_action(name: str, did: Optional[str] = None, value: Optional[Union[list, tuple]] = None, **kwargs) -> bool`：执行设备动作
 
 #### 属性样式访问：
 
@@ -124,7 +140,7 @@ mijiaDevices(api: mijiaAPI, dev_info: dict = None, dev_name: str = None, did: st
 
 ```python
 # 示例：控制台灯
-device = mijiaDevices(api, dev_name='台灯')
+device = mijiaDevice(api, dev_name='台灯')
 device.on = True                 # 打开灯
 device.brightness = 60           # 设置亮度
 current_temp = device.color_temperature  # 获取色温
@@ -224,6 +240,23 @@ mijiaAPI --run 明天天气如何
 mijiaAPI --run 打开台灯并将亮度调至最大 --quiet
 ```
 
+## 常见问题
+
+### 账号密码登录失败
+
+现在登录似乎100%遇到验证码，建议使用扫码登录。
+
+### XXX设备的XXX如何获取/设置
+
+我拥有的设备有限，无法保证能解答这类问题，但也欢迎提交 [issue](https://github.com/Do1e/mijia-api/issues)，可能需要你将设备共享给我进行抓包或者自行抓包给我提供请求和响应，提供har文件的话注意自行删除cookie等敏感信息。
+
+### 如何抓包
+
+小米官方给了一个[抓包教程](https://iot.mi.com/new/doc/accesses/direct-access/extension-development/troubleshooting/packet_capture)，我没试过，不确定是否能行，如果抓包成功数据是加密的，可以使用 [demos/decrypt.py](demos/decrypt.py) 解密。
+
+我自己的解决方案是使用一个获取了root的手机，安装 [reqable](https://reqable.com/zh-CN/) 进行抓包，导出 HAR 文件后使用 [demos/decrypt_har.py](demos/decrypt_har.py) 解密。
+
+
 ## 致谢
 
 * [janzlan/mijia-api](https://gitee.com/janzlan/mijia-api/tree/master)

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/mijiaAPI/__init__.py

@@ -1,3 +1,3 @@
 from .login import mijiaLogin
 from .apis import mijiaAPI
-from .devices import mijiaDevices, get_device_info
+from .devices import mijiaDevice, get_device_info

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/mijiaAPI/__main__.py

@@ -6,7 +6,7 @@ import sys
 import time
 
 from .apis import mijiaAPI
-from .devices import mijiaDevices, get_device_info
+from .devices import mijiaDevice, get_device_info
 from .login import mijiaLogin
 
 def parse_args(args):
@@ -146,10 +146,6 @@ def init_api(auth_path: str) -> mijiaAPI:
 
 def get_devices_list(api: mijiaAPI, verbose: bool = True) -> dict:
     devices = api.get_devices_list()
-    if 'list' in devices:
-        devices = devices['list']
-    else:
-        devices = []
     if verbose:
         print("Devices:")
         for device in devices:
@@ -165,10 +161,6 @@ def get_homes_list(api: mijiaAPI, verbose: bool = True, device_mapping: Optional
         if device_mapping is None:
             device_mapping = get_devices_list(api, verbose=False)
     homes = api.get_homes_list()
-    if 'homelist' in homes:
-        homes = homes['homelist']
-    else:
-        homes = []
     if verbose:
         print("Homes:")
         for home in homes:
@@ -189,7 +181,7 @@ def get_homes_list(api: mijiaAPI, verbose: bool = True, device_mapping: Optional
                 dids = ', '.join(devices_name)
                 print(f"    - {room['name']}\n"
                       f"      id: {room['id']}\n"
-                      f"      dids: {dids}\n"
+                      f"      devices: {dids}\n"
                       f"      create time: {time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(room['create_time']))}")
     home_mapping = {home['id']: home for home in homes}
     return home_mapping
@@ -200,10 +192,6 @@ def get_scenes_list(api: mijiaAPI, verbose: bool = True, home_mapping: Optional[
     scene_mapping = {}
     for home_id, home in home_mapping.items():
         scenes = api.get_scenes_list(home_id)
-        if 'scene_info_list' in scenes:
-            scenes = scenes['scene_info_list']
-        else:
-            scenes = []
         if scenes and verbose:
             print(f"Scenes in {home['name']} ({home_id}):")
             for scene in scenes:
@@ -218,15 +206,12 @@ def get_consumable_items(api: mijiaAPI, home_mapping: Optional[dict] = None):
     if home_mapping is None:
         home_mapping = get_homes_list(api, verbose=False)
     for home_id, home in home_mapping.items():
-        items = api.get_consumable_items(home_id)
-        if 'items' in items:
-            items = items['items'][0]['consumes_data']
-        else:
-            items = []
+        items = api.get_consumable_items(home_id, home['uid'])
         print(f"Consumable items in {home['name']} ({home_id}):")
         for item in items:
-            print(f"  - {item['details'][0]['description']} in {item['name']}({item['did']})\n"
-                  f"    value: {item['details'][0]['value']}")
+            for consumes_data in item['consumes_data']:
+                print(f"  - {consumes_data['details'][0]['description']} in {consumes_data['name']}({consumes_data['did']})\n"
+                    f"    value: {consumes_data['details'][0]['value']}")
 
 def run_scene(api: mijiaAPI, scene_id: str, scene_mapping: Optional[dict] = None) -> bool:
     if scene_mapping is None:
@@ -253,15 +238,15 @@ def run_scene(api: mijiaAPI, scene_id: str, scene_mapping: Optional[dict] = None
 
 def get(args):
     api = init_api(args.auth_path)
-    device = mijiaDevices(api, dev_name=args.dev_name)
+    device = mijiaDevice(api, dev_name=args.dev_name)
     value = device.get(args.prop_name)
     unit = device.prop_list[args.prop_name].unit
     print(f"The {args.prop_name} of {args.dev_name} is {value} {unit if unit else ''}")
 
 def set(args):
     api = init_api(args.auth_path)
-    device = mijiaDevices(api, dev_name=args.dev_name)
-    ret = device.set_v2(args.prop_name, args.value)
+    device = mijiaDevice(api, dev_name=args.dev_name)
+    ret = device.set(args.prop_name, args.value)
     unit = device.prop_list[args.prop_name].unit
     if ret:
         print(f"The {args.prop_name} of {args.dev_name} is set to {args.value} {unit if unit else ''}")
@@ -307,12 +292,12 @@ def main(args):
             wifispeaker = None
             for device in device_mapping.values():
                 if 'xiaomi.wifispeaker' in device['model']:
-                    wifispeaker = mijiaDevices(api, dev_name=device['name'])
+                    wifispeaker = mijiaDevice(api, dev_name=device['name'])
                     break
             if wifispeaker is None:
                 raise ValueError("No wifispeaker found")
         else:
-            wifispeaker = mijiaDevices(api, dev_name=args.wifispeaker_name)
+            wifispeaker = mijiaDevice(api, dev_name=args.wifispeaker_name)
         wifispeaker.run_action('execute-text-directive', _in=[args.run, args.quiet])
     if hasattr(args, 'func') and args.func is not None:
         if args.func == 'get':

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/mijiaAPI/apis.py

@@ -1,5 +1,5 @@
 from datetime import datetime
-from typing import Union
+from typing import Union, Optional
 
 import requests
 import requests.cookies
@@ -53,16 +53,30 @@ class mijiaAPI(object):
             return True
         return False
 
-    def get_devices_list(self) -> dict:
+    def get_devices_list(self) -> list:
         """
         获取设备列表。
 
         Returns:
             dict: 设备列表。
         """
-        uri = '/home/device_list'
-        data = {"getVirtualModel": False, "getHuamiDevices": 0}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+        uri = '/home/home_device_list'
+        home_list = self.get_homes_list()
+        devices = []
+        for home in home_list:
+            data = {
+                "home_owner": home['uid'],
+                "home_id": int(home['id']),
+                "limit": 200,
+                "get_split_device": True,
+                "support_smart_home": True,
+                "get_cariot_device": True,
+                "get_third_device": True
+            }
+            ret = self._post_process(post_data(self.session, self.ssecurity, uri, data))
+            if ret and ret.get('device_info'):
+                devices.extend(ret['device_info'])
+        return devices
 
     def get_homes_list(self) -> list:
         """
@@ -71,9 +85,9 @@ class mijiaAPI(object):
         Returns:
             list: 家庭列表，包括房间信息。
         """
-        uri = '/v2/homeroom/gethome'
-        data = {"fg": False, "fetch_share": True, "fetch_share_dev": True, "limit": 300, "app_ver": 7}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+        uri = '/v2/homeroom/gethome_merged'
+        data = {"fg": True, "fetch_share": True, "fetch_share_dev": True, "limit": 300, "app_ver": 7}
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))['homelist']
 
     def get_scenes_list(self, home_id: str) -> list:
         """
@@ -89,7 +103,10 @@ class mijiaAPI(object):
         """
         uri = '/appgateway/miot/appsceneservice/AppSceneService/GetSceneList'
         data = {"home_id": home_id}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+        ret = self._post_process(post_data(self.session, self.ssecurity, uri, data))
+        if ret and 'scene_info_list' in ret:
+            return ret['scene_info_list']
+        return []
 
     def run_scene(self, scene_id: str) -> bool:
         """
@@ -105,19 +122,23 @@ class mijiaAPI(object):
         data = {"scene_id": scene_id, "trigger_key": "user.click"}
         return self._post_process(post_data(self.session, self.ssecurity, uri, data))
 
-    def get_consumable_items(self, home_id: str) -> list:
+    def get_consumable_items(self, home_id: str, owner_id: Optional[int] = None) -> list:
         """
         获取耗材列表。
 
         Args:
             home_id (str): 家庭ID，从get_homes_list获取。
+            owner_id (str, optional): 用户ID，默认为None，如果`home_id`为共享家庭，则需要提供owner_id。
 
         Returns:
             list: 耗材列表。
         """
         uri = '/v2/home/standard_consumable_items'
-        data = {"home_id": int(home_id), "owner_id": self.userId}
-        return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+        data = {"home_id": int(home_id), "owner_id": int(owner_id) if owner_id else self.userId}
+        ret = self._post_process(post_data(self.session, self.ssecurity, uri, data))
+        if ret and 'items' in ret:
+            return ret['items']
+        return []
 
     def get_devices_prop(self, data: list) -> list:
         """
@@ -155,7 +176,7 @@ class mijiaAPI(object):
 
                 示例(yeelink.light.lamp4)：
                 [
-                    {"did": "1234567890", "siid": 2, "piid": 2, "value": 50} # 设置亮度为50%
+                    {"did": "1234567890", "siid": 2, "piid": 2, "value": 50},  # 设置亮度为50%
                     {"did": "1234567890", "siid": 2, "piid": 3, "value": 2700} # 设置色温为2700K
                 ]
 
@@ -178,7 +199,7 @@ class mijiaAPI(object):
                 - value: 参数列表
 
                 示例(xiaomi.feeder.pi2001)：
-                {"did": "1234567890", "siid": 2, "aiid": 1, "value": [2]}, # 远程喂食2份
+                {"did": "1234567890", "siid": 2, "aiid": 1, "value": [2]} # 远程喂食2份
 
         Returns:
             dict: 操作结果。
@@ -186,3 +207,36 @@ class mijiaAPI(object):
         uri = '/miotspec/action'
         data = {"params": data}
         return self._post_process(post_data(self.session, self.ssecurity, uri, data))
+
+    def get_statistics(self, data: dict) -> list:
+        """
+        获取设备的统计信息。
+
+        Args:
+            data (dict): 请求参数，包含以下键：
+                - did: 设备ID，从get_devices_list获取
+                - key: siid.piid，表示要获取统计数据的属性
+                - data_type: 统计类型，可选值包括：
+                    - 'stat_hour_v3': 按小时统计
+                    - 'stat_day_v3': 按天统计
+                    - 'stat_week_v3': 按周统计
+                    - 'stat_month_v3': 按月统计
+                - limit: 返回的最大条目数，可选参数
+                - time_start: 开始时间戳，单位为秒
+                - time_end: 结束时间戳，单位为秒
+
+                示例(lumi.acpartner.mcn04 的 power-consumption)：
+                {
+                    "did": "1234567890",
+                    "key": "7.1",
+                    "data_type": "stat_month_v3",
+                    "limit": 24,
+                    "time_start": 1685548800,
+                    "time_end": 1750694400,
+                } # 2023-06-01 00:00:00 到 2025-06-24 00:00:00 的月度统计数据
+
+        Returns:
+            list: 统计信息列表。
+        """
+        uri = '/v2/user/statistics'
+        return self._post_process(post_data(self.session, self.ssecurity, uri, data))

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/mijiaAPI/devices.py

@@ -74,7 +74,7 @@ class DevAction(object):
         return f'  {self.name}: {self.desc}'
 
 
-class mijiaDevices(object):
+class mijiaDevice(object):
     def __init__(
             self,
             api: mijiaAPI,
@@ -113,7 +113,7 @@ class mijiaDevices(object):
         self.api = api
         if dev_info is None:
             devices_list = self.api.get_devices_list()
-            matches = [device for device in devices_list.get('list', []) if device['name'] == dev_name]
+            matches = [device for device in devices_list if device['name'] == dev_name]
             if not matches:
                 raise ValueError(f"Device {dev_name} not found")
             elif len(matches) > 1:
@@ -152,14 +152,14 @@ class mijiaDevices(object):
                 f"Properties:\n{prop_list_str if prop_list_str else 'No properties available'}\n"
                 f"Actions:\n{action_list_str if action_list_str else 'No actions available'}")
 
-    def set(self, name: str, did: str, value: Union[bool, int, float, str]) -> bool:
+    def set(self, name: str, value: Union[bool, int, float, str], did: Optional[str] = None) -> bool:
         """
         设置设备的属性值。
 
         Args:
             name (str): 属性名称。
-            did (str): 设备ID。
             value (Union[bool, int, float, str]): 属性值。
+            did (str, optional): 设备ID。如未指定，则使用实例化时的did。默认为None。
 
         Returns:
             bool: 执行结果（True/False）。
@@ -168,6 +168,10 @@ class mijiaDevices(object):
             ValueError: 如果属性不存在、属性为只读或值无效。
             RuntimeError: 如果设置属性失败。
         """
+        if did is None:
+            did = self.did
+        if did is None:
+            raise ValueError('Please specify the did')
         if name not in self.prop_list:
             raise ValueError(f'Unsupported property: {name}, available properties: {list(self.prop_list.keys())}')
         prop = self.prop_list[name]
@@ -232,28 +236,6 @@ class mijiaDevices(object):
         logger.debug(f"Set property: {self.name} -> {name}, value: {value}, result: {result}")
         return result['code'] == 0
 
-    def set_v2(self, name: str, value: Union[bool, int, float, str], did: Optional[str] = None) -> bool:
-        """
-        设置设备的属性值（v2版本，需在实例化时指定did或在调用时提供）。
-
-        Args:
-            name (str): 属性名称。
-            value (Union[bool, int, float, str]): 属性值。
-            did (str, optional): 设备ID。如未指定，则使用实例化时的did。默认为None。
-
-        Returns:
-            bool: 执行结果（True/False）。
-
-        Raises:
-            ValueError: 如果未指定设备ID。
-        """
-        if did is not None:
-            return self.set(name, did, value)
-        elif self.did is not None:
-            return self.set(name, self.did, value)
-        else:
-            raise ValueError('Please specify the did')
-
     def get(self, name: str, did: Optional[str] = None) -> Union[bool, int, float, str]:
         """
         获取设备的属性值。
@@ -303,7 +285,7 @@ class mijiaDevices(object):
             RuntimeError: 如果设置属性失败。
         """
         if 'prop_list' in self.__dict__ and name in self.prop_list:
-            if not self.set_v2(name, value):
+            if not self.set(name, value):
                 raise RuntimeError(f'Failed to set property: {name}')
         else:
             super().__setattr__(name, value)
@@ -378,7 +360,7 @@ class mijiaDevices(object):
 
 def get_device_info(device_model: str, cache_path: Optional[str] = os.path.join(os.path.expanduser("~"), ".config/mijia-api")) -> dict:
     """
-    获取设备信息，用于初始化mijiaDevices对象。
+    获取设备信息，用于初始化mijiaDevice对象。
 
     Args:
         device_model (str): 设备型号，从get_devices_list获取。

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/mijiaAPI/login.py

@@ -122,6 +122,8 @@ class mijiaLogin(object):
         latest_utc_time = max(parsed_times)
         china_time = latest_utc_time + timedelta(hours=8)
 
+        # [FIXME] 实测此处的过期时间并不准确，实际过期时间可能大于此处获取的时间
+        #         cookie 中唯一用到的 serviceToken 并无过期时间
         return china_time
 
     def _save_auth(self) -> None:
@@ -188,6 +190,7 @@ class mijiaLogin(object):
             'ssecurity': ret_data['ssecurity'],
             'deviceId': data['deviceId'],
             'serviceToken': cookies['serviceToken'],
+            'cUserId': cookies['cUserId'],
             'expireTime': self._extract_latest_gmt_datetime(cookies).strftime('%Y-%m-%d %H:%M:%S'),
             'account_info': self._get_account_info(ret_data['userId'])
         }
@@ -273,6 +276,7 @@ class mijiaLogin(object):
             'ssecurity': ret_data['ssecurity'],
             'deviceId': data['deviceId'],
             'serviceToken': cookies['serviceToken'],
+            'cUserId': cookies['cUserId'],
             'expireTime': self._extract_latest_gmt_datetime(cookies).strftime('%Y-%m-%d %H:%M:%S'),
             'account_info': self._get_account_info(ret_data['userId'])
         }

{mijiaapi-1.4.5 → mijiaapi-2.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mijiaAPI"
-version = "1.4.5"
+version = "2.0.0"
 description = "A Python API for Xiaomi Mijia"
 readme = "README.md"
 requires-python = ">=3.9,<4.0"
@@ -15,7 +15,7 @@ mijiaAPI = "mijiaAPI.__main__:cli"
 
 [tool.poetry]
 name = "mijiaAPI"
-version = "1.4.5"
+version = "2.0.0"
 description = "A Python API for Xiaomi Mijia"
 authors = ["Do1e <dpj.email@qq.com>"]
 license = "GPLv3"