QMediaDevices Class

상세 설명

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

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

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

QMediaDevices::audioInputs 및 QMediaDevices::audioOutputs 함수는 시스템의 모든 마이크와 스피커/헤드셋을 열거하는 데 사용할 수 있습니다. 이 예에서는 먼저 연결된 모든 마이크의 목록을 가져온 다음 식별자, 설명 및 기본 장치인지 여부를 인쇄합니다.

const QList<QAudioDevice> audioDevices = QMediaDevices::audioInputs();
for (const QAudioDevice &device : audioDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

마찬가지로 QMediaDevices::videoInputs 은 연결된 모든 카메라의 목록을 반환합니다. 이 예에서는 연결된 모든 카메라와 해당 카메라의 식별자, 설명, 기본 카메라 여부가 나열됩니다.

const QList<QCameraDevice> videoDevices = QMediaDevices::videoInputs();
for (const QCameraDevice &device : videoDevices)
{
    out << "ID: " << device.id() << Qt::endl;
    out << "Description: " << device.description() << Qt::endl;
    out << "Is default: " << (device.isDefault() ? "Yes" : "No") << Qt::endl;
}

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

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

QMediaDevices는 싱글톤 객체이며 모든 게터는 스레드 안전합니다.