128 lines
3.3 KiB
Markdown
128 lines
3.3 KiB
Markdown
# 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 |