Home Assistant Fully Kiosk Browser 集成实战:用 fully_kiosk.load_url 动作远程加载设备网页
【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io
本篇技术指南围绕 Home Assistant(当前仓库 home-assistant.io)中 Fully Kiosk Browser 集成的核心动作fully_kiosk.load_url展开,讲解如何通过自动化、脚本或开发者工具,让 Android 设备上的 Fully Kiosk Browser 浏览器打开指定网址。读完本文,你将掌握该动作在 UI 与 YAML 两种方式下的完整调用方法、参数含义、与同域动作的组合用法,以及底层调用机制,可直接落地到自己的家庭自动化场景中。
动作背景:Fully Kiosk Browser 与 Home Assistant
Fully Kiosk Browser 集成 是 Home Assistant 中面向 Android 设备的官方集成(ha_domain: fully_kiosk,ha_integration_type: device,自 2022.9 版本起提供)。它通过本机轮询(Local Polling)方式与设备上的 Fully Kiosk Browser 应用通信,让你能够监控设备状态并远程控制设备。
该集成覆盖二进制传感器、相机、通知、传感器、开关等多种平台,并提供若干控制能力,包括:
- 将 Fully Kiosk 置于前台 / 后台
- 加载起始 URL
- 重启浏览器应用
- 开关 Kiosk 模式、维护模式、动作检测、屏保
- 控制屏幕开关、亮度与息屏定时
- 播放/停止媒体、设置音量、清空浏览器缓存
而fully_kiosk.load_url正是其中"主动让设备打开指定网页"的关键动作,常与 fully_kiosk.set_config、fully_kiosk.start_application 等动作配合,构建设备的远程内容管理与信息展示能力。
使用前提
在调用该动作前,请确保集成配置就绪:
- 设备上的 Fully Kiosk Browser 需启用Fully Remote Admin功能(该功能需要付费的 Fully Plus 许可,可免费测试但设备上会显示水印)。
- 配置集成时需提供设备 IP 地址及在浏览器应用内设置的 Fully Remote Admin 密码,详见集成文档的 Requirements 与配置流程。
动作概述:什么是 fully_kiosk.load_url
fully_kiosk.load_url的动作定义见 source/_actions/fully_kiosk.load_url.markdown,其官方描述为:
Loads a URL on Fully Kiosk Browser.
简而言之,该动作会告诉 Fully Kiosk Browser 在你的设备上打开一个特定的网页地址。它需要两个必填参数:
- Device ID:运行 Fully Kiosk Browser、用于加载网址的目标设备。
- URL:要加载的网址。
从用户界面调用:分步操作
如果你更习惯在界面中可视化地构建自动化与脚本,可以完全通过 UI 完成配置(无需编写 YAML):
- 进入Settings>Automations & scenes。
- 打开现有自动化或脚本,或选择Create新建一个。
- 若是新建自动化,在When(何时)区域添加触发器;脚本则无需触发器。
- 在Then do(然后执行)区域选择Add action(添加动作)。
- 在搜索框中搜索并选择Fully Kiosk Browser: Load URL。
- 选择要在其上加载网址的Device ID。
- 输入要加载的URL。
- 选择Save(保存)。
UI 中的选项
| 选项 | 说明 | 是否必填 |
|---|---|---|
| Device ID | 运行 Fully Kiosk Browser、用于加载网址的设备 | 是 |
| URL | 要加载的网址 | 是 |
UI 选项数据定义位于文档的options_ui区块(source/_actions/fully_kiosk.load_url.markdown#L26-L35),两种字段均为必填。
在 YAML 中调用:完整语法与示例
如果你直接在 YAML 中工作,或希望精确了解 Home Assistant 底层执行的行为,请使用以下技术参考(字段名、类型与必填性均出自文档options_yaml区块,source/_actions/fully_kiosk.load_url.markdown#L51-L62):
action: fully_kiosk.load_url data: device_id: a674c90eca95eca91f6020415de07713 url: "https://www.home-assistant.io"执行后,Home Assistant 会通知指定设备上的 Fully Kiosk Browser 打开https://www.home-assistant.io,即 Home Assistant 官网。
YAML 选项参考
| 字段 | 类型 | 说明 | 必填 |
|---|---|---|---|
device_id | string | 运行 Fully Kiosk Browser、用于加载网址的设备 | 是 |
url | string | 要加载的网址 | 是 |
自动化场景中的完整示例
将动作嵌入自动化,例如当门磁传感器被触发时,让客厅平板立即打开监控画面:
alias: 打开客厅平板监控画面 triggers: - trigger: state entity_id: binary_sensor.front_door to: "on" actions: - action: fully_kiosk.load_url data: device_id: a674c90eca95eca91f6020415de07713 url: "http://192.168.1.10:8123/lovelace/security"也可以作为脚本供语音助手或虚拟开关调用,在任意时刻把设备导航到指定页面。
快速测试:开发者工具中的 Actions
若想在不编写任何 YAML 的情况下验证动作效果,可以打开Settings>Tools>Actions,搜索该动作,填入字段并选择Perform action,即可在真实实体上立即看到结果(参考 actions/try_it.md)。
关联动作与组合使用
fully_kiosk.load_url的动作文档中声明了以下关联动作(文档 frontmatter):
fully_kiosk.set_config:修改设备上 Fully Kiosk Browser 的任意配置参数。它接受
device_id、key、value三个必填参数,例如将动作灵敏度设置为90:action: fully_kiosk.set_config data: device_id: a674c90eca95eca91f6020415de07713 key: "motionSensitivity" value: "90"fully_kiosk.start_application:在设备上启动一个 Android 应用,通过包名引用,例如
de.ozerov.fully(Fully Kiosk Browser 自身的包名):action: fully_kiosk.start_application data: device_id: a674c90eca95eca91f6020415de07713 application: "de.ozerov.fully"
三个动作共享同一个device_id目标参数,组合使用时逻辑一致:先load_url导航页面、再set_config调整浏览器参数、或通过start_application切换到其他应用,可编排出一套完整的设备内容管理流程。
常见问题排查
如果动作执行后设备无反应,可按以下顺序排查:
- 确认集成已配置成功:检查 Fully Remote Admin 是否在应用内启用,以及 集成配置 中的 IP 与密码是否正确。
- 确认
device_id正确:该值来自集成生成的实体设备,务必使用真实存在的设备标识,而非随意字符串。 - 检查 URL 格式:URL 需为浏览器可解析的完整地址(如
https://...或局域网http://IP:端口/...)。 - 验证设备在线:Fully Kiosk 集成采用本地轮询,设备离线或休眠时动作可能无法送达。
若仍无法解决,可加入 Home Assistant 社区获取帮助:在社区论坛发帖时请说明你调用的动作与期望结果(参考 actions/stuck.md)。
总结
fully_kiosk.load_url是 Fully Kiosk Browser 集成中最实用的远程控制动作之一,仅需device_id与url两个参数,即可在 UI 或 YAML 中快速实现 Android 平板/设备浏览器的远程导航。配合 fully_kiosk.set_config 与 fully_kiosk.start_application,它能够支撑信息看板、安防监控、访客引导等多种家庭自动化场景,是打造"信息屏平板"方案的核心动作。
【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考