SwiftBindings.Apple.MatterSupport

SwiftBindings.Apple.MatterSupport

Native .NET bindings for Apple's MatterSupport framework — the Swift-level MatterAddDeviceRequest flow that drives Apple's system commissioning UI for Matter accessories.

📖 Full usage guide → — Swift→C# naming, the add-device request flow, device criteria, and the cross-module Matter.MTRSetupPayload reference.

MatterAddDeviceRequest.setupPayload returns Matter.MTRSetupPayload, so this package takes a NuGet dependency on SwiftBindings.Apple.Matter. dotnet add package SwiftBindings.Apple.MatterSupport pulls both in.

Installation

dotnet add package SwiftBindings.Apple.MatterSupport

Requirements

• .NET 10.0+
• iOS 16.1+ / macOS 13.3+ / Mac Catalyst 16.4+ (MatterAddDeviceRequest.isSupported requires iOS 17+)
• A Matter entitlement on the consuming app and the corresponding com.apple.developer.matter.allow-setup-payload capability

Usage

using Matter;
using MatterSupport;

using var payload = new MTRSetupPayload("MT:U9VJ0OMV172PX813000");
using var home = new MatterAddDeviceRequest.Home("Living Room");
using var topology = new MatterAddDeviceRequest.TopologyType("My Ecosystem", new[] { home });
using var request = new MatterAddDeviceRequest(topology, setupPayload: payload);
await request.PerformAsync();

The MatterAddDeviceRequest.perform() flow drives Apple's system UI for adding a Matter accessory; it can only be invoked on a real device with HomeKit configured. The bindings expose the same shape as Swift — see MatterAddDeviceRequest for the field-level reference.

Documentation

• Usage guide (wiki) — full C# walkthrough of the binding surface
• Apple MatterSupport framework
• Apple Matter framework

How It Works

These bindings are auto-generated by Swift Dotnet Bindings using .NET 10's native Swift interop via the SwiftBindings SDK. The cross-module Matter.MTRSetupPayload reference is satisfied by the sibling SwiftBindings.Apple.Matter package.

License

The bindings are MIT licensed. MatterSupport is part of the Apple SDK; refer to Apple's licensing for the underlying framework.