MediaDevices QML Type

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

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• audioInputs : list<audioDevice>
• audioOutputs : list<audioDevice>
• defaultAudioInput : audioDevice
• defaultAudioOutput : audioDevice
• defaultVideoInput : cameraDevice
• videoInputs : list<cameraDevice>

詳細説明

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]

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

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

videoInputs : list<cameraDevice> [read-only]

システム上のカメラの一覧が含まれています。