Video QML Type

지정된 동영상을 표시하기 위한 편의 타입입니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• autoPlay : bool (since 6.7)
• bufferProgress : real
• duration : int
• endOfStreamPolicy : enumeration (since 6.9)
• error : enumeration
• errorString : string
• fillMode : enumeration
• hasAudio : bool
• hasVideo : bool
• loops : int
• metaData : mediaMetaData
• mirrored : int
• muted : bool
• orientation : int (since 6.9)
• playbackRate : real
• playbackState : enumeration
• position : int
• seekable : bool
• source : url
• volume : real

신호

• errorOccurred(error, errorString)
• paused()
• playing()
• stopped()

방법

• clearOutput() (since 6.9)
• pause()
• play()
• seek(offset)
• stop()

상세 설명

Video MediaPlayer 와 의 기능을 하나로 통합한 편의 타입입니다. 여러 타입을 별도로 선언할 필요 없이 간단한 동영상 재생 기능을 제공합니다. VideoOutput

다음은 씬에서 동영상 재생을 구현하는 예제 코드입니다.

Video {
    id: video
    width : 800
    height : 600
    source: "video.avi"

    MouseArea {
        anchors.fill: parent
        onClicked: {
            video.play()
        }
    }

    focus: true
    Keys.onSpacePressed: video.playbackState == MediaPlayer.PlayingState ? video.pause() : video.play()
    Keys.onLeftPressed: video.position = video.position - 5000
    Keys.onRightPressed: video.position = video.position + 5000
}

소스 파일인 ` video.avi`은 ` MouseArea`의 부모 요소를 클릭하면 재생됩니다. 동영상은 800×600 픽셀 영역에서 재생되며, ` id ` 속성의 값은 ` video`입니다.

Keys 에 대한 신호가 정의되어 있으므로, 다음 버튼을 누르면:

• Spacebar 는 일시 정지 버튼을 전환합니다.
• Left Arrow 동영상의 현재 위치를 5초 전으로 되돌립니다.
• Right Arrow 는 동영상 현재 위치를 5초 앞으로 이동시킵니다.

비디오는 변환되지 않은 상태, 늘어난 상태 및 균일하게 확대/축소된 상태의 비디오 표시를 지원합니다. 균일하게 확대/축소된 표시 방식에 대한 설명은 fillMode 속성 설명을 참조하십시오.

MediaPlayer 및 VideoOutput도 참조하십시오 .

속성 설명서

autoPlay : bool [since 6.7]

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

이 속성은 Qt 6.7에서 도입되었습니다.

bufferProgress : real

이 속성은 데이터 버퍼가 현재 얼마나 채워져 있는지를 나타내며, 0.0(비어 있음)부터 1.0(가득 차 있음)까지의 값을 가집니다.

duration : int

이 속성은 미디어의 재생 시간을 밀리초 단위로 저장합니다.

미디어의 재생 시간이 고정되어 있지 않은 경우(예: 라이브 스트림) 이 값은 0이 됩니다.

endOfStreamPolicy : enumeration [since 6.9]

이 속성은 비디오 스트림이 종료될 때 적용할 정책을 지정합니다.

endOfStreamPolicy 의 값은 다음 중 하나일 수 있습니다:

기본값은 ` VideoOutput.ClearOutput`입니다.

이 속성은 Qt 6.9에서 도입되었습니다.

error : enumeration

이 속성은 동영상의 오류 상태를 나타냅니다. 다음 중 하나일 수 있습니다:

• MediaPlayer.NoError - 현재 오류가 없습니다.
• MediaPlayer.ResourceError - 리소스 할당 문제로 인해 동영상을 재생할 수 없습니다.
• MediaPlayer.FormatError - 동영상 형식이 지원되지 않습니다.
• MediaPlayer.NetworkError - 네트워크 문제로 인해 동영상을 재생할 수 없습니다.
• MediaPlayer.AccessDenied - 권한이 부족하여 동영상을 재생할 수 없습니다.
• MediaPlayer.ServiceMissing - 미디어 서비스를 인스턴스화할 수 없어 동영상을 재생할 수 없습니다.

errorString : string

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

fillMode : enumeration

이 속성을 설정하여 동영상이 대상 영역에 맞게 어떻게 크기가 조정될지 지정합니다.

• VideoOutput.Stretch - 동영상이 대상 영역에 맞게 크기가 조정됩니다
• VideoOutput.PreserveAspectFit - 동영상이 잘림 없이 균일하게 확대/축소되어 영역에 맞춰집니다
• VideoOutput.PreserveAspectCrop - 동영상이 영역을 채우도록 균일하게 확대/축소되며, 필요한 경우 잘립니다

이 유형은 QML에서 편의성을 위해 제공되므로 열거형을 직접 지원하지 않으므로, VideoOutput 의 열거형을 사용하여 사용 가능한 채우기 모드에 접근합니다.

기본 채우기 모드는 preserveAspectFit입니다.

hasAudio : bool

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

hasVideo : bool

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

loops : int

미디어가 재생된 후 중지되기까지의 횟수를 결정합니다. MediaPlayer 로 설정하십시오. 현재 미디어 파일을 무한히 반복 재생하려면 'Infinite'로 설정하십시오.

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

metaData : mediaMetaData

이 속성은 현재 미디어에 대한 메타데이터를 포함합니다.

각 메타데이터 키에 대한 자세한 내용은 MediaPlayer.metaData 를 참조하십시오.

mediaMetaData도 참조하십시오 .

mirrored : int

표시되는 비디오가 수직축을 기준으로 대칭 반전되는지 여부를 결정합니다. 대칭 반전은 ` orientation` 이후 적용됩니다. 기본값은 ` false`입니다.

muted : bool

이 속성은 오디오 출력이 음소거되어 있는지 여부와 관계없이 적용됩니다.

orientation : int [since 6.9]

이 속성은 디스플레이에서 Y축이 아래쪽을 향하는 것을 기준으로, 표시되는 비디오가 비디오 좌표계에서 시계 방향으로 회전하는 각도(도 단위)를 결정합니다. 방향 변환은 ` mirrored` 전에 적용됩니다.

90 의 배수인 각도(즉, 0, 90, -90, 180, 270 등)만 지원되며, 그 외의 값은 무시됩니다.

기본값은 0 입니다.

이 속성은 Qt 6.9에서 도입되었습니다.

playbackRate : real

이 속성은 동영상 재생 속도를 표준 속도의 몇 배인지로 지정합니다.

playbackState : enumeration

이 읽기 전용 속성은 미디어의 재생 상태를 나타냅니다.

• MediaPlayer.PlayingState - 미디어가 재생 중입니다
• MediaPlayer.PausedState - 미디어가 일시 정지된 상태
• MediaPlayer.StoppedState - 미디어가 중지됨

기본 상태는 MediaPlayer.StoppedState입니다.

position : int

이 속성은 현재 재생 위치를 밀리초 단위로 저장합니다.

seekable : bool

이 속성은 동영상의 재생 위치를 변경할 수 있는지 여부를 나타냅니다.

true인 경우, ` seek()` 메서드를 호출하거나 ` position ` 속성을 변경하면 재생이 새로운 위치로 이동합니다.

source : url

이 속성은 미디어의 소스 URL을 포함합니다.

volume : real

이 속성은 오디오 볼륨을 나타냅니다.

볼륨은 0.0 (무음)에서 1.0 (최대 볼륨)까지 선형으로 조정됩니다. 이 범위 밖의 값은 제한됩니다.

기본 볼륨은 1.0 입니다.

UI 볼륨 컨트롤은 일반적으로 비선형적으로 스케일링되어야 합니다. 예를 들어, 로그 스케일을 사용하면 사용자가 볼륨 컨트롤에서 일반적으로 기대하는 대로 지각되는 음량의 선형적인 변화가 발생합니다. 자세한 내용은 QtAudio::convertVolume()을 참조하십시오.

신호 문서

errorOccurred(error, errorString)

이 신호는 ‘ error ’ 오류가 발생했을 때 발생합니다. ‘ errorString ’ 매개변수에는 오류에 대한 더 자세한 정보가 포함되어 있을 수 있습니다.

paused()

이 신호는 재생이 일시 정지되었을 때 발생합니다.

playing()

이 신호는 재생이 시작되거나 재개될 때 발생합니다.

stopped()

이 신호는 재생이 중지될 때 발생합니다.

메서드 설명서

[since 6.9] clearOutput()

현재 비디오 프레임을 제거하여 비디오 출력을 지웁니다. 이 메서드는 ‘ endOfStreamPolicy ’ 비디오 속성이 ‘ KeepLastFrame ’로 설정된 상태에서 비디오 스트림이 종료된 후 마지막 비디오 프레임을 제거해야 할 때 사용하는 것이 좋습니다.

이 메서드는 Qt 6.9에서 도입되었습니다.

pause()

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

play()

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

seek(offset)

seekable 속성이 true인 경우, 현재 재생 위치를 offset 로 이동합니다.

seekable 및 position항목도 참조하십시오 .

stop()

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