Homekit.Net存在的意义

通过本依赖包，用户可以通过代码模拟出各种各样的智能家居设备，并添加到苹果手机的家庭app中，这样我们就能在手机上控制这些模拟的智能家居设备执行一些我们在代码里配置好的操作，比如我们可以通过代码控制电脑打开或者关闭某个应用，然后利用本库封装为一个开关，那么我们就可以用家庭app中的这个模拟开关来控制应用了。有了原生api，大家就可以尽情的发挥想象力去搞事情了，比如DIY一个自动喂鱼机？

Getting Started

Nuget

接下来我将演示如何使用【Homekit.Net】,你可以运行以下命令在你的项目中安装 Homekit.Net 。

PM> Install-Package Homekit.Net

支持框架

net 6,net 8

示例

在demo示例中，当前已支持开关，传感器，空调。接下来演示如何使用： 通过继承类Accessory，我们就可以自定义一个自己的配件，在下面的示例中，我们定义一个开关，在构造函数中，我们加载一个名为Switch的服务，并且定义配件类型为开关，从switch服务中获取on这个特性，通过操作on这个特性，我们就可以通过代码模拟开关状态变化了，并且可以在苹果手机的家庭app上看到开关状态的变化。

publicclassSwitch:Accessory{privateboolIsOn;privateTimertimer;publicCharacteristicsCurrentOnCharacteristics{get;set;}publiceventAction<object>OnChange;publicSwitch(AccessoryDriveraccessoryDriver,stringname,int?aid=null):base(accessoryDriver,name,aid){//加载switch开关服务varservice=AddPreloadService("Switch");//定义配件种类为开关Category=Category.CATEGORY_SWITCH;//从switch服务中获取on这个特性CurrentOnCharacteristics=service.GetCharacteristics("On");//添加开关状态被家庭app改变后的回调函数CurrentOnCharacteristics.SetValueCallback=(o =>{OnChange(o);this.IsOn=(bool)o;});//定义一个定时器，定时改变开关状态，用来模拟开关状态变化//timer = new Timer(Test, default, TimeSpan.FromSeconds(30), TimeSpan.FromSeconds(30));}publicvoidTest(object?state){varrandom=newRandom();varnumber=random.Next(1,50);varisOn=number%2==0;CurrentOnCharacteristics.SetValue(isOn);timer.Change(TimeSpan.FromSeconds(30),TimeSpan.FromSeconds(30));}}

接下来，我们再来一个示例，定义一个温度传感器，在构造函数中，我们加载一个名为TemperatureSensor的服务，并且定义配件类型为传感器，从TemperatureSensor服务中获取CurrentTemperature(当前温度)这个特性，通过代码操作CurrentTemperature这个特性，我们就可以模拟温度变化，并且在苹果手机的家庭app上看到温度变化了。

publicclassTemperatureSensor:Accessory{publicCharacteristicsCurrentTemperatureCharacteristics{get;set;}privateTimertimer;publicTemperatureSensor(AccessoryDriveraccessoryDriver,stringname,CancellationTokentoken=default):base(accessoryDriver,name){//加载TemperatureSensor温度服务varservice=AddPreloadService("TemperatureSensor");//定义配件种类为传感器Category=Category.CATEGORY_SENSOR;//从TemperatureSensor服务中获取CurrentTemperature(当前温度)这个特性CurrentTemperatureCharacteristics=service.GetCharacteristics("CurrentTemperature");//设置温度为1CurrentTemperatureCharacteristics.SetValue(1);//定义一个定时器，定时改变温度，用来模拟温度变化timer=newTimer(Test,token,TimeSpan.FromSeconds(30),TimeSpan.FromSeconds(30));}publicvoidTest(object?state){if(stateisCancellationTokentoken&&token.IsCancellationRequested){return;}// Console.WriteLine(DateTime.Now+"触发了定时任务");varrandom=newRandom();varwd=random.Next(1,50);// Console.WriteLine($"设置温度为{wd}度");CurrentTemperatureCharacteristics.SetValue(wd);timer.Change(TimeSpan.FromSeconds(30),TimeSpan.FromSeconds(30));}}

具体有哪些服务和特征，可以在程序运行起来后，查看Resources文件夹下的json文件

配件定义结束以后，我们就要让这个配件跑起来了，新建一个控制台程序，代码如下：

internalclassProgram{privateasyncstaticTaskSingleAccessory(){varcts=newCancellationTokenSource();//先定义驱动vardriver=newAccessoryDriver(port:6555);//定义配件varswitchAccessory1=newSwitch(driver,"switch开关");//添加开关状态被苹果手机的家庭app改变后的回调switchAccessory1.OnChange+=async(o)=>{Console.WriteLine("The switch state has changed.开关状态变化了");};driver.AddAccessory(switchAccessory1);awaitdriver.StartAsync(cts.Token);}privateasyncstaticTaskMultipleAccessories(){varcts=newCancellationTokenSource();//先定义驱动vardriver=newAccessoryDriver(port:6554);//定义网关varbridge=newBridge(driver,"网关");//定义配件1开关varswitchAccessory1=newSwitch(driver,"开关switch");bridge.AddAccessory(switchAccessory1);//添加开关状态被苹果手机的家庭app改变后的回调switchAccessory1.OnChange+=async(o)=>{Console.WriteLine("The switch state has changed.开关状态变化了");};//定义配件2传感器vartemperatureSensor=newTemperatureSensor(driver,"传感器TemperatureSensor");bridge.AddAccessory(temperatureSensor);driver.AddAccessory(bridge);awaitdriver.StartAsync(cts.Token);}asyncstaticTaskMain(string[]args){//Test Multiple Accessories 测试单配件awaitSingleAccessory();//Test Multiple Accessories 测试多配件//await MultipleAccessories();}}

以上这段代码分为2个部分，SingleAccessory单配件示例，和MultipleAccessories多配件示例，大体流程就是首先定义一个驱动，接着实例化之前定义的配件，并且把配件加入到驱动中，最后启动驱动即可。启动后效果如下图，他会在控制台上打印出一个二维码，

接着我们使用苹果手机的家庭app扫描这个二维码，即可添加我们代码中自定义的配件。注意！苹果手机与程序必须处于同一个局域网，同时确保手机没有开启VPN。

如果我们想在程序中定义多个配件，那么参考MultipleAccessories方法，首先得定义一个网关，接着把我们定义的多个配件添加到网关里，最后再启动驱动。

驱动支持持久化连接信息，信息存储在state.json中，这样应用重启后，也不需要重新扫码连接。

开源地址，欢迎star

本项目基于MIT协议开源，地址为 https://github.com/TripleView/HomeKit.Net

感谢以下项目

1. HAP-Python

2. ZeroConfig

写在最后

如果各位靓仔觉得这个项目不错，欢迎一键三连（推荐，star，关注）,同时欢迎加入三合的开源交流群，QQ群号：799648362