QAmbientSound Class

ステレオ・オーバーレイ・サウンド。詳細...

Header: #include <QAmbientSound>
CMake: find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)
qmake: QT += spatialaudio
Inherits: QObject

パブリックタイプ

enum Loops { Infinite, Once }

プロパティ

パブリック関数

QAmbientSound(QAudioEngine *engine)
bool autoPlay() const
QAudioEngine *engine() const
int loops() const
void setAutoPlay(bool autoPlay)
void setLoops(int loops)
void setSource(const QUrl &url)
void setVolume(float volume)
QUrl source() const
float volume() const

パブリックスロット

void pause()
void play()
void stop()

シグナル

詳細説明

QAmbientSoundは、位置や向きに依存しないサウンドを表します。リスナーの位置や向きに依存しない背景音(音楽など)によく使われます。

メンバー型解説

enum QAmbientSound::Loops

以下の値を使用して再生ループを制御できます:

定数説明
QAmbientSound::Infinite-1無限ループ
QAmbientSound::Once1一度実行したら再生を停止する

プロパティ ドキュメント

autoPlay : bool

ソースが指定されたときに、サウンドが自動的に再生を開始するかどうかを決定します。

デフォルト値はtrue

アクセス関数

bool autoPlay() const
void setAutoPlay(bool autoPlay)

Notifierシグナル

void autoPlayChanged()

loops : int

Notifier signal: プレーヤーが停止するまでに何回サウンドを再生するかを決める。QAmbientSound::Infinite に設定すると、現在のサウンドを永遠にループ再生する。

デフォルト値は1

アクセス関数

int loops() const
void setLoops(int loops)

Notifierシグナル:

void loopsChanged()

source : QUrl

再生するサウンドのソースファイル。

アクセス関数

QUrl source() const
void setSource(const QUrl &url)

Notifier signal:再生するサウンドのソースファイル:

void sourceChanged()

volume : float

サウンドの音量を設定します。

0から1の間の値は音を減衰させ、1以上の値はさらにゲインを上げます。

アクセス機能

float volume() const
void setVolume(float volume)

ノティファイアシグナル:

void volumeChanged()

メンバ関数ドキュメント

[explicit] QAmbientSound::QAmbientSound(QAudioEngine *engine)

engine 用のステレオ音源を作成します。

QAudioEngine *QAmbientSound::engine() const

このサウンドに関連付けられたエンジンを返す。

[slot] void QAmbientSound::pause()

サウンド再生を一時停止する。play() を呼び出すと再生を継続します。

[slot] void QAmbientSound::play()

サウンドの再生を開始します。サウンドがすでに再生されている場合は何もしません。

[slot] void QAmbientSound::stop()

サウンドの再生を停止し、現在の位置と現在のループカウントを0にリセットします。play ()を呼び出すと、サウンドファイルの先頭から再生を開始します。

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