Vivo Cloud Device Tracker

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

功能特点

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

安装方法

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

配置步骤

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

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

使用CookieCloud

1. 安装CookieCloud浏览器扩展：CookieCloud - Microsoft Edge Addons

2. 在浏览器中登录https://find.vivo.com.cn ，注意选择两周免认证

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

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

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

   是否同步Local Storage：是

   同步域名关键词：vivo.com.cn

3. 使用CookieCloud扩展同步Cookie

4. 在Home Assistant中输入CookieCloud的UUID和密码

故障排除

无法连接到Vivo Cloud

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

无法获取设备列表

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

设备位置不更新

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

注意事项

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

许可证

MIT License