QPlaybackOptions Class
QPlaybackOptions 클래스를 사용하면 미디어 재생 옵션의 로우 레벨 제어가 가능합니다. 더 보기...
| Header: | #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
공공 기능
| 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
고품질 재생 또는 지연 시간이 짧은 미디어 스트리밍에 중점을 두도록 미디어 재생 의도를 구성합니다.
| Constant | 값 | 설명 |
|---|---|---|
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
프로브사이즈는 미디어 재생이 시작되기 전에 스트림 정보를 수집하기 위해 분석할 데이터의 양(바이트 단위)을 정의합니다.
프로브사이즈 값이 클수록 더 안정적인 재생이 가능하지만 지연 시간이 늘어날 수 있습니다. 반대로 프로브 크기가 작으면 지연 시간을 줄일 수 있지만 일부 스트림 세부 정보를 놓칠 수 있습니다. 기본 프로브 크기는 -1이며, 실제 프로브 크기는 미디어 백엔드에서 결정합니다.
이 옵션은 FFmpeg 미디어 백엔드에서만 지원됩니다.
이 프로퍼티는 Qt 6.10에 도입되었습니다.
액세스 함수:
| qsizetype | probeSize() const |
| void | setProbeSize(qsizetype probeSizeBytes) |
| void | resetProbeSize() |
© 2025 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.
