# 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的地图上。

### 设备信息

每个设备跟踪实体包含以下信息：
- 位置信息（经纬度、位置描述）
- 设备状态（在线状态、电池电量）
- 信号信息（运营商、网络类型、信号强度）
- 电池信息（电量、充电状态等）

### 响铃提醒

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

```yaml
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](https://microsoftedge.microsoft.com/addons/detail/bffenpfpjikaeocaihdonmgnjjdpjkeo)

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