QMediaPlayer Class

player = new QMediaPlayer;
audioOutput = new QAudioOutput;
player->setAudioOutput(audioOutput);
connect(player, &QMediaPlayer::positionChanged, this, &MediaExample::positionChanged);
player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
audioOutput->setVolume(0.5);
player->play();

속성 설명

activeAudioTrack : int

현재 활성화된 오디오 트랙을 반환합니다.

기본적으로 사용 가능한 첫 번째 오디오 트랙이 선택됩니다.

index 를 -1 로 설정하면 모든 오디오 트랙이 비활성화됩니다.

액세스 함수:

알림 신호:

activeSubtitleTrack : int

현재 활성화된 자막 트랙을 반환합니다.

index 를 -1 로 설정하면 자막이 비활성화됩니다.

자막은 기본적으로 비활성화되어 있습니다.

액세스 함수:

알림 신호:

activeVideoTrack : int

현재 활성화된 비디오 트랙을 반환합니다.

기본적으로 사용 가능한 첫 번째 오디오 트랙이 선택됩니다.

모든 비디오 트랙을 비활성화하려면 ` index `를 ` -1 `로 설정하십시오.

액세스 함수:

알림 신호:

[since 6.8] audioBufferOutput : QAudioBufferOutput*

이 속성은 미디어 플레이어에서 사용하는 출력 오디오 버퍼를 저장합니다.

미디어 플레이어에 오디오 버퍼 output 를 설정합니다.

QAudioBufferOutput 가 지정되고 미디어 소스에 오디오 스트림이 포함된 경우, 미디어 플레이어는 디코딩된 오디오 데이터가 포함된 오디오 버퍼와 함께 QAudioBufferOutput::audioBufferReceived 신호를 출력합니다. 오디오 스트림이 끝날 때, QMediaPlayer 는 빈 QAudioBuffer 를 출력합니다.

QMediaPlayer 지정된 경우, 오디오 출력 장치로 해당 데이터를 푸시하는 동시에 오디오 버퍼를 출력합니다. 그러나 오디오 버퍼화 과정으로 인해 소리가 약간 지연되어 재생될 수 있습니다.

발출되는 오디오 버퍼의 형식은 지정된 output 에서 가져오거나, output 가 유효하지 않은 형식을 반환하는 경우 일치하는 오디오 스트림에서 가져옵니다. 발출된 오디오 데이터는 현재 재생 속도에 따라 스케일링되지 않습니다.

QAudioBufferOutput 와 QMediaPlayer 를 함께 활용할 수 있는 잠재적인 사용 사례는 다음과 같습니다:

• 오디오 시각화. 미디어 플레이어의 재생 속도가 1 와 일치하지 않는 경우, 시각화 도구의 요구 사항에 따라 출력 이미지 크기를 조정하거나 이미지 업데이트 간격을 조절할 수 있습니다.
• 음성 인식과 같은 AI 기반 오디오 처리.
• 외부 오디오 출력으로 데이터 전송. 재생 속도 변경, 비디오와의 동기화, 중지 및 탐색 시 수동 플러싱을 고려해야 합니다. 특별한 이유가 없는 한, 이러한 목적으로 오디오 버퍼 출력을 사용하는 것은 권장하지 않습니다.

이 열거형은 Qt 6.8에서 도입되었습니다.

액세스 함수:

Notifier 신호:

audioOutput : QAudioOutput*

이 속성은 미디어 플레이어가 사용하는 오디오 출력 장치를 저장합니다.

미디어를 재생할 때 사용될 현재 오디오 출력 장치입니다. 새로운 오디오 출력을 설정하면 현재 사용 중인 출력이 대체됩니다.

이 속성을 ` nullptr `로 설정하면 모든 오디오 출력이 비활성화됩니다.

액세스 함수:

알림 신호:

[read-only] audioTracks : QList<QMediaMetaData>

미디어 내에 포함된 사용 가능한 오디오 트랙 집합을 나열합니다.

반환되는 ` QMediaMetaData `는 개별 트랙의 속성을 설명합니다.

예를 들어, 서로 다른 오디오 트랙에는 서로 다른 언어로 된 오디오가 포함될 수 있습니다.

액세스 함수:

알림 신호:

[read-only] bufferProgress : float

이 속성은 재생이 시작되거나 재개되기 전, 임시 버퍼가 채워진 비율을 나타내며, 값의 범위는 0(비어 있음)부터 1(가득 찼음)까지입니다.

플레이어 객체가 버퍼링 중일 때, 이 속성은 임시 버퍼가 채워진 비율을 나타냅니다. 재생이 시작되거나 재개되려면 버퍼가 100% 채워져야 하며, 이때 mediaStatus()는 BufferedMedia 또는 BufferingMedia 를 반환합니다. 값이 100 보다 낮을 경우, mediaStatus()는 StalledMedia 를 반환합니다.

액세스 함수:

알림 신호:

mediaStatus()도 참조하십시오 .

[read-only] duration : qint64

이 속성은 현재 미디어의 재생 시간을 나타냅니다.

이 값은 현재 미디어의 총 재생 시간을 밀리초 단위로 나타냅니다. 이 값은 ` QMediaPlayer ` 객체의 수명 주기 동안 변할 수 있으며, 초기 재생이 시작될 때는 사용할 수 없을 수도 있습니다. 상태 알림을 수신하려면 ` durationChanged()` 신호에 연결하십시오.

액세스 함수:

알림 신호:

[read-only] error : Error

이 속성은 마지막 오류 상황을 설명하는 문자열을 포함합니다.

액세스 함수:

알림 신호:

error()도 참조하십시오 .

[read-only] errorString : QString

이 속성은 현재 오류 상태를 보다 상세하게 설명하는 문자열을 포함합니다.

액세스 함수:

알림 신호:

[read-only] hasAudio : bool

이 속성은 미디어에 오디오가 포함되어 있는지 여부를 나타냅니다.

액세스 함수:

알림 신호:

[read-only] hasVideo : bool

이 속성은 미디어에 동영상이 포함되어 있는지 여부를 나타냅니다.

액세스 함수:

알림 신호:

loops : int

플레이어가 중지되기 전까지 미디어가 재생되는 횟수를 결정합니다. 현재 미디어 파일을 무한히 반복 재생하려면 이 속성을 ‘ QMediaPlayer::Infinite ’로 설정하십시오.

기본값은 ` 1`입니다. 이 속성을 ` 0 `로 설정해도 아무런 효과가 없습니다.

액세스 함수:

알림 신호:

[read-only] mediaStatus : MediaStatus

이 속성은 현재 미디어 스트림의 상태를 나타냅니다.

스트림 상태는 현재 스트림의 재생 진행 상황을 나타냅니다.

기본적으로 이 속성은 QMediaPlayer::NoMedia

액세스 함수:

알림 신호:

[read-only] metaData : QMediaMetaData

미디어 플레이어에서 현재 사용 중인 미디어에 대한 메타데이터를 반환합니다.

메타데이터에는 동영상 제목이나 제작 날짜와 같은 정보가 포함될 수 있습니다.

액세스 함수:

알림 신호:

[since 6.10] pitchCompensation : bool

이 속성은 미디어 플레이어의 피치 보정 상태를 나타냅니다.

피치 보정이 활성화되어 있는지 여부를 나타냅니다. 활성화된 경우, 재생 속도를 변경해도 오디오 신호의 피치에는 영향을 미치지 않습니다.

기본값은 피치 보정이 가능한 경우 true 이고, 그렇지 않은 경우 false 입니다.

이 열거형은 Qt 6.10에서 도입되었습니다.

액세스 함수:

알림 신호:

[read-only, since 6.10] pitchCompensationAvailability : const PitchCompensationAvailability

이 속성은 현재 QtMultimedia 백엔드에서 피치 보정 기능의 사용 가능 여부를 나타냅니다.

현재 백엔드에서 QMediaPlayer 의 피치 보정 기능 사용 가능 여부를 나타냅니다.

자세한 내용은 QMediaPlayer::PitchCompensationAvailability 을 참조하십시오.

이 열거형은 Qt 6.10에서 도입되었습니다.

액세스 함수:

[since 6.10] playbackOptions : QPlaybackOptions

미디어 재생 및 디코딩을 구성하는 데 사용되는 고급 재생 옵션입니다.

이 속성은 미디어 재생 옵션을 저수준에서 제어할 수 있게 해주는 QPlaybackOptions API를 제공합니다. QMediaPlayer 의 기본 설정을 사용하는 것을 강력히 권장하지만, 기본 옵션이 적합하지 않은 특정 사용 사례에서 미디어 재생을 최적화하기 위해 이 API를 사용할 수 있습니다.

재생 옵션은 다음에 QMediaPlayer::setSource()이 호출될 때 적용됩니다.

이 열거형은 Qt 6.10에서 도입되었습니다.

액세스 함수:

알림 신호:

playbackRate : qreal

이 속성은 현재 미디어의 재생 속도를 나타냅니다.

이 값은 미디어의 표준 재생 속도에 적용되는 배율입니다. 기본적으로 이 값은 1.0이며, 이는 미디어가 표준 속도로 재생되고 있음을 나타냅니다. 1.0보다 큰 값은 재생 속도를 높이고, 0.0과 1.0 사이의 값은 재생 속도를 늦춥니다. 음수의 재생 속도는 지원되지 않습니다.

모든 재생 서비스가 재생 속도 변경을 지원하는 것은 아닙니다. 빨리 감기 또는 되감기 시 오디오 및 비디오의 상태와 품질에 대한 처리는 프레임워크에 의해 정의됩니다.

액세스 함수:

알림 신호:

[read-only] playbackState : PlaybackState

PlaybackState 를 반환합니다.

액세스 함수:

알림 신호:

playing도 참조하십시오 .

[read-only, since 6.5] playing : bool

이 속성은 미디어가 재생 중인지 여부와 관계없이 유지됩니다.

이 열거형은 Qt 6.5에서 도입되었습니다.

액세스 함수:

알림 신호:

playbackState 및 PlayingState도 참조하십시오 .

position : qint64

이 속성은 현재 미디어의 재생 위치를 저장합니다.

값은 미디어 시작 시점부터의 밀리초 단위로 표시된 현재 재생 위치입니다. 위치가 주기적으로 변경될 경우, positionChanged() 신호를 통해 표시됩니다.

seekable 속성이 true인 경우, 이 속성은 밀리초 단위로 설정할 수 있습니다.

액세스 함수:

알림 신호:

[read-only] seekable : bool

이 속성은 현재 미디어의 탐색 가능 여부를 나타냅니다.

시퀀싱이 지원되는 경우 이 속성은 true를 반환하며, 그렇지 않은 경우 false를 반환합니다. 이 속성의 상태는 ` QMediaPlayer ` 객체의 수명 주기 동안 변경될 수 있으므로, 변경 사항을 모니터링하려면 ` seekableChanged ` 신호를 사용하십시오.

액세스 함수:

알림 신호:

source : QUrl

이 속성은 플레이어 객체가 현재 사용하고 있는 활성 미디어 소스를 저장합니다.

플레이어 객체는 재생할 콘텐츠를 선택하기 위해 ` QUrl `를 사용합니다.

기본적으로 이 속성의 미디어 소스( QUrl)는 null입니다.

이 속성을 null QUrl 로 설정하면 플레이어는 현재 미디어 소스와 관련된 모든 정보를 삭제하고 해당 미디어와 관련된 모든 I/O 작업을 중단합니다.

액세스 함수:

알림 신호:

QUrl도 참조하십시오 .

[read-only] subtitleTracks : QList<QMediaMetaData>

미디어 내에 포함된 사용 가능한 자막 트랙 목록을 반환합니다.

반환된 ` QMediaMetaData `는 개별 트랙의 속성을 설명합니다.

액세스 함수:

알림 신호:

videoOutput : QObject*

이 속성은 미디어 플레이어에서 사용할 비디오 출력을 지정합니다.

미디어 플레이어에는 하나의 비디오 출력만 연결할 수 있으므로, 이 속성을 설정하면 이전에 연결된 비디오 출력이 대체됩니다.

이 속성을 nullptr 로 설정하면 비디오 출력이 비활성화됩니다.

액세스 함수:

알림 신호:

[read-only] videoTracks : QList<QMediaMetaData>

미디어 내에 포함된 사용 가능한 비디오 트랙 집합을 나열합니다.

반환된 ` QMediaMetaData ` 객체는 개별 트랙의 속성을 설명합니다.

액세스 함수:

알림 신호: