Hass/vivo_cloud

Fork 0

Files

T

zimonianhua a9ad4a285f first commit

2025-09-16 23:19:11 +08:00

3.3 KiB

Raw Permalink Blame History

Vivo Cloud Device Tracker

这是一个Home Assistant自定义组件，用于跟踪Vivo Cloud设备的位置。

功能特点

支持通过手动输入Cookie或使用CookieCloud获取Cookie
自动获取Vivo Cloud设备列表
支持多设备选择和跟踪
定时更新设备位置信息
显示设备信号和电池信息
提供响铃提醒服务

安装方法

将custom_components/vivo_cloud目录复制到Home Assistant的custom_components目录下
重启Home Assistant
在"配置" -> "集成"中点击"+"添加集成
搜索"Vivo Cloud"并点击添加
按照配置向导完成设置

配置步骤

1. Cookie设置方式选择

选择获取Cookie的方式：

手动输入Cookie：直接输入从浏览器获取的Cookie
使用CookieCloud获取Cookie：通过CookieCloud服务获取Cookie

2. Cookie配置

根据选择的Cookie设置方式，输入相应的信息：

手动输入：输入完整的Cookie字符串
CookieCloud：输入UUID、密码和服务器地址（可选，默认为https://cookie.nextrt.com）

3. 设备选择

从获取的设备列表中选择要跟踪的设备。可以多选。

4. 扫描间隔设置

设置设备位置信息的更新频率（秒），建议值在360-3600秒之间。

使用方法

设备跟踪

插件会自动为每个选中的设备创建一个设备跟踪实体，显示在Home Assistant的地图上。

设备信息

每个设备跟踪实体包含以下信息：

位置信息（经纬度、位置描述）
设备状态（在线状态、电池电量）
信号信息（运营商、网络类型、信号强度）
电池信息（电量、充电状态等）

响铃提醒

可以通过服务调用让设备响铃，以便查找设备：

service: vivo_cloud.ring_device
target:
  entity_id: device_tracker.vivo_device_123456789
data:
  device_id: "123456789"

获取Cookie的方法

手动获取Cookie

在浏览器中登录https://find.vivo.com.cn
打开开发者工具（F12）
切换到"网络"选项卡
刷新页面或执行设备查找操作
找到名为"devices"的请求
在请求头中找到"Cookie"字段，复制完整的Cookie值

使用CookieCloud

安装CookieCloud浏览器扩展：CookieCloud - Microsoft Edge Addons
在浏览器中登录https://find.vivo.com.cn ，注意选择两周免认证

服务器地址：https://cookie.nextrt.com

用户KEY · UUID：选择自动生成避免和别人一样

端对端加密密码：选择自动生成或者自己设置

是否同步Local Storage：是

同步域名关键词：vivo.com.cn
使用CookieCloud扩展同步Cookie
在Home Assistant中输入CookieCloud的UUID和密码

故障排除

无法连接到Vivo Cloud

检查Cookie是否有效
确保网络连接正常
尝试重新获取Cookie

无法获取设备列表

确保Cookie中包含必要的权限
检查账号是否有设备绑定

设备位置不更新

检查设备是否在线
确保设备开启了位置服务
尝试减小扫描间隔

注意事项

插件需要定期更新Cookie，建议使用CookieCloud自动同步
设备位置更新频率不宜过高，以免消耗过多电量
某些设备可能不支持所有功能

许可证

MIT License

3.3 KiB Raw Permalink Blame History Unescape Escape