返回资讯中心
外部精选
软件工程
#开发者实时流

开发者推出适配 Valetudo 扫地机器人的原生 iPhone 应用

来源标题:Show HN: A native iPhone app for robot vacuums running Valetudo

一款面向运行 Valetudo 的扫地机器人的原生 iPhone 应用发布,通过家庭网络直连设备,无需云服务、账号或追踪。该应用为非官方作品,与 Valetudo 项目无隶属关系,目前可通过 TestFlight 安装测试版。它支持实时查看地图、按房间顺序清扫、编辑户型图(改名、拆分合并房间、设置禁区和禁拖区)等功能。

Hacker News 最新humbfool22026/11/11 · 6 天前14 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一款原生 iPhone 应用,用于控制运行 Valetudo 的扫地机器人。它通过你的家庭网络直接与机器人通信,不需要云服务、账号或跟踪。

这是一款非官方应用,与 Valetudo 项目没有关联,也未获得其认可。

试用 beta 版:用 TestFlight 安装到你的 iPhone 上。

截图使用的是 Valetudo 公开的示例地图。

设置新机器人:将尚未连接 Wi-Fi 的机器人接入你的网络,方式与 Valetudo 自带的设置页面相同。

实时平面图:查看机器人移动,支持双指缩放,也可切换到可以旋转和倾斜的 3D 家居模型。

清扫路线:在支持该功能的机器人上,于「控制」中模式旁边选择「快速」「标准」「强力」或「深度」。

随处清扫:按你想要的顺序点选房间,长按放置标记点,或框选一个区域,然后从底部栏开始。所有操作也都可以通过 + 按钮和 VoiceOver 完成。

连接其他应用:长按开始按钮,即可查看任务发送的确切请求,可直接复制到 Home Assistant 或任何支持 MQTT 或 REST 的服务中。

编辑平面图:重命名、拆分和合并房间,设置地面类型,添加墙壁、禁行区、禁拖区和标注。

建图:执行一次建图流程,接受新地图,恢复备份,或重新开始。

手动操控:在任何机器人上使用摇杆或方向键,连接了硬件键盘时也可用键盘。

摄像头:在平面图上方或全屏观看实时画面,也可在手动操控时观看,摄像头可见范围会标注在平面图上,并可选启用基于 Apple Vision 框架的设备端图像识别。

障碍物照片:点选障碍物即可查看机器人当时看到的内容。如果机器人无法识别,Vision 会在你手机上查看照片并给出正确的图标。

日程:设置例行任务和免打扰时段。

维护:跟踪部件、清洁提醒和历史记录。

基座与提醒:清空尘盒、清洗并烘干拖布,以及回看机器人过去的提醒。

多台机器人:保存多台机器人,在首页或设置中切换,并将常用机器人加星标以置顶显示。

设置:基座行为、语音包、Wi-Fi、MQTT、时间、登录、更新、日志和系统信息。

应用通常会自动发现你的机器人。如果没有发现,请输入其地址。应用会读取每台机器人支持的功能,只显示相应的控制项,因此同一个构建版本可适用于 Valetudo 支持的各款机器人。

需要 iOS 17 或更高版本

一台运行 Valetudo 的机器人。功能取决于你的机器人和 Valetudo 版本。

构建

你需要一台装有 Xcode 26 或更高版本的 Mac。应用使用 iOS 26 SDK 以实现 Liquid Glass 效果,但仍可在 iOS 17 上运行。

git clone https://github.com/bsidio/valetudo-ios.git cd valetudo-ios open OpenVacuum.xcodeproj 选择一个模拟器并按 Run。

要安装到 iPhone 上,请选择 OpenVacuum target 并打开 Signing & Capabilities。选择你的团队,然后将 Bundle Identifier 改为你自己的标识,例如 com.yourname.openvacuum,因为 Apple 只允许一个团队使用每个标识符。免费的 Apple ID 也可以,但应用会在 7 天后过期。

首次在 iPhone 上运行时,请在「设置 > 隐私与安全性」中开启开发者模式。使用免费 Apple ID 时,还需要在「设置 > 通用 > VPN 与设备管理」中信任你的证书,应用才能打开。

项目由 project.yml 生成。如果你修改了它,请运行 xcodegen,可通过 brew install xcodegen 安装。这会重置你的团队和 bundle identifier,因此需要重新设置。

xcodebuild test -project OpenVacuum.xcodeproj -scheme OpenVacuum
-destination "platform=iOS Simulator,name=iPhone 17 Pro"

如果没有该模拟器,请使用 xcrun simctl list devices available 中任意可用的 iPhone。

应用可以显示机器人的摄像头画面,但无法自行开启摄像头。设置方法如下:

这是有意为之。Valetudo 将摄像头设置保持为手动,以免扫地机器人一键变成隐藏摄像头,本应用尊重这一设计。请不要提交自动化该流程的 pull request。机器人附近的人无法察觉摄像头正在推流,因此请确保家中所有人都知情并同意。

推流关闭时,应用完全不会提及摄像头。你可以随时从应用中关闭推流,这也会从机器人上删除 Duststreamer。

Valetudo 以 MPEG-TS 封装传输 MPEG-1 视频,iOS 无法播放,因此应用自行解包视频流,并用 pl_mpeg 解码。视频不会被录制或保存。

应用只与你的机器人通信,不会向其他任何地方发送数据。你的密码保存在 iOS 钥匙串中,障碍物照片不会保留在手机上。

Valetudo 不提供 HTTPS,因此登录信息和 Wi-Fi 密码会以未加密方式经过你的家庭网络。请使用一个你在其他地方不使用的密码。

本应用不属于 Valetudo 项目,因此请在本仓库的 issues 中报告相关问题,而不要向 Valetudo 报告。

iPad 布局。应用可在 iPhone 上运行。

许可证

OpenVacuum 是基于 MIT 许可证的开源软件。来自其他项目的部分保留其各自的许可证,列在 Credits 中。

基于 Sören Beye 的 Valetudo 构建。成就名称和描述来自 Valetudo,版权所有 2018 Sören Beye,依据 Apache License 2.0 授权。该许可证的副本位于 Valetudo/Valetudo-License.txt 以及应用中。视频解码使用 Dominic Szablewski 的 pl_mpeg,依据下方的 MIT 许可证授权。同样的声明也位于应用中「设置 > 关于」下。

Valetudo/Vendor/pl_mpeg.h 是该库的头文件,未经修改,来自提交 c871f2be02。该版本仅标注了许可证名称,因此下方的声明来自其较早版本的头文件。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →