QtMultimedia QML Type

Provides a global object with useful functions from Qt Multimedia. More...

Import Statement: import QtMultimedia 5.7
Since: QtMultimedia 5.4


Detailed Description

The QtMultimedia object is a global object with utility functions and properties.

It is not instantiable; to use it, call the members of the global QtMultimedia object directly. For example:

Camera {
    deviceId: QtMultimedia.defaultCamera.deviceId

Property Documentation

[read-only] availableCameras : list<object>

This property provides information about the cameras available on the system.

Each object in the list has the following properties:

deviceIdThis read-only property holds the unique identifier of the camera.

You can choose which device to use with a Camera object by setting its deviceId property to this value.

displayNameThis read-only property holds the human-readable name of the camera. You can use this property to display the name of the camera in a user interface.
positionThis read-only property holds the physical position of the camera on the hardware system. Please see Camera.position for more information.
orientationThis read-only property holds the physical orientation of the camera sensor. Please see Camera.orientation for more information.

Note: This property is static; it is not updated when cameras are added or removed from the system, like USB cameras on a desktop platform.

The following example shows how to display a list of available cameras. The user can change the active camera by selecting one of the items in the list.

Item {

    Camera {
        id: camera

    VideoOutput {
        anchors.fill: parent
        source: camera

    ListView {
        anchors.fill: parent

        model: QtMultimedia.availableCameras
        delegate: Text {
            text: modelData.displayName

            MouseArea {
                anchors.fill: parent
                onClicked: camera.deviceId = modelData.deviceId

[read-only] defaultCamera : object

The defaultCamera object provides information about the default camera on the system.

Its properties are deviceId, displayName, position and orientation. See availableCameras for a description of each of them.

If there is no default camera, defaultCamera.deviceId will contain an empty string.

Note: This property is static; it is not updated if the system's default camera changes after the application started.

© 2016 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.