QMediaDevices Class

詳細説明

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

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

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はリストから最初のデバイスをデフォルトデバイスとして選択します。

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

QMediaDevicesはシングルトンオブジェクトで、すべてのゲッターはスレッドセーフです。