Struct HapBridge 

pub struct HapBridge {
    pub service_record: HapServiceRecord,
    /* private fields */
}

HOMECORE-to-HAP accessory bridge state.

Call HapBridge::add_accessory to register entities and HapBridge::running_accessories to read back what is currently registered. Use start_server for the bounded TCP lifecycle.

Fields

service_record: HapServiceRecord

Implementations

impl HapBridge

pub fn new(service_record: HapServiceRecord) -> Self

Create a bridge with the given service record and a NullAdvertiser.

pub fn with_advertiser( service_record: HapServiceRecord, advertiser: Arc<dyn MdnsAdvertiser>, ) -> Self

Create a bridge with a custom MdnsAdvertiser.

pub fn add_accessory( &self, entity_id: &EntityId, state: &State, ) -> Result<(), HapError>

Register an entity as a HAP accessory.

The entity’s current mapping is computed from state; call update_accessory on each StateChanged event to keep it fresh.

Returns HapError::AlreadyRegistered if the entity is already registered. Call remove_accessory first to replace it.

pub fn remove_accessory(&self, entity_id: &EntityId) -> Result<(), HapError>

Remove a registered accessory.

Returns HapError::EntityNotFound if the entity was not registered.

pub fn update_accessory( &self, entity_id: &EntityId, state: &State, ) -> Result<(), HapError>

Refresh a registered accessory and notify event subscribers.

pub fn subscribe_events(&self) -> Receiver<CharacteristicEvent>

Subscribe to bounded characteristic updates. Lagging receivers receive Tokio’s explicit Lagged error and must resynchronize from a snapshot.

pub fn running_accessories(&self) -> Vec<ExposedAccessory>

Snapshot all currently registered accessories.

pub fn len(&self) -> usize

Number of registered accessories.

pub fn is_empty(&self) -> bool

pub async fn start(&self) -> Result<(), HapError>

Start advertisement only.

This legacy lifecycle does not bind a TCP listener. New integrations should call start_server, which advertises only after binding.

pub async fn stop(&self) -> Result<(), HapError>

Graceful shutdown — retracts mDNS advertisement.

Trait Implementations

impl Clone for HapBridge

fn clone(&self) -> HapBridge

Returns a duplicate of the value.

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

Performs copy-assignment from source.