이 페이지에서

MediaDevices QML Type

MediaDevices는 사용 가능한 멀티미디어 입력 및 출력 장치에 대한 정보를 제공합니다. 더 보기...

Import Statement: import QtMultimedia
In C++: QMediaDevices

속성

상세 설명

MediaDevices 유형은 사용 가능한 멀티미디어 장치 및 시스템 기본값에 대한 정보를 제공합니다. 이 유형은 다음 세 가지 그룹을 모니터링합니다:

  • 오디오 입력 장치(마이크)
  • 오디오 출력 장치(스피커, 헤드셋)
  • 비디오 입력 장치(카메라)

MediaDevices는 각 장치 그룹별로 별도의 목록을 제공합니다. 시스템에 새로운 장치가 연결되었거나 연결된 장치가 시스템에서 분리된 것을 감지하면, 해당 장치 목록을 업데이트하고 변경 사항을 알리는 신호를 발신합니다.

MediaDevices는 각 장치 그룹에 대한 시스템 기본값을 모니터링합니다. 시스템 설정을 통해 이루어진 모든 변경 사항을 알립니다. 예를 들어, 사용자가 시스템 설정에서 새로운 기본 오디오 출력을 선택하면, MediaDevices는 이에 따라 기본 오디오 출력을 업데이트하고 신호를 전송합니다. 시스템이 카메라나 오디오 입력에 대한 기본값을 제공하지 않는 경우, MediaDevices는 목록의 첫 번째 장치를 기본 장치로 선택합니다.

멀티미디어를 재생하거나 녹화할 때는 기본 입력 및 출력 장치를 사용하는 것으로 충분하지만, 사용될 장치를 명시적으로 선택해야 할 필요가 종종 있습니다.

예를 들어, 아래 코드 조각은 미디어 플레이어가 재생 시 항상 시스템의 기본 오디오 출력 장치를 사용하도록 보장합니다:

MediaDevices {
    id: devices
}
MediaPlayer {
    ...
    audioOutput: AudioOutput {
        device: devices.defaultAudioOutput
    }
}

Camera, AudioInput, VideoOutput도 참조하십시오 .

속성 설명서

audioInputs : list<audioDevice> [read-only]

시스템에서 사용할 수 있는 오디오 입력 장치 목록이 포함되어 있습니다.

이러한 장치들은 대개 마이크입니다. 장치는 내장형이거나, 예를 들어 USB나 블루투스를 통해 연결된 형태일 수 있습니다.

audioOutputs : list<audioDevice> [read-only]

시스템에서 사용 가능한 오디오 출력 장치 목록이 포함되어 있습니다.

이러한 장치로는 일반적으로 스피커나 헤드셋이 있습니다. 장치는 내장형이거나, 예를 들어 USB나 블루투스를 통해 연결된 형태일 수 있습니다.

defaultAudioInput : audioDevice [read-only]

기본 오디오 입력 장치를 반환합니다.

애플리케이션 실행 중에 기본 장치가 변경될 수 있습니다. 이 속성의 값은 이러한 변경 사항에 따라 자동으로 조정됩니다.

defaultAudioOutput : audioDevice [read-only]

기본 오디오 출력 장치를 반환합니다.

애플리케이션 실행 중에 기본 장치가 변경될 수 있습니다. 이 속성의 값은 이러한 변경 사항에 따라 자동으로 조정됩니다.

defaultVideoInput : cameraDevice [read-only]

시스템의 기본 카메라를 반환합니다.

참고: 사용 가능한 카메라가 없는 경우를 대비하여, 반환된객체를 사용하기 전에 isNull()을 사용하여 확인해야 합니다.

애플리케이션 실행 중에 기본 장치가 변경될 수 있습니다. 이 속성의 값은 이러한 변경 사항에 따라 자동으로 조정됩니다.

videoInputs : list<cameraDevice> [read-only]

시스템에 연결된 카메라 목록을 포함합니다.

© 2026 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.