MediaPlayer QML Type

이 속성은 현재 활성화된 오디오 트랙의 트랙 번호를 보유합니다. 오디오 트랙을 비활성화하려면 -1 로 설정합니다.

기본 속성 값은 0: 첫 번째 오디오 트랙입니다.

이 속성에는 현재 활성화된 자막 트랙의 트랙 번호가 저장됩니다. 자막 트랙을 비활성화하려면 -1 로 설정합니다.

기본 속성 값은 -1: 활성화된 자막 없음입니다.

이 속성에는 현재 활성화된 비디오 오디오 트랙의 트랙 번호가 저장됩니다. 비디오 트랙을 비활성화하려면 -1 로 설정합니다.

기본 속성 값은 0: 첫 번째 비디오 트랙입니다.

이 프로퍼티는 대상 오디오 버퍼 출력을 보유합니다.

QML에서 MediaPlayer 을 정상적으로 사용하는 경우 이 프로퍼티를 사용할 필요가 없습니다.

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

QMediaPlayer::audioBufferOutput()도 참조하십시오 .

이 프로퍼티는 대상 오디오 출력을 보유합니다. AudioOutput 엘리먼트 하나를 받아들입니다.

QMediaPlayer::setAudioOutput()도 참조하십시오 .

이 프로퍼티는 메타데이터 목록을 보유합니다. 각 인덱스는 오디오 트랙을 나타냅니다.

메타데이터에는 개별 트랙을 설명하는 속성이 있습니다. 오디오 트랙의 경우 일반적으로 Language 속성이 가장 중요한 속성입니다.

mediaMetaData도 참조하세요 .

이 속성은 미디어가 로드된 후 자동으로 재생을 시작할지 여부를 제어합니다. 기본값은 false 입니다.

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

이 속성은 0.0 (비어 있음)에서 1.0 (가득 찼음)까지 현재 데이터 버퍼가 얼마나 채워져 있는지를 저장합니다.

버퍼가 완전히 채워진 경우에만 재생을 시작하거나 재개할 수 있습니다. 버퍼가 가득 차면 MediaPlayer.Buffered 이 참입니다. 버퍼 진행률이 0.0 와 1.0 사이이면 MediaPlayer.Buffering 는 true 로 설정됩니다.

1.0 보다 낮은 값은 MediaPlayer.StalledMedia 속성이 true 임을 의미합니다.

mediaStatus도 참조하세요 .

이 속성은 미디어의 지속 시간을 밀리초 단위로 보유합니다.

미디어에 고정된 지속 시간이 없는 경우(예: 라이브 스트림) 0 로 설정됩니다.

이 속성은 오디오의 오류 상태를 보유합니다. 다음 중 하나가 될 수 있습니다.

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

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

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

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

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

이 속성은 미디어 로딩 상태를 유지합니다. 다음 중 하나가 될 수 있습니다:

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

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

이 속성은 피치 보정 활성화 여부를 보유합니다.

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

현재 백엔드에서 MediaPlayer 의 피치 보정 사용 가능 여부를 나타냅니다. PitchCompensationAvailability 열거형은 범위가 지정됩니다.

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

이 프로퍼티는 미디어 재생 옵션의 로우 레벨 제어를 제공하는 playbackOptions API를 노출합니다. MediaPlayer 의 기본 설정을 사용하는 것이 좋지만, 기본 옵션이 적합하지 않은 특정 사용 사례에 대해 미디어 재생을 최적화하는 데 이 API를 사용할 수 있습니다.

재생 옵션은 다음 번에 MediaPlayer::source 을 변경할 때 적용됩니다.

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

이 속성은 미디어가 재생되는 속도를 일반 속도의 배수로 유지합니다.

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

기본값은 1.0 입니다.

이 프로퍼티는 미디어 재생 상태를 저장합니다. 다음 중 하나가 될 수 있습니다:

미디어가 현재 재생 중인지 여부를 나타냅니다.

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

playbackState 를참조하세요 .

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

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

이 속성은 미디어의 position 변경 가능 여부를 보유합니다.

이 속성은 미디어의 소스 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()도 참조하세요 .

이 속성은 메타데이터 목록을 보유합니다. 각 인덱스는 자막 트랙을 참조합니다.

메타데이터에는 개별 트랙을 설명하는 속성이 있습니다. 자막 트랙의 경우 일반적으로 Language 가 가장 중요한 속성입니다.

mediaMetaData도 참조하세요 .

이 속성은 대상 비디오 출력을 보유합니다. VideoOutput 요소 하나를 허용합니다.

QMediaPlayer::setVideoOutput()도 참조하세요 .

이 속성은 메타데이터 목록을 보유합니다. 각 인덱스는 비디오 트랙을 나타냅니다.

메타데이터에는 개별 트랙을 설명하는 속성이 있습니다.

mediaMetaData도 참조하세요 .

이 신호는 error 가 발생했을 때 전송됩니다. errorString 매개변수에는 오류에 대한 자세한 정보가 포함될 수 있습니다.

QMediaPlayer::Error도 참조하세요 .

playbackState 속성이 변경되면 이 신호가 전송됩니다.

이 신호는 playing 속성이 변경될 때 발생합니다.

미디어 재생을 일시 중지합니다.

playbackState 속성을 PausedState로 설정하고 playing 을 false 로 변경합니다.

미디어 재생을 시작하거나 다시 시작합니다.

playbackState 속성을 재생 중 상태로 설정하고 playing 을 true 으로 변경합니다.

미디어 재생을 중지합니다.

playbackState 속성을 StoppedState로 설정하고 playing 을 false 로 변경합니다.