Ably is a realtime data delivery platform for internet-enabled devices. This SDK provides pub-sub messaging, presence, message history, and push notifications across multiple platforms including .NET, Xamarin, Unity, and MAUI. See https://www.ably.io for more info.
Build any realtime experience using Ably’s Pub/Sub .NET SDK. Supported on all popular platforms and frameworks, including Unity and MAUI.
Ably Pub/Sub provides flexible APIs that deliver features such as pub-sub messaging, message history, presence, and push notifications. Utilizing Ably’s realtime messaging platform, applications benefit from its highly performant, reliable, and scalable infrastructure.
The following code connects to Ably's realtime messaging service, subscribes to a channel to receive messages, and publishes a test message to that same channel:
// Initialize Ably Realtime client
var realtime = new AblyRealtime("your-ably-api-key");
// Wait for connection to be established
realtime.Connection.On(ConnectionEvent.Connected, args =>
{
Console.WriteLine("Connected to Ably");
});
// Get a reference to the 'test' channel
IRealtimeChannel channel = realtime.Channels.Get("test");
// Subscribe to all messages published to this channel
channel.Subscribe(message =>
{
Console.WriteLine($"Received message: {message.Data}");
});
// Publish a test message to the channel
await channel.PublishAsync("test-event", "Hello World!");
Enable logging using a new class that implements ILoggerSink interface.
class CustomLogHandler : ILoggerSink
{
public void LogEvent(LogLevel level, string message)
{
Console.WriteLine($"Handler LogLevel : {level}, Data :{message}");
}
}
Update clientOptions for LogLevel and LogHandler.
clientOpts.LogLevel = LogLevel.Debug;
clientOpts.LogHandler = new CustomLogHandler();
Unity usage
Download latest ably.io.*.unitypackage from releases section and include it in the unity project.
For help or technical support, visit Ably's support page or GitHub Issues for community-reported bugs and discussions.
Increasing transport send and receive buffers for .NET framework
In high-throughput scenarios, for example, sending messages >50KB, the default WebSocket buffer in the .NET Framework can cause instability or errors. This issue is discussed in GitHub issue #446.
To mitigate this, increase the WebSocket buffer size to the maximum allowed (64KB):
var maxBufferSize = 64 * 1024;
var options = new ClientOptions();
var websocketOptions = new MsWebSocketOptions
{
SendBufferInBytes = maxBufferSize,
ReceiveBufferInBytes = maxBufferSize
};
options.TransportFactory = new MsWebSocketTransport.TransportFactory(websocketOptions);
var realtime = new AblyRealtime(options);
