PresenceLight 项目教程

1. 项目介绍

PresenceLight 是一个开源项目，旨在将用户的各种状态（如 Microsoft Teams 的可用性状态）广播到各种智能灯泡上。该项目利用 Microsoft Graph 中的 Presence API，允许用户在不依赖物理连接（如 USB）的情况下，从远程机器更新灯泡状态。PresenceLight 支持多种智能灯泡，包括 Philips Hue、LIFX、Yeelight 和 Philips Wiz 等。

2. 项目快速启动

2.1 环境准备

在开始之前，请确保您已经安装了以下软件：

• .NET 8 SDK
• Visual Studio 2022 或 Visual Studio Code

2.2 克隆项目

首先，克隆 PresenceLight 项目到本地：

git clone https://github.com/isaacrlevin/presencelight.git
cd presencelight

2.3 安装依赖

在项目根目录下，运行以下命令安装所需的依赖：

dotnet restore

2.4 配置应用

在 appsettings.json 文件中配置您的智能灯泡和 Microsoft Teams 的连接信息。例如：

{
  "Lights": {
    "PhilipsHue": {
      "BridgeIp": "192.168.1.100",
      "Username": "your-username"
    },
    "LIFX": {
      "Token": "your-lifx-token"
    }
  },
  "MicrosoftTeams": {
    "ClientId": "your-client-id",
    "TenantId": "your-tenant-id"
  }
}

2.5 运行应用

在项目根目录下，运行以下命令启动应用：

dotnet run

3. 应用案例和最佳实践

3.1 办公室状态指示

在办公室环境中，PresenceLight 可以用于指示员工的可用性状态。例如，当员工在会议中时，灯泡可以显示红色；当员工空闲时，灯泡可以显示绿色。这有助于团队成员快速了解彼此的可用性。

3.2 远程工作状态指示

对于远程工作的员工，PresenceLight 可以放置在家中，通过智能灯泡的颜色变化来指示当前的工作状态。例如，蓝色表示正在工作，黄色表示休息中。

3.3 多设备同步

PresenceLight 支持多设备同步，您可以在多个设备上运行 PresenceLight，并将它们连接到同一个智能灯泡。这样，无论您在哪个设备上更新状态，灯泡都会同步显示。

4. 典型生态项目

4.1 Microsoft Teams

PresenceLight 的核心功能是与 Microsoft Teams 集成，通过 Microsoft Graph API 获取用户的可用性状态，并将其广播到智能灯泡上。

4.2 Philips Hue

Philips Hue 是 PresenceLight 支持的主要智能灯泡之一。通过 PresenceLight，您可以轻松地将 Microsoft Teams 的状态同步到 Philips Hue 灯泡上。

4.3 LIFX

LIFX 是另一个受支持的智能灯泡品牌。PresenceLight 允许您通过 LIFX 的 API 控制灯泡的颜色和状态。

4.4 Yeelight

Yeelight 是小米旗下的智能灯泡品牌，PresenceLight 也支持与 Yeelight 灯泡的集成，提供状态指示功能。

通过以上步骤，您可以快速启动 PresenceLight 项目，并将其应用于各种智能灯泡和 Microsoft Teams 的集成场景中。