PlaybackOptions QML Type
저수준 미디어 재생 옵션. 더 보기...
| Import Statement: | import QtMultimedia |
| Since: | Qt 6.10 |
| In C++: | QPlaybackOptions |
속성
- networkTimeoutMs : qint64
(since 6.10) - playbackIntent : enumeration
(since 6.10) - probeSize : qsizetype
(since 6.10)
자세한 설명
재생 옵션은 미디어 재생 옵션에 대한 저수준 제어를 제공합니다. MediaPlayer 의 기본 설정을 사용하는 것을 강력히 권장하지만, 기본 옵션이 적합하지 않은 특정 사용 사례에서는 PlaybackOptions를 사용하여 미디어 재생을 최적화할 수 있습니다.
이 옵션들은 미디어 백엔드에 대한 참고 사항일 뿐이며, 현재 미디어 형식이나 코덱에서 지원되지 않는 경우 무시될 수 있습니다.
재생 옵션은 미디어 백엔드의 지원 여부에 따라 달라집니다. 사용 가능 여부는 각 옵션별로 문서화되어 있습니다.
MediaPlayer도 참조하십시오 .
속성 문서
networkTimeoutMs : qint64 [since 6.10]
일부 네트워크 형식에서 소켓 I/O 작업에 사용되는 네트워크 타임아웃(밀리초 단위)을 설정합니다.
이 옵션은 FFmpeg 미디어 백엔드에서만 지원됩니다.
이 속성은 Qt 6.10에서 도입되었습니다.
playbackIntent : enumeration [since 6.10]
MediaPlayer 가 안정적인 고화질 동영상 재생(기본값)을 위해 최적화할지, 아니면 저지연 스트리밍을 위해 최적화할지 결정합니다.
이 옵션은 FFmpeg 미디어 백엔드에서만 지원됩니다.
| 상수 | 설명 |
|---|---|
PlaybackOptions.Playback | 목적은 안정적이고 고품질의 미디어 재생을 위한 것으로, 재생 중 끊김 현상을 방지하기 위해 충분한 버퍼링을 활성화합니다. |
PlaybackOptions.LowLatencyStreaming | 저지연 스트리밍에 최적화하기 위해 버퍼링이 줄어들지만, 재생 중 프레임 손실이나 기타 오류가 발생할 가능성이 높아집니다. |
이 속성은 Qt 6.10에서 도입되었습니다.
probeSize : qsizetype [since 6.10]
Probesize는 미디어 재생이 시작되기 전에 스트림 정보를 수집하기 위해 분석할 데이터의 양(바이트 단위)을 정의합니다.
probesize 값이 클수록 재생 안정성은 높아지지만 지연 시간이 늘어날 수 있습니다. 반대로, probesize 값이 작을수록 지연 시간은 줄어들 수 있지만 일부 스트림 세부 정보를 놓칠 수도 있습니다. 기본 probesize 값은 -1이며, 실제 probesize는 미디어 백엔드에서 결정됩니다.
probesize 값이 너무 작으면 미디어 재생에 실패할 수 있으며, probeSize 값이 너무 크면 지연 시간이 증가할 수 있습니다.
이 옵션은 FFmpeg 미디어 백엔드에서만 지원됩니다.
이 속성은 Qt 6.10에서 도입되었습니다.
© 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.