MediaDevices QML Type

MediaDevicesは、利用可能なマルチメディア入出力デバイスに関する情報を提供する。詳細...

Import Statement: import QtMultimedia
In C++: QMediaDevices

プロパティ

詳細説明

MediaDevices型は、利用可能なマルチメディア・デバイスとシステムのデフォルトに関する情報を提供する。以下の3つのグループを監視する:

  • 音声入力デバイス(マイク)
  • 音声出力デバイス(スピーカー、ヘッドセット)
  • ビデオ入力デバイス(カメラ)

MediaDevicesは各デバイスグループごとに個別のリストを提供します。新しいデバイスがシステムに接続されたこと、または接続されていたデバイスがシステムから切断されたことを検出すると、対応するデバイス・リストを更新し、変更を通知する信号を発信します。

MediaDevicesは、各デバイス・グループのシステム・デフォルトを監視します。システム設定によって行われた変更について通知します。例えば、ユーザーがシステム設定で新しいデフォルト・オーディオ出力を選択した場合、MediaDevicesはそれに応じてデフォルト・オーディオ出力を更新し、シグナルを発信します。システムがカメラまたは音声入力のデフォルトを提供していない場合、MediaDevicesはリストから最初のデバイスをデフォルトデバイスとして選択します。

マルチメディアの再生や記録にはデフォルトの入出力デバイスを使用すれば十分な場合が多いですが、使用するデバイスを明示的に選択する必要がある場合もよくあります。

例えば、以下のスニペットは、メディアプレーヤーが常にシステムのデフォルトのオーディオ出力デバイスを使用して再生するようにします:

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

CameraAudioInputVideoOutputも参照してください

プロパティ ドキュメント

audioInputs : list<audioDevice> [read-only]

システムで利用可能なオーディオ入力デバイスのリストを含みます。

これらのデバイスは通常マイクです。デバイスは内蔵、またはUSBやBluetoothなどで接続されます。


audioOutputs : list<audioDevice> [read-only]

システムで利用可能なオーディオ出力デバイスのリストが含まれています。

これらのデバイスは通常、ラウドスピーカーやヘッドセットです。デバイスは内蔵、またはUSBやBluetoothなどで接続できます。


defaultAudioInput : audioDevice [read-only]

デフォルトのオーディオ入力デバイスを返します。

デフォルトのデバイスは、アプリケーションの実行中に変更される可能性があります。このプロパティの値は、そのような変更に合わせて自動的に調整されます。


defaultAudioOutput : audioDevice [read-only]

デフォルトのオーディオ出力デバイスを返します。

デフォルトのデバイスは、アプリケーションの実行中に変更される可能性があります。このプロパティの値は、そのような変更に合わせて自動的に調整されます。


defaultVideoInput : cameraDevice [read-only]

システム上のデフォルト・カメラを返します。

注意: 使用可能なカメラがない場合に備えて、使用する前に isNull() を使用して返されるオブジェクトをチェックする必要があります。

デフォルト・デバイスは、アプリケーションの実行中に変更される可能性があります。このプロパティの値は、そのような変更に合わせて自動的に調整されます。


videoInputs : list<cameraDevice> [read-only]

システム上のカメラのリストを含みます。


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