// 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 require PipeWire or PulseAudio. PipeWire is the recommended
backend on all modern Linux distributions, but PulseAudio will be used if PipeWire is not available.
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.

*/
