Revue.MqttOptions

nonisolated struct MqttOptions

Overview

• brokerUrl: scheme must be tcp / ssl / tls / mqtts / ws / wss, e.g. wss://www.arctos.tw/mqtt; nil = the core built-in broker (wss://www.arctos.tw/mqtt). Invalid values make initialize throw .invalidConfiguration.

• username / password: nil = core built-in credentials.

• caCertPath: PEM CA bundle path supplied by the App; nil = no server certificate verification (the core logs a warning for TLS brokers). Used only for TLS schemes.

• presenceQos: QoS for presence publish/subscribe/LWT, 0-2, default 1; out of range throws .invalidConfiguration.

• deferStart: true = initialize does not start presence: no MQTT client is created, the broker is never contacted and no presence events are delivered. The other fields are ignored while deferred. Use deferred for this case and call Revue.startPresence(_:) later with the real settings. It applies to one initialize only. startPresence(_:) ignores this field.

Topics

Initializers

• init(brokerUrl: String?, username: String?, password: String?, caCertPath: String?, presenceQos: Int, deferStart: Bool)

Instance Properties

• var brokerUrl: String?
• var caCertPath: String?
• var deferStart: Bool
• var password: String?
• var presenceQos: Int
• var username: String?

Type Properties

• static var deferred: MqttOptions

  Settings for an App that has no MQTT account yet: initialize does not start presence. Call Revue.startPresence(_:) after the user signs in.