QPlaybackOptions Class
QPlaybackOptions 클래스는 미디어 재생 옵션을 저수준에서 제어할 수 있게 해줍니다. 더 보기...
| 헤더: | #include <QPlaybackOptions> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| 다음부터: | Qt 6.10부터 |
| QML에서: | PlaybackOptions |
공개 유형
(since 6.10) enum class | PlaybackIntent { Playback, LowLatencyStreaming } |
속성
(since 6.10)networkTimeout : std::chrono::milliseconds(since 6.10)playbackIntent : PlaybackIntent(since 6.10)probeSize : qsizetype
공개 함수
| QPlaybackOptions(QPlaybackOptions &&) | |
| std::chrono::milliseconds | networkTimeout() const |
| QPlaybackOptions::PlaybackIntent | playbackIntent() const |
| qsizetype | probeSize() const |
| void | resetNetworkTimeout() |
| void | resetPlaybackIntent() |
| void | resetProbeSize() |
| void | setNetworkTimeout(std::chrono::milliseconds timeout) |
| void | setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent) |
| void | setProbeSize(qsizetype probeSizeBytes) |
상세 설명
QPlaybackOptions는 미디어 재생 옵션에 대한 저수준 제어를 제공합니다. QMediaPlayer 의 기본 설정을 사용하는 것을 강력히 권장하지만, 기본 옵션이 적합하지 않은 특정 사용 사례에서는 QPlaybackOptions를 사용하여 미디어 재생을 최적화할 수 있습니다.
옵션은 미디어 백엔드에 대한 참고 사항일 뿐이며, 현재 미디어 형식이나 코덱에서 지원되지 않는 경우 무시될 수 있습니다.
재생 옵션은 미디어 백엔드의 지원 여부에 따라 달라집니다. 사용 가능 여부는 각 옵션별로 문서화되어 있습니다.
QMediaPlayer도 참조하십시오 .
멤버 유형 문서
[since 6.10] enum class QPlaybackOptions::PlaybackIntent
미디어 재생의 목적을 고품질 재생 또는 저지연 미디어 스트리밍 중 하나에 중점을 두도록 구성합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QPlaybackOptions::PlaybackIntent::Playback | 0 | 이 인텐트는 안정적이고 고품질의 미디어 재생을 목표로 하며, 재생 중 끊김 현상을 방지하기 위해 충분한 버퍼링을 허용합니다. |
QPlaybackOptions::PlaybackIntent::LowLatencyStreaming | 1 | 저지연 스트리밍에 최적화하기 위해 버퍼링이 줄어들지만, 재생 중 프레임 손실이나 기타 오류가 발생할 가능성이 높아집니다. |
이 열거형은 Qt 6.10에서 도입되었습니다.
속성 문서
[since 6.10] networkTimeout : std::chrono::milliseconds
일부 네트워크 형식에서 소켓 I/O 작업에 사용되는 네트워크 타임아웃을 설정합니다.
이 옵션은 FFmpeg 미디어 백엔드에서만 지원됩니다.
이 열거형은 Qt 6.10에서 도입되었습니다.
액세스 함수:
| std::chrono::milliseconds | networkTimeout() const |
| void | setNetworkTimeout(std::chrono::milliseconds timeout) |
| void | resetNetworkTimeout() |
[since 6.10] playbackIntent : PlaybackIntent
QMediaPlayer 가 안정적인 고화질 동영상 재생(기본값)을 위해 최적화할지, 아니면 저지연 스트리밍을 위해 최적화할지 결정합니다.
이 옵션은 FFmpeg 미디어 백엔드에서만 지원됩니다.
이 열거형은 Qt 6.10에서 도입되었습니다.
액세스 함수:
| QPlaybackOptions::PlaybackIntent | playbackIntent() const |
| void | setPlaybackIntent(QPlaybackOptions::PlaybackIntent intent) |
| void | resetPlaybackIntent() |
[since 6.10] probeSize : qsizetype
Probesize는 미디어 재생이 시작되기 전에 스트림 정보를 수집하기 위해 분석할 데이터의 양(바이트 단위)을 정의합니다.
probesize 값을 크게 설정하면 재생 안정성이 높아지지만 지연 시간이 늘어날 수 있습니다. 반대로, probesize 값을 작게 설정하면 지연 시간을 줄일 수 있지만 일부 스트림 세부 정보를 놓칠 수도 있습니다. 기본 probesize 값은 -1이며, 실제 probesize는 미디어 백엔드에 의해 결정됩니다.
이 옵션은 FFmpeg 미디어 백엔드에서만 지원됩니다.
이 열거형은 Qt 6.10에서 도입되었습니다.
액세스 함수:
| qsizetype | probeSize() const |
| void | setProbeSize(qsizetype probeSizeBytes) |
| void | resetProbeSize() |
멤버 함수 문서
[constexpr noexcept default] QPlaybackOptions::QPlaybackOptions(QPlaybackOptions &&)
QPlaybackOptions 의 인스턴스를 move-construct로 생성합니다.
© 2026 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.
