Chromecast-Kiosk 开源项目安装与使用指南

---

1. 项目目录结构及介绍

Chromecast-Kiosk 是一个基于Google Chromecast构建数字标牌系统的开源软件。其目录结构设计旨在简洁高效地管理代码和配置。以下是核心目录结构概览：

• src/main: 主要源代码存放处。

  • java: 包含了所有Java源代码文件，负责实现系统的核心逻辑。
    • de.mrothenbuecher.chromecast.kiosk: 主要包，包含了与Chromecast交互的类和其他业务逻辑。

• webapp: Web应用程序资源目录，用于部署到Tomcat服务器。

  • WEB-INF: 包括web.xml等配置文件以及应用初始化参数。
    • config: 存放JSON配置文件，这些配置是运行时读取以控制Chromecast行为的关键。
  • static: 若项目中包含前端静态资源（虽然重点在后端服务，但理论上可放置CSS, JS等）。
  • index.jsp或相关入口页面，虽然该项目主要通过API操控，可能不直接涉及复杂的前端界面。

• pom.xml: Maven项目对象模型文件，定义依赖关系，构建过程等。

2. 项目启动文件介绍

此开源项目依赖于Java和Maven环境。启动并不直接有一个单一的“启动文件”，而是通过Maven命令来编译和部署WAR文件至Tomcat服务器。关键步骤包括：

• 使用Maven构建项目：mvn clean package
• 将生成的WAR文件（位于target目录下）复制到Tomcat的webapps目录。
• 启动Tomcat服务器，这将自动解压并部署项目。

若使用的是Tomcat的管理界面，可以通过上传WAR文件的方式进行部署。

3. 项目的配置文件介绍

配置集中在webapp/WEB-INF/config目录下的JSON文件中。这些文件是管理Chromecast设备的核心，决定了哪些网站将在Chromecast上显示，以及它们的更新频率等行为。例如：

• chromecasts.json 可能用于列出要管理的每个Chromecast设备的固定IP地址及其名称。
• settings.json 或类似的文件可能存储全局设置，如网络配置、刷新间隔等。

配置样例可能包括设备的IP、显示的网页URL、是否循环播放、延迟时间等，确保定制化数字标牌展示。

配置示例解析:

对于展示特定内容，比如使用Google Slides，配置URL时可以加入特定参数：

"https://docs.google.com/presentation/d/{presentation-id}/embed?start=true&loop=true&delayms=10000&rm=minimal"

这些参数使得演示文稿自动开始播放、循环播放，并且每页停留10秒，展示最小化的界面。

通过这样的配置，Chromecast-Kiosk实现了对多台Chromecast设备的集中管理和内容投放，适合创建无需人工频繁干预的数字展示解决方案。