1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
/****************************************************************************
**
** Copyright (C) 2021 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt for Multimedia module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 2.0 or (at your option) the GNU General
** Public license version 3 or any later version approved by the KDE Free
** Qt Foundation. The licenses are as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-2.0.html and
** https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\page changes.html
\title Changes in Qt Multimedia
\brief A description of changes in this version of Qt Multimedia
The Qt Multimedia module in Qt 6 replaces the Qt Multimedia module from Qt 5.x.
Existing code that uses Qt Multimedia from Qt 5 can be ported with limited effort.
The \l {changed features} section highlights changes relevant to porting.
\section1 New features in Qt 6
There are a number of new features in Qt Multimedia:
\list
\li QMediaCaptureSession class is the central object for media capture.
\li Changed QMediaRecorder class to be a high level class for audio/video
recording.
\li new QMediaEncoder class to handle encoding of data produced in a capture
session.
\li Setting up the desired encoding when recording has changed significantly.
see QMediaEncoderSettings for details.
\li Support for selection of audio, video and subtitle tracks when playing
back media files has been added.
\li QAudioDecoder is now supported on all platforms.
\endlist
\section1 Removed Features
\table 70%
\header
\li Removed feature
\li Notes or suggested alternative
\row
\li Playlist in QMediaPlayer
\li QMediaPlayer does not do any playlist handling anymore in Qt 6.
The QMediaPlayList class does however still exist and provides this
functionality. Users will need to connect the playlist to the mediaplayer
themselves to handle playlists.
\row
\li QAudioProbe and QVideoProbe
\li The audio and video probing API has been removed.
\row
\li QAudioRecorder and the Audio QML type
\li Use a QMediaCaptureSession or the CaptureSession QML type.
\row
\li QMediaObject and QMediaBindableInterface
\li These classes have been removed in favor of a more direct API for
setting up connections between objects using e.g. setVideoOutput and
QMediaCaptureSession.
\row
\li QCameraViewFinderSettings
\li This class has been removed. Use QCameraFormat to define the
resolution and frame rate the camera should be using.
\row
\li QMediaContent
\li The class has been removed. Use QMediaPlayList for playlists and
QUrl for individual media files instead.
\row
\li QSound
\li Use QSoundEffect instead.
\row
\li QVideoFilterRunnable
\li Use \l{shader effects} in QML instead or access the QVideoFrame's
content in C++.
\row
\li Public back end API
\li The back end API of Qt Multimedia is private in Qt 6. This improves
response time for supporting new multimedia use cases. This includes all
classes that contain "Control" or "Abstract" in the class name in Qt 5.
\row
\li Back ends as plugins
\li Qt Multimedia in Qt 6 does not use a plugin infrastructure for its
back ends anymore.
This means that users no longer need to ship those back ends with their
application. Instead, the back end being used is determined at compile
time based on the underlying operating system. Qt uses \l gstreamer on
Linux, WMF on Windows, AVFoundation on macOS and iOS and the Android
multimedia APIs on Android.
\endtable
\section1 Changed features
A number of classes previously offered in Qt Multimedia or Qt Multimedia Kit have
changed in ways that may affect previously written code. The following table
highlights these changes.
\table 70%
\header
\li Changed feature
\li Notes
\row
\li Handling of Camera resolutions and frame rates
\li Handling of these has been simplified and a new QCameraFormat class
helps with selecting the correct resolution and frame rate for the camera.
\row
\li Video output handling on the C++ side has changed significantly.
\li QAbstractVideoSurface has been replaced by the QVideoSink class, and
generic rendering support has been enhanced to cover all \l{pixel format}s
supported by Qt Multimedia.
\row
\li Metadata types
\li QMediaMetaData has changed significantly: mainly moving from string
based to enum based keys, and reducing the set of supported keys to the
ones that can be supported on most platforms.
\row
\li QMediaFormat
\li Handling of formats for encoded media and the settings for the media
encoder have changed significantly. Qt 5 provides a string based
API, a separated file format, and audio and video codecs into 3 classes.
However, Qt 6 unifies the formats in the QMediaFormat class, and encoder
settings in QMediaEncoderSettings. Setting up file formats and codecs
is now enum based and no longer uses strings. This puts some
limitations on the set of codecs that can be used, but helps provide a
consistent cross-platform API.
\row
\li QCameraImageCapture renamed QImageCapture
\li None
\endtable
*/
|
