Struct GoveeClient 

pub struct GoveeClient { /* private fields */ }

Govee API client for the v2 router-based endpoints

Implementations

impl GoveeClient

pub fn new(api_key: impl Into<String>) -> Self

Create a new Govee API client with default configuration (10 second timeout, 3 retries).

pub fn with_config(api_key: impl Into<String>, config: ClientConfig) -> Self

Create a new Govee API client with a custom configuration.

pub async fn get_devices(&self) -> Result<Vec<Device>>

List all devices and groups

pub async fn get_device_state( &self, device_id: &str, sku: &str, ) -> Result<DeviceState>

Get the current state of a device

pub async fn get_dynamic_scenes( &self, device_id: &str, sku: &str, ) -> Result<Vec<Scene>>

List the dynamic light scenes available for a device (POST /router/api/v1/device/scenes).

pub async fn get_diy_scenes( &self, device_id: &str, sku: &str, ) -> Result<Vec<Scene>>

List the user-created DIY scenes available for a device (POST /router/api/v1/device/diy-scenes).

pub async fn set_scene( &self, device_id: &str, sku: &str, scene: &Scene, ) -> Result<()>

Activate a scene previously returned by Self::get_dynamic_scenes or Self::get_diy_scenes.

pub async fn turn_on(&self, device_id: &str, sku: &str) -> Result<()>

Turn a device on

pub async fn turn_off(&self, device_id: &str, sku: &str) -> Result<()>

Turn a device off

pub async fn set_brightness( &self, device_id: &str, sku: &str, brightness: u8, ) -> Result<()>

Set device brightness (0-100)

pub async fn set_color( &self, device_id: &str, sku: &str, color: Color, ) -> Result<()>

Set device color

pub async fn set_color_temperature( &self, device_id: &str, sku: &str, kelvin: i32, ) -> Result<()>

Set color temperature in Kelvin (2000-9000)

pub async fn set_segment_color( &self, device_id: &str, sku: &str, segments: &[u8], r: u8, g: u8, b: u8, ) -> Result<()>

Set the color of specific segments of a segmented light.

segments are zero-based segment indices as advertised by the device’s segmentedColorRgb capability.

pub async fn set_segment_brightness( &self, device_id: &str, sku: &str, segments: &[u8], brightness: u8, ) -> Result<()>

Set the brightness (0-100) of specific segments of a segmented light.

Trait Implementations

impl Clone for GoveeClient

fn clone(&self) -> GoveeClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.