Home Assistant Kiosker 集成实战使用kiosker.navigate_url动作控制设备页面导航【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.iokiosker.navigate_url是 Home Assistant 中 Kiosker 集成提供的核心动作之一用于将 Kiosker 设备运行于 iPad / iPhone 的网页信息屏导航到任意指定 URL。本指南以 source/_actions/kiosker.navigate_url.markdown 为骨架结合 Kiosker 集成文档 展开讲解你将掌握在自动化与脚本中通过 UI 向导和 YAML 两种方式调用该动作、配置完整参数并落地“回家显示欢迎页”“夜间回到主页看板”等实用场景。动作概览这个动作能做什么Navigate to URLkiosker.navigate_url动作会让指定的 Kiosker 设备打开一个具体网页。它的典型价值在于你可以基于时间、人员在家状态、传感器读数等任意触发条件让挂在墙上的信息屏自动切换显示内容而无需手动操作设备。该动作属于kiosker域随 Home Assistant 2026.5 版本引入见文档 front matter 中的since: 2026.5并与 Set blackout显示/隐藏全屏遮罩互为配套动作——前者切换页面内容后者控制屏幕遮罩状态。使用前提先完成 Kiosker 集成kiosker.navigate_url依赖 Kiosker 集成正常工作。根据 Kiosker 集成文档在调用本动作前需要满足以下条件购买 Kiosker Pro 或拥有有效的 Kiosker 订阅可免费试用 7 天在 Kiosker App 设置中启用 API 服务器并生成访问令牌access token同时确认设备的 IP 地址设备需运行Kiosker 26.4.1 或更高版本在 Home Assistant 中通过配置流程添加集成配置项包括Host设备的 IP 地址或主机名API TokenKiosker App 中生成的 API 令牌Use SSL是否通过 HTTPS 连接需 Kiosker API 已配置 SSLVerify certificate是否校验 SSL 证书仅对有效证书启用。集成会每 15 秒从设备拉取一次数据参见 数据更新说明因此导航动作触发后设备状态的变化会被较快反映到 Home Assistant。在 UI 中通过向导调用动作如果你更习惯可视化构建自动化Home Assistant 会逐步引导完成配置无需编写 YAML参见 actions/ui_header.md。具体步骤进入设置自动化与场景Settings Automations scenes。打开现有自动化或脚本或选择创建自动化创建新自动化Create automation Create new automation。若是新建自动化先在When触发条件部分添加一个触发器脚本Scripts不需要触发器。在Then do执行部分选择添加动作Add action。在搜索框中搜索并选择Kiosker: Navigate to URL。在设备Device下拉框中选择你的 Kiosker 设备。输入要导航到的 URL。点击保存Save。UI 中的选项选项说明是否必填设备Device要导航的 Kiosker 设备是URL要在设备上打开的网页地址是在 YAML 中使用该动作如果你直接在 YAML 中工作或者想确切了解 Home Assistant 底层做了什么本节提供技术参考列出了 YAML 字段名、类型与必填性参见 actions/yaml_header.md。动作在 YAML 中以kiosker.navigate_url引用基础示例如下action: kiosker.navigate_url data: device_id: YOUR_DEVICE_ID url: https://www.home-assistant.ioYAML 参数详解参数说明必填类型device_id要导航的 Kiosker 设备 ID是stringurl要导航到的网页地址是string两点提醒device_id不是设备名称而是 Home Assistant 为设备分配的唯一 ID。你可以在设置 设备与服务中打开对应 Kiosker 设备页面查看或参考现有自动化中的用法。url可以是任意有效地址包括指向 Home Assistant 实例自身的本地页面见下文“注意事项”。注意事项Good to know根据 原文档 的说明有两点值得特别留意屏幕保护程序不会自动关闭如果动作触发时设备的屏幕保护程序screensaver正处于激活状态导航到新 URL 并不会自动将其解除。若希望页面立即可见可考虑结合 Kiosker 集成提供的Dismiss screensaver按钮实体一起使用。支持任意有效 URL包括 Home Assistant 实例上的本地页面如 Lovelace 仪表盘地址这为“按场景切换仪表盘”提供了可能。实战示例一有人到家时显示欢迎页当家庭成员到家时让走廊的显示屏导航到个性化欢迎页面。触发器Person: Arrives home人员到家动作Kiosker: Navigate to URL设备Hallway display走廊显示屏URLhttps://homeassistant.local/lovelace/welcome对应完整 YAMLautomation: alias: Show welcome screen on arrival triggers: - trigger: state entity_id: person.jane to: home actions: - action: kiosker.navigate_url data: device_id: YOUR_DEVICE_ID url: https://homeassistant.local/lovelace/welcome实战示例二夜间回到主页看板每晚 22 点后让客厅的信息屏回到主页仪表盘确保第二天早上屏幕始终展示正确的页面。触发器Time: 22:00时间触发动作Kiosker: Navigate to URL设备Living room kiosk客厅信息屏URLhttps://homeassistant.local/lovelace/home对应完整 YAMLautomation: alias: Return kiosk to home dashboard at night triggers: - trigger: time at: 22:00:00 actions: - action: kiosker.navigate_url data: device_id: YOUR_DEVICE_ID url: https://homeassistant.local/lovelace/home提示两个示例中的YOUR_DEVICE_ID需替换为你实际设备的 ID示例 URL 中的homeassistant.local也应替换为你实例的本地地址。立即动手测试想在不写一行 YAML 的情况下验证动作效果打开设置 工具 动作Settings Tools Actions搜索kiosker.navigate_url填写字段后点击执行动作Perform action即可在真实设备上立即看到导航结果参见 actions/try_it.md。相关动作该动作常与以下动作搭配使用参见 actions/related.mdSet blackoutkiosker.blackout_set在 Kiosker 设备上显示或隐藏全屏遮罩可自定义消息、图标、颜色与关闭按钮。适合与页面导航配合实现“显示欢迎页前先解除遮罩”“夜间导航后立即熄灭屏幕”等组合场景。故障排查提示如果动作执行后设备没有反应通常不是动作本身的问题而是 Kiosker 集成连接异常。依据 Kiosker 集成文档 的排障章节可依次检查Kiosker App 是否在前台运行、API 是否已启用、访问令牌是否仍有效若令牌被重新生成Home Assistant 会提示重新认证选择重新配置并填入新令牌即可不影响已有实体与自动化Host / IP 是否正确且未变化若启用了 IP 过滤确认 Home Assistant 主机 IP 在白名单中若启用了 TLS确认已在 Kiosker App 中安装有效证书通常为自签名证书并在开启Verify certificate时将根证书标记为受信任。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考