news 2026/9/16 12:05:10

Home Assistant Fully Kiosk Browser 集成实战:用 fully_kiosk.load_url 动作远程加载设备网页

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Home Assistant Fully Kiosk Browser 集成实战:用 fully_kiosk.load_url 动作远程加载设备网页

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_kioskha_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):

  1. 进入Settings>Automations & scenes
  2. 打开现有自动化或脚本,或选择Create新建一个。
  3. 若是新建自动化,在When(何时)区域添加触发器;脚本则无需触发器。
  4. Then do(然后执行)区域选择Add action(添加动作)。
  5. 在搜索框中搜索并选择Fully Kiosk Browser: Load URL
  6. 选择要在其上加载网址的Device ID
  7. 输入要加载的URL
  8. 选择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_idstring运行 Fully Kiosk Browser、用于加载网址的设备
urlstring要加载的网址

自动化场景中的完整示例

将动作嵌入自动化,例如当门磁传感器被触发时,让客厅平板立即打开监控画面:

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_idkeyvalue三个必填参数,例如将动作灵敏度设置为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切换到其他应用,可编排出一套完整的设备内容管理流程。

常见问题排查

如果动作执行后设备无反应,可按以下顺序排查:

  1. 确认集成已配置成功:检查 Fully Remote Admin 是否在应用内启用,以及 集成配置 中的 IP 与密码是否正确。
  2. 确认device_id正确:该值来自集成生成的实体设备,务必使用真实存在的设备标识,而非随意字符串。
  3. 检查 URL 格式:URL 需为浏览器可解析的完整地址(如https://...或局域网http://IP:端口/...)。
  4. 验证设备在线:Fully Kiosk 集成采用本地轮询,设备离线或休眠时动作可能无法送达。

若仍无法解决,可加入 Home Assistant 社区获取帮助:在社区论坛发帖时请说明你调用的动作与期望结果(参考 actions/stuck.md)。

总结

fully_kiosk.load_url是 Fully Kiosk Browser 集成中最实用的远程控制动作之一,仅需device_idurl两个参数,即可在 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),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/16 12:04:59

Notepad-- 跨平台文本编辑器:从安装到深度定制的完整上手指南

Notepad-- 跨平台文本编辑器:从安装到深度定制的完整上手指南 【免费下载链接】notepad-- 一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。 项目地址: https://gitcode.com/GitHub_Trending/no/notepad-- …

作者头像 李华
网站建设 2026/9/16 12:04:14

AI重构测试价值链:从成本中心到利润引擎

1. 项目概述:AI重构测试价值链条的底层逻辑测试部门长期被视为企业的成本中心,这种认知源于传统测试模式的两个致命缺陷:人力密集型的工作方式消耗大量资源,而问题发现滞后导致修复成本指数级增长。我在某跨国电商平台担任质量架构…

作者头像 李华
网站建设 2026/9/16 12:02:42

650V超结MOSFET 65R370特性与应用解析

1. 65R370超结MOS管核心特性解析65R370是ASEMI推出的N沟道超结MOSFET,采用TO-252封装设计,专为中大功率电源应用优化。这款器件最引人注目的特点在于其650V的高耐压与370mΩ的低导通电阻组合,这在业内同规格产品中属于第一梯队表现。1.1 关键…

作者头像 李华
网站建设 2026/9/16 12:01:38

Spring Boot校园疫情管理系统开发实践

1. 项目背景与核心价值最近两年高校疫情防控成为校园管理的重点难点。传统纸质登记、Excel表格统计的方式存在数据滞后、信息孤岛、预警不及时等痛点。我们团队基于Spring Boot框架开发了一套校园疫情信息管理系统,实现了从数据采集、分析到可视化的全流程数字化管理…

作者头像 李华