// Copyright (C) 2024 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
\page qtmultimedia-linux.html
\title Qt Multimedia on Linux
\brief Platform notes for Linux

This page discusses considerations for using Qt Multimedia on Linux.

\section1 Audio backend requirements

Qt Multimedia audio features on Linux requires PulseAudio. The experimental ALSA backend will be
deprecated in future versions of Qt. Until then, community contributions are required to fix issues
with this backend.

For applications that use the GStreamer backend on embedded Linux, see
\l{Qt Multimedia GStreamer backend} for additional PulseAudio requirements.

\section1 Limitations on Linux using the Wayland compositor

The screen capture feature requires the installation of:
\list
    \li The \l {https://flatpak.github.io/xdg-desktop-portal/docs/doc-org.freedesktop.portal.ScreenCast.html}{ScreenCast}
        service supported via \l {https://flatpak.github.io/xdg-desktop-portal/docs/}{XDG Desktop Portal}.
    \li \l {https://pipewire.org/}{PipeWire} (0.3).
\endlist

Due to restrictions of the Wayland protocol, the current screen can only be selected through
the wizard displayed by the operation system when \c QScreenCapture instance is activated.
For additional details, refer to the \l QScreenCapture class documentation.

*/
