MediaPlayer QML Type
장면에 미디어 재생을 추가합니다. 더 보기...
Import Statement: | import QtMultimedia |
In C++: | QMediaPlayer |
속성
- activeAudioTrack : int
- activeSubtitleTrack : int
- activeVideoTrack : int
- audioBufferOutput : QAudioBufferOutput
(since 6.8)
- audioOutput : AudioOutput
- audioTracks : list<mediaMetaData>
- autoPlay : bool
(since 6.7)
- bufferProgress : real
- duration : int
- error : enumeration
- errorString : string
- hasAudio : bool
- hasVideo : bool
- loops : int
- mediaStatus : enumeration
- metaData : mediaMetaData
- playbackRate : real
- playbackState : enumeration
- playing : bool
(since 6.5)
- position : int
- seekable : bool
- source : url
- subtitleTracks : list<mediaMetaData>
- videoOutput : VideoOutput
- videoTracks : list<mediaMetaData>
신호
- errorOccurred(error, errorString)
- playbackStateChanged()
- playingChanged()
방법
자세한 설명
Text { text: "Click Me!"; font.pointSize: 24; width: 150; height: 50; MediaPlayer { id: playMusic source: "music.wav" audioOutput: AudioOutput {} } MouseArea { anchors.fill: parent onPressed: { playMusic.play() } } }
MediaPlayer를 멀티미디어::오디오 출력과 함께 사용하여 오디오 콘텐츠를 재생하거나 멀티미디어::비디오 출력과 함께 사용하여 비디오를 렌더링할 수 있습니다.
Item { MediaPlayer { id: mediaplayer source: "groovy_video.mp4" audioOutput: AudioOutput {} videoOutput: videoOutput } VideoOutput { id: videoOutput anchors.fill: parent } MouseArea { anchors.fill: parent onPressed: mediaplayer.play(); } }
AudioOutput 및 VideoOutput 을참조하세요 .
프로퍼티 문서
activeAudioTrack : int |
이 속성은 현재 활성화된 오디오 트랙의 트랙 번호를 보유합니다. 오디오 트랙을 비활성화하려면 -1
로 설정합니다.
기본 속성 값은 0
: 첫 번째 오디오 트랙입니다.
activeSubtitleTrack : int |
이 속성은 현재 활성화된 자막 트랙의 트랙 번호를 보유합니다. 자막 트랙을 비활성화하려면 -1
로 설정합니다.
기본 속성 값은 -1
: 활성화된 자막 없음입니다.
activeVideoTrack : int |
이 속성에는 현재 활성화된 비디오 오디오 트랙의 트랙 번호가 저장됩니다. 비디오 트랙을 비활성화하려면 -1
로 설정합니다.
기본 속성 값은 0
: 첫 번째 비디오 트랙입니다.
audioBufferOutput : QAudioBufferOutput |
이 프로퍼티는 대상 오디오 버퍼 출력을 보유합니다.
QML에서 MediaPlayer 을 정상적으로 사용하는 경우 이 프로퍼티를 사용할 필요가 없습니다.
이 프로퍼티는 Qt 6.8에 도입되었습니다.
QMediaPlayer::audioBufferOutput()도 참조하십시오 .
audioOutput : AudioOutput |
이 프로퍼티는 대상 오디오 출력을 보유합니다. AudioOutput 엘리먼트 하나를 받아들입니다.
QMediaPlayer::setAudioOutput()도 참조하십시오 .
audioTracks : list<mediaMetaData> |
이 프로퍼티는 메타데이터 목록을 보유합니다. 각 인덱스는 오디오 트랙을 나타냅니다.
메타데이터에는 개별 트랙을 설명하는 속성이 있습니다. 오디오 트랙의 경우 일반적으로 Language 속성이 가장 중요한 속성입니다.
mediaMetaData도 참조하세요 .
autoPlay : bool |
이 속성은 미디어가 로드된 후 자동으로 재생을 시작할지 여부를 제어합니다. 기본값은 false
입니다.
이 프로퍼티는 Qt 6.7에 도입되었습니다.
bufferProgress : real |
이 속성은 0.0
(비어 있음)에서 1.0
(가득 찼음)까지 현재 데이터 버퍼가 얼마나 채워져 있는지를 저장합니다.
버퍼가 완전히 채워진 경우에만 재생을 시작하거나 재개할 수 있습니다. 버퍼가 가득 차면 MediaPlayer.Buffered
이 참입니다. 버퍼 진행률이 0.0
와 1.0
사이이면 MediaPlayer.Buffering
는 true
로 설정됩니다.
1.0
보다 낮은 값은 MediaPlayer.StalledMedia
속성이 true
임을 의미합니다.
mediaStatus도 참조하세요 .
duration : int |
이 속성은 미디어의 지속 시간을 밀리초 단위로 보유합니다.
미디어에 고정된 지속 시간이 없는 경우(예: 라이브 스트림) 0
로 설정됩니다.
error : enumeration |
이 속성은 오디오의 오류 상태를 보유합니다. 다음 중 하나가 될 수 있습니다.
값 | 설명 |
---|---|
NoError | 현재 오류가 없습니다. |
ResourceError | 리소스 할당 문제로 인해 오디오를 재생할 수 없습니다. |
형식 오류 | 오디오 형식이 지원되지 않습니다. |
네트워크 오류 | 네트워크 문제로 인해 오디오를 재생할 수 없습니다. |
액세스 거부 오류 | 권한이 부족하여 오디오를 재생할 수 없습니다. |
errorString : string |
이 속성에는 현재 오류 상태를 자세히 설명하는 문자열이 포함됩니다.
hasAudio : bool |
이 속성은 미디어에 오디오가 포함되어 있는지 여부를 보유합니다.
hasVideo : bool |
이 속성은 미디어에 동영상이 포함되어 있는지 여부를 보유합니다.
loops : int |
플레이어가 중지되기 전에 미디어가 재생되는 빈도를 결정합니다. 현재 미디어 파일을 영원히 반복하려면 MediaPlayer::무한으로 설정합니다.
기본값은 1
입니다. 이 속성을 0
으로 설정해도 아무런 효과가 없습니다.
mediaStatus : enumeration |
이 속성은 미디어 로딩 상태를 유지합니다. 다음 중 하나가 될 수 있습니다:
속성 값 | 설명 |
---|---|
NoMedia | 설정된 미디어가 없습니다. |
LoadingMedia | 현재 미디어가 로드 중입니다. |
로드된 미디어 | 미디어가 로드되었습니다. |
버퍼링 중인 미디어 | 미디어가 데이터를 버퍼링 중입니다. |
StalledMedia | 미디어가 데이터를 버퍼링하는 동안 재생이 중단되었습니다. |
버퍼링된 미디어 | 미디어에 버퍼링된 데이터가 있습니다. |
EndOfMedia | 미디어가 끝까지 재생되었습니다. |
InvalidMedia | 미디어를 재생할 수 없습니다. |
metaData : mediaMetaData |
미디어 플레이어에서 사용하는 현재 미디어에 대한 메타 데이터를 반환합니다.
메타 데이터에는 동영상 제목 또는 제작 날짜 등의 정보가 포함될 수 있습니다.
참고: Windows 구현은 로컬 파일 시스템에 있는 미디어에 대해서만 메타데이터를 제공합니다.
playbackRate : real |
playbackState : enumeration |
이 속성은 미디어 재생 상태를 보유합니다. 다음 중 하나가 될 수 있습니다:
속성 값 | 설명 |
---|---|
재생 상태 | 미디어가 현재 재생 중입니다. playing 속성과 동일한 것을 나타냅니다. |
PausedState | 미디어 재생이 일시 중지되었습니다. |
StoppedState | 미디어 재생이 아직 시작되지 않았습니다. |
playing : bool |
position : int |
이 값은 미디어 시작 이후 현재 재생 위치이며 밀리초 단위로 표시됩니다. 주기적으로 위치가 변경되면 positionChanged() 신호로 표시됩니다.
seekable 속성이 참이면 이 속성을 밀리초로 설정할 수 있습니다.
source : url |
이 속성은 미디어의 소스 URL을 보유합니다.
Item { MediaPlayer { id: mediaplayer source: "file:///test.mp4" videoOutput: videoOutput audioOutput: AudioOutput { } } VideoOutput { id: videoOutput anchors.fill: parent } MouseArea { id: playArea anchors.fill: parent onPressed: mediaplayer.play(); } }
QMediaPlayer::setSource()도 참조하세요 .
subtitleTracks : list<mediaMetaData> |
이 속성은 메타데이터 목록을 보유합니다. 각 인덱스는 자막 트랙을 참조합니다.
메타데이터에는 개별 트랙을 설명하는 속성이 있습니다. 자막 트랙의 경우 일반적으로 Language 가 가장 중요한 속성입니다.
mediaMetaData도 참조하세요 .
videoOutput : VideoOutput |
이 속성은 대상 비디오 출력을 보유합니다. VideoOutput 요소 하나를 허용합니다.
QMediaPlayer::setVideoOutput()도 참조하세요 .
videoTracks : list<mediaMetaData> |
신호 문서
errorOccurred(error, errorString) |
이 신호는 error 가 발생했을 때 전송됩니다. errorString 매개변수에는 오류에 대한 자세한 정보가 포함될 수 있습니다.
참고: 해당 핸들러는 onErrorOccurred
입니다.
QMediaPlayer::Error도 참조하세요 .
playbackStateChanged() |
playbackState 속성이 변경되면 이 신호가 전송됩니다.
참고: 해당 핸들러는 onPlaybackStateChanged
입니다.
playingChanged() |
이 신호는 playing 속성이 변경될 때 발생합니다.
참고: 해당 핸들러는 onPlayingChanged
입니다.
메서드 문서
pause() |
미디어 재생을 일시 중지합니다.
playbackState 속성을 PausedState로 설정하고 playing 을 false
로 변경합니다.
play() |
미디어 재생을 시작하거나 다시 시작합니다.
playbackState 속성을 재생 중 상태로 설정하고 playing 을 true
으로 변경합니다.
stop() |
미디어 재생을 중지합니다.
playbackState 속성을 StoppedState로 설정하고 playing 을 false
로 변경합니다.
© 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.