小米Yeelight智能灯泡控制C# API (.Net)源码教程

【实例简介】
YeelightAPI是一个用于控制小米Yeelight彩色灯泡的C# API (.Net)。它支持单个设备和多设备控制，包括开关、亮度调整、颜色变换等功能。

首先，确保您的Visual Studio版本是最新的，并且已经在设备上启用了“开发者模式”。通过NuGet包管理器安装最新版本的YeelightAPI即可开始。

使用时，您可以简单地创建一个新的Device对象，通过IP地址或主机名进行实例化：

Device device = new Device("hos.tna.meo.rIP");
device.Connect();

然后，您可以使用device对象来控制设备，例如：

• 开关电源：device.SetPower(true);
• 切换状态：device.Toggle();
• 调整亮度级别：device.SetBrightness(100);
• 改变颜色：device.SetRGBColor(80, 244, 255);

此外，YeelightAPI还支持颜色流功能，允许您为设备编程以实现不同的状态变化。

如果需要控制多个设备，可以使用YeelightAPI.DeviceGroup类。这个类从原生的.net List<Device>继承，并实现了IDeviceController接口，允许您以与控制单个设备相同的方式来控制多个设备。

对于设备发现，YeelightAPI提供了一个静态异步API，使您能够发现所有已连接的设备。

YeelightAPI几乎每个方法都是可等待的，返回一个Task或Task<T>，以便异步执行。当设备状态发生变化时，YeelightAPI会发送通知，并通过"OnNotificationReceived"事件接收这些通知。

【实例截图】

【核心代码】
文件清单
└── YeelightAPI-9cf6f3d0b1f75dae05aec9965c2eac17acba5bd1
    ├── LICENSE
    ├── README.md
    ├── YeelightAPI
    │   ├── Core
    │   │   ├── CommandResultHandler.cs
    │   │   ├── Constants.cs
    │   │   ├── DiscoveryResult.cs
    │   │   ├── ICommandResultHandler.cs
    │   │   ├── PropertiesDictionaryConverter.cs
    │   │   ├── PropertiesExtensions.cs
    │   │   ├── RealNameAttribute.cs
    │   │   ├── RealNameAttributeExtensions.cs
    │   │   ├── RGBColorHelper.cs
    │   │   └── TcpClientExtensions.cs
    │   ├── Device.cs
    │   ├── DeviceDiscoveryException.cs
    │   ├── DeviceGroup.cs
    │   ├── DeviceGroup.IBackgroundDeviceController.cs
    │   ├── DeviceGroup.IDeviceController.cs
    │   ├── Device.IBackgroundDeviceController.cs
    │   ├── Device.IDeviceController.cs
    │   ├── Device.IDeviceReader.cs
    │   ├── DeviceLocator.cs
    │   ├── Events
    │   │   ├── DeviceFoundEventArg.cs
    │   │   └── NotificationReceivedEventArgs.cs
    │   ├── icon.png
    │   ├── Interfaces
    │   │   ├── IBackgroundDeviceController.cs
    │   │   ├── IDeviceController.cs
    │   │   └── IDeviceReader.cs
    │   ├── Models
    │   │   ├── Adjust
    │   │   │   ├── AdjustAction.cs
    │   │   │   └── AdjustProperty.cs
    │   │   ├── ColorFlow
    │   │   │   ├── Colorflow.cs
    │   │   │   ├── ColorFlowEndAction.cs
    │   │   │   ├── ColorFlowExpression.cs
    │   │   │   ├── ColorFlowMode.cs
    │   │   │   ├── ColorFlowRGBExpression.cs
    │   │   │   ├── ColorFlowSleepExpression.cs
    │   │   │   └── ColorTemperatureFlowExpression.cs
    │   │   ├── Command.cs
    │   │   ├── CommandResult.cs
    │   │   ├── Cron
    │   │   │   ├── CronResult.cs
    │   │   │   └── CronType.cs
    │   │   ├── FluentFlow.cs
    │   │   ├── Methods.cs
    │   │   ├── Model.cs
    │   │   ├── Music
    │   │   │   └── MusicAction.cs
    │   │   ├── NotificationResult.cs
    │   │   ├── PowerOnMode.cs
    │   │   ├── Properties.cs
    │   │   └── Scene
    │   │       ├── SceneClass.cs
    │   │       └── Scene.cs
    │   ├── packages.config
    │   ├── Properties
    │   │   └── AssemblyInfo.cs
    │   ├── README.txt
    │   └── YeelightAPI.csproj
    ├── YeelightAPI.Console
    │   ├── App.config
    │   ├── packages.config
    │   ├── Program.cs
    │   └── YeelightAPI.Console.csproj
    ├── YeelightAPI.sln
    └── YeelightAPI.UnitTests
        ├── config.json
        ├── DeviceTests.cs
        ├── DiscoveryTests.cs
        ├── xunit.runner.json
        └── YeelightAPI.UnitTests.csproj

14 directories, 63 files