## 灯光管理 该模块提供对Home Assistant中灯光设备的管理功能,包括获取灯光列表、搜索特定灯光设备以及控制灯光的开关状态。 ```ts import { haLight } from '@kevisual/ha-api'; const light = new haLight({ host: 'http://your-home-assistant:8123', token: 'your-long-lived-access-token', }); // 获取所有灯光设备 const lights = await light.getLights(); console.log(lights); const searchResult = await light.searchLight('living room'); console.log(searchResult); if(searchResult.hasMore) { console.log('多个灯光设备匹配该关键词,请进一步筛选。'); } else if(searchResult.id) { console.log(`唯一匹配的灯光设备ID为: ${searchResult.id}`); light.toggleLight({ entity_id: searchResult.id, service: 'turn_on' }); } else { console.log('没有找到匹配的灯光设备。'); } ``` ## 音箱管理 该模块提供对Home Assistant中音箱设备的管理功能,执行文本指令等。 ```ts import { TextHA } from '@kevisual/ha-api'; const tts = new TextHA({ host: 'http://your-home-assistant:8123', token: 'your-long-lived-access-token', }); // 获取所有音箱设备 const entities = await text.getSpeakerEntities(); // 执行文本指令 const res2 = await text.executeTextDirective('text.xiaomi_lx06_9e08_execute_text_directive', '关闭阳台灯'); console.log(res2); ```