MqttClientOptionsBuilder.WithWebSocketsServer is marked as obsolete but there is no example for the alternative

[timothyparez]

It seems like the API surface for this library changes with every single release.

The following method was working perfectly fine and straightforward:

MQTTnet/Source/MQTTnet/Client/Options/MqttClientOptionsBuilder.cs

Line 424 in ae84aa4

public MqttClientOptionsBuilder WithWebSocketServer(string uri, MqttClientOptionsBuilderWebSocketParameters parameters = null)

.WithWebSocketsServer("ws://....");

We're now asked to use the following instead:

        public MqttClientOptionsBuilder WithWebSocketServer(Action<MqttClientWebSocketOptionsBuilder> configure)
        {
            if (configure == null)
            {
                throw new ArgumentNullException(nameof(configure));
            }

            var webSocketOptionsBuilder = new MqttClientWebSocketOptionsBuilder();
            configure.Invoke(webSocketOptionsBuilder);

            _webSocketOptions = webSocketOptionsBuilder.Build();
            return this;
        }

But it's not clear how this is supposed to be used:

clientOptionsBuilder.WithWebSocketServer((MqttClientWebSocketOptionsBuilder b) => 
{
    b.WithUri("ws://.....");
    //or
    b = b.WithUri("ws://....");
    //because the following is not available:
    b.Uri = "ws://.....";
});

The Wiki points towards the Samples but the samples are out of date.

What is, currently, the correct way to connect to a WebSockets host ?