Govee IoT Scene Control

The dgovee package serves as the bridge between the digital assistant and physical environmental controls.

API Architecture

The integration utilizes two distinct Govee APIs depending on the required action:

1. HTTP API (Cloud)

• Used for broad commands, device discovery, and querying the current state (e.g., "Is the office light currently on?").
• Relies on the user's Govee API Key.

2. Local LAN API (UDP)

• For supported devices, the system sends UDP multicast packets on the local network (239.255.255.250:4001).
• This provides zero-latency control, essential for fast reactions (like flashing red during a critical Sentry Guard alert).

Scene and Routine Integration

The true power of this package lies in its integration with the assistant's routines.

• Welcome Home: When the unifi package detects the user's phone connecting to the Wi-Fi, it triggers the wakeup.go endpoint. The nikki agent, as part of her routine, can invoke dgovee to turn on the hallway and office lights.
• Focus Mode: A playbook can trigger a "Focus Mode" that silences Discord notifications and sets the Govee lights to a cool blue/white to reduce eye strain.

Guidance for AI Agents

• Rate Limits: The Govee Cloud API has strict rate limits. Prefer the Local LAN API for rapid state changes.
• Feedback: Always confirm light changes verbally or via text (e.g., "I've set the ambient lights to warm white for the evening.").

Cross-References

• Key-Packages/dgovee/overview.md
• Features/unifi/presence-detection.md