Back to Qt.io
Contact Us Blog Download Qt

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
    }
}

Camera 、AudioInput 、VideoOutputも参照してください 。

プロパティ ドキュメント

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]

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


本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。