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(50);
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에 도입되었습니다.

액세스 기능:

알림 신호:

audioOutput : QAudioOutput*

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

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

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

기능 액세스:

알림 신호:

[read-only] audioTracks : const QList<QMediaMetaData>

미디어 내에서 사용 가능한 오디오 트랙 세트를 나열합니다.

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

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

기능에 액세스합니다:

알림 신호:

[read-only] bufferProgress : const float

이 속성은 재생이 시작되거나 재개되기 전에 채워진 임시 버퍼의 백분율을 0. (비어 있음)에서 1. (가득 찼음)까지 저장합니다.

플레이어 객체가 버퍼링 중인 경우 이 프로퍼티는 채워진 임시 버퍼의 백분율을 보유합니다. 재생이 시작되거나 재개되기 전에 버퍼가 100% 채워져야 하며, 이때 mediaStatus()는 BufferedMedia 또는 BufferingMedia 를 반환합니다. 값이 100 보다 낮으면 mediaStatus()는 StalledMedia 를 반환합니다.

함수 액세스

알림 신호:

mediaStatus()도 참조하세요 .

[read-only] duration : const qint64

이 속성은 현재 미디어의 지속 시간을 저장합니다.

이 값은 현재 미디어의 총 재생 시간(밀리초)입니다. 이 값은 QMediaPlayer 개체의 수명에 따라 변경될 수 있으며 초기 재생이 시작되면 durationChanged() 신호에 연결하여 상태 알림을 받지 못할 수 있습니다.

기능에 액세스합니다:

알림 신호:

[read-only] error : const Error

이 속성에는 마지막 오류 조건을 설명하는 문자열이 저장됩니다.

함수에 액세스합니다:

알림 신호:

error()도 참조하세요 .

[read-only] errorString : const QString

이 속성에는 현재 오류 상태를 자세히 설명하는 문자열이 저장됩니다.

함수에 액세스합니다:

알림 신호:

[read-only] hasAudio : const bool

이 속성은 미디어에 오디오가 포함되어 있는지 여부를 저장합니다.

액세스 기능:

알림 신호:

[read-only] hasVideo : const bool

이 속성은 미디어에 동영상이 포함되어 있는지 여부를 저장합니다.

액세스 기능:

알림 신호:

loops : int

플레이어가 중지되기 전에 미디어를 재생하는 빈도를 결정합니다. 현재 미디어 파일을 영원히 반복하려면 QMediaPlayer::Infinite 로 설정합니다.

기본값은 1 입니다. 이 속성을 0 으로 설정하면 효과가 없습니다.

기능 액세스:

알림 신호:

[read-only] mediaStatus : const MediaStatus

이 속성에는 현재 미디어 스트림의 상태가 저장됩니다.

스트림 상태는 현재 스트림의 재생이 어떻게 진행되고 있는지 설명합니다.

기본적으로 이 속성은 다음과 같습니다. QMediaPlayer::NoMedia

액세스 기능:

알림 신호입니다:

[read-only] metaData : const QMediaMetaData

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

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

액세스 기능:

알림 신호:

playbackRate : qreal

이 속성은 현재 미디어의 재생 속도를 보유합니다.

이 값은 미디어의 표준 재생 속도에 적용되는 배수입니다. 기본적으로 이 값은 1.0으로 미디어가 표준 속도로 재생되고 있음을 나타냅니다. 값이 1.0보다 크면 재생 속도가 빨라지고 0.0에서 1.0 사이의 값은 재생 속도가 느려집니다. 음수 재생 속도는 지원되지 않습니다.

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

액세스 기능:

알림 신호:

[read-only] playbackState : const PlaybackState

PlaybackState 을 반환합니다.

액세스 함수를 반환합니다:

알림 신호:

playing 를참조하세요 .

[read-only, since 6.5] playing : const bool

이 프로퍼티는 미디어 재생 여부를 저장합니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.

액세스 함수:

알림 신호:

playbackState 및 PlayingState 을참조하십시오 .

position : qint64

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

값은 미디어 시작 이후 밀리초 단위로 표시되는 현재 재생 위치입니다. 주기적으로 위치가 변경되면 positionChanged() 신호로 표시됩니다.

seekable 속성이 참이면 이 속성을 밀리초로 설정할 수 있습니다.

기능에 액세스합니다:

알림 신호:

[read-only] seekable : const bool

이 속성은 현재 미디어의 검색 가능 상태를 보유합니다.

검색이 지원되면 이 속성은 참이고, 그렇지 않으면 거짓입니다. 이 프로퍼티의 상태는 QMediaPlayer 객체의 수명 기간 동안 변경될 수 있으며, seekableChanged 신호를 사용하여 변경 사항을 모니터링합니다.

액세스 기능:

알림 신호:

source : QUrl

이 속성은 플레이어 객체에서 사용 중인 활성 미디어 소스를 보유합니다.

플레이어 객체는 재생할 콘텐츠를 선택할 때 QUrl 을 사용합니다.

기본적으로 이 프로퍼티는 null QUrl 입니다.

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

액세스 기능

알림 신호:

QUrl 를참조하십시오 .

[read-only] subtitleTracks : const QList<QMediaMetaData>

미디어 내에서 사용 가능한 자막 트랙 세트를 나열합니다.

반환된 QMediaMetaData 에는 개별 트랙의 속성이 설명되어 있습니다.

기능에 액세스합니다:

알림 신호:

videoOutput : QObject*

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

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

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

기능 액세스

알림 신호:

[read-only] videoTracks : const QList<QMediaMetaData>

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

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

기능에 액세스합니다:

알림 신호: