語言

AudioTrack.SetVolume(Single) 方法

定義

設定該軌道所有通道的指定輸出增益值。

[Android.Runtime.Register("setVolume", "(F)I", "GetSetVolume_FHandler")]
public virtual Android.Media.TrackStatus SetVolume(float gain);
[<Android.Runtime.Register("setVolume", "(F)I", "GetSetVolume_FHandler")>]
abstract member SetVolume : single -> Android.Media.TrackStatus
override this.SetVolume : single -> Android.Media.TrackStatus

參數

gain
Single

所有聲道的輸出增益。

傳回

錯誤代碼或成功,參見 #SUCCESS, #ERROR_INVALID_OPERATION

屬性

備註

設定該軌道所有通道的指定輸出增益值。

增益值被限制在閉合區間 [0.0, max],其中 max 為 的 #getMaxVolume值。 值為 0.0 則為 0 增益(靜音),1.0 表示 1 增益(訊號不變)。 預設值是 1.0,代表團結度提升。

此 API 比 更受青 #setStereoVolume睞,因為它更能優雅地縮減至單聲道,並支援立體聲以外的多聲道內容。

API 名稱中的「volume」一詞具有歷史意義;這其實是線性增益。

Java 文件 android.media.AudioTrack.setVolume(float)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於