DefaultVehicleProvider

public class DefaultVehicleProvider : VehicleProvider

Provides a thread-safe implementation of the VehicleProvider.

Provides option to update vehicle or specified vehicle parameters only and subscribe to parameter changes.

Important

This is a Public Preview API. It may be changed or removed at any time.

Initializer

  • Initializes default vehicle provider.

    Declaration

    Swift

    public init(vehicle: Vehicle = Car(combustionEngine: CombustionEngine()))

    Parameters

    vehicle

    The current vehicle to be provided. If not specified the default value is Car with CombustionEngine.

Public

  • Snapshot of the current vehicle state.

    Declaration

    Swift

    public var vehicleSnapshot: Vehicle { get }

  • Represents current vehicle state.

    Setting the new vehicle notifies observers that the vehicle parameters changed. Setting the new vehicle is only expected on the main queue.

    Declaration

    Swift

    public var vehicle: Vehicle { get set }

  • Registers vehicle update observer for all vehicle parameter updates. It is expected to be called on the main queue.

    Throws

    Throws:VehicleError.alreadyRegisteredObserver upon adding the same observer more than once.

    Declaration

    Swift

    public func registerVehicleUpdateObserver(_ observer: AnyVehicleUpdateObserver) throws

    Parameters

    observer

    The observer to be registered.

  • Registers vehicle update observer for specific vehicle parameter updates. It is expected to be called on the main queue.

    Throws

    Throws:VehicleError.alreadyRegisteredObserver upon adding the same observer more than once.

    Declaration

    Swift

    public func registerVehicleUpdateObserver(
    _ observer: AnyVehicleUpdateObserver,
    options: [VehicleUpdateOption]
) throws

    Parameters

    observer

    The observer to be registered.
    parameters

    Specify which parameters should trigger observer notifications.

  • Removes previously registered observer. It is expected to be called on the main queue.

    Declaration

    Swift

    public func unregisterVehicleUpdateObserver(_ observer: AnyVehicleUpdateObserver)

    Parameters

    observer

    The registered observer.

  • Updates the vehicle state with specified parameters only.

    Throws

    VehicleError.invalidVehicleParameter If vehicle parameters are not valid for the current vehicle type.

    Updating vehicle state notifies observers of the vehicle parameters changed. It is expected to be called on the main queue.

    Declaration

    Swift

    public func updateVehicleState(with parameters: [VehicleParameter]) throws

    Parameters

    parameters

    The vehicle parameters update.