first commit
This commit is contained in:
@@ -0,0 +1,128 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user