- Qt 5.5
- Qt Multimedia
- QML Types
- QtMultimedia QML Type
- Qt 5.5.1 Reference Documentation

# QtMultimedia QML Type

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

Import Statement: | import QtMultimedia 5.5
Since: | QtMultimedia 5.4

- List of all members, including inherited members

## Properties

- availableCameras : list<object>
- defaultCamera : object

## 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:

`deviceId` | This 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.
`displayName` | This 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.
`position` | This read-only property holds the physical position of the camera on the hardware system. Please see Camera.position for more information.
`orientation` | This 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.