Qt IVI Vehicle Functions QML Types

The Qt IVI Vehicle Functions QML API provides a simple way to use vehicle features in QML applications.

Getting Started

The QML application relies on the QML plugin loading capabilities of the Qt QML runtime. This means that an installed Qt IVI module is found automatically.

To import the Qt IVI Vehicle Functions QML types, add the following import statement to your .qml file:

import QtIvi.VehicleFunctions 1.0

Then instantiate the feature element. For most elements, autoDiscovery is set to true when applicable, but in this example we set it explicitly.

 ClimateControl {
    id: climateControl
    autoDiscovery: true
}

When the top-level component has been completed, the isValid property of the feature elements can be used to determine if any of the backends are missing. In some situations this is expected behavior; the isValid property can be used to enable or disable parts of the user interface.

 Component.onCompleted: {
    if (!climateControl.isValid)
        ; // Take action here
}

Some features, like climate control, are divided into zones. The names of the available zones can be fetched with AbstractZonedFeature::availableZones. Zones are available only when the feature is valid.

 ComboBox {
    model: climateControl.availableZones
}

With the AbstractZonedFeature::zoneAt property you can access the climate control zone-specific functions.

climateControl.zoneAt.FrontLeft.seatHeater = true

An example of how to use the AbstractZonedFeature::zones property:

 Repeater {
    model: climateControl.zones
    Text { text: modelData.zone + " seat heater level: " + modelData.seatHeater}
}

Interactions with the feature element are described in the feature documentation. It is possible to bind properties, call methods, and listen to signals.

QML Types

ClimateControl

Provides an interface to the climate control. The QIviClimateControl provides an interface to the climate control of the vehicle. The climate control properties are divided into two categories: central or zoned. The central properties are exposed directly through the QIviClimateControl and the zoned properties are exposed through zone objects. The zones are retrieved using the zoneAt method. The QIviClimateControl expects a single backend to be available. It is recommended to use it with discoveryMode set to AutoDiscovery

WindowControl

Provides an interface to the window control. The QIviWindowControl provides an interface to control the physical windows of the vehicle. All properties are exposed through zone objects. The zones are retrieved using the zoneAt method. The QIviWindowControl expects a single backend to be available. It is recommended to use it with discoveryMode set to zoneAt

© 2018 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.