Hue Entertainment Pro（旧名称：Hue Light DJ）

镜像概述和主要用途

Hue Entertainment Pro是一款Web应用，可通过本地网络连接多个Philips Hue桥接器，利用Hue Entertainment API实现灯光近乎即时的更新。该应用专为多Philips Hue桥接器设置设计，能够将多个娱乐区域合并为无缝体验，支持从少于5个灯的小型设置到20+灯的大型设置，尤其在10+灯时效果更佳。内置演示模式可在无Hue桥接器的情况下预览20+灯设置效果，并提供顶部预览及全新3D预览功能。

注意：Hue Entertainment API v2支持单个娱乐组最多20个灯，若需控制超过20个可寻址灯，需每20个灯配置1个桥接器（例如，1个灯带含3或5个可寻址灯）。Hue Entertainment Pro可将这些区域合并，统一应用效果。

32个Hue灯带（5个桥接器）演示

32个Hue灯带演示 | 32个Hue LED灯带演示

核心功能和特性

• 合并多个娱乐区域为一个整体
• 同时控制来自多个桥接器的多个娱乐区域
• 内置多种灯光效果
• BPM输入以指定效果速度
• 预览窗口实时查看效果结果
• 全新3D预览功能
• 随机模式：在随机分组上运行随机效果
• 自动模式（派对模式）：每6秒启动新的随机效果
• 内置前后、左右等分组
• 随机分组：每次创建新的随机分组
• 触摸效果：点击或触摸预览区域从该位置启动效果
• 亮度滑块控制整体亮度
• 演示模式：无需Hue桥接器即可测试应用
• 同时连接多个Hue桥接器以控制超过20个灯
• 使用SQLite进行数据存储

技术架构

• 后端：ASP.Net Core 9.0
• 实时通信：SignalR（服务端到客户端）、gRPC（客户端到服务端）
• Hue桥接器通信：基于HueApi库
• 前端：Blazor
• 预览窗口：PixiJS（WebGL）、ThreeJs（3D预览）
• 数据存储：SQLite

使用场景和适用范围

• 大型灯光设置：20+灯的场景（如大型派对、活动场地）
• 小型灯光设置：少于5个灯的场景（如家庭小空间）
• 中型灯光设置：10+灯的场景（效果体验更佳）
• 无桥接器测试：通过演示模式在无Hue桥接器时预览功能
• 多区域控制：需同时控制不同区域（如前后、左右）灯光效果的场景

详细使用方法和配置说明

Docker部署

拉取并运行镜像

docker pull michielpost/huelightdj
docker run -d -p 8080:8080 michielpost/huelightdj

应用将在8080端口可用。

Docker Compose配置

由于应用使用SQLite存储数据，建议通过Docker Compose将数据库文件挂载到独立卷以保留数据。示例配置如下：

services:
  hueentertainmentpro.server:
    image: ${DOCKER_REGISTRY-}michielpost/huelightdj
    build:
      context: .
      dockerfile: HueEntertainmentPro/Server/Dockerfile
    expose:
      - "8080"  # 暴露端口给反向代理
    volumes:
      - sqlite-data:/app/data  # 挂载SQLite数据卷
    restart: unless-stopped
    environment:
      - ASPNETCORE_ENVIRONMENT=Production  # 生产环境配置
      - ConnectionStrings__DefaultConnection=Data Source=/app/data/HueEntertainmentPro.db;Cache=Shared  # SQLite连接字符串
volumes:
  sqlite-data:  # 定义数据卷

本地构建Docker镜像

docker build -f HueEntertainmentPro/Server/Dockerfile -t hue-entertainment-pro:dev .
docker run --rm -p 8080:8080 hue-entertainment-pro:dev

截图说明

• 主界面：展示应用主要控制界面
• 桥接器添加：配置连接Hue桥接器的界面
• 预览窗口：显示灯光效果预览
• 效果应用：效果选择与应用界面
• 3D预览：灯光布局的3D预览效果