QMediaDevices Class

詳細な説明

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

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

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 の静的メソッドはスレッドセーフであり、基盤となるシングルトンオブジェクトを参照します。