語言

DynamicsProcessing 類別

定義

動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。

[Android.Runtime.Register("android/media/audiofx/DynamicsProcessing", ApiSince=28, DoNotGenerateAcw=true)]
public sealed class DynamicsProcessing : Android.Media.Audiofx.AudioEffect
[<Android.Runtime.Register("android/media/audiofx/DynamicsProcessing", ApiSince=28, DoNotGenerateAcw=true)>]
type DynamicsProcessing = class
    inherit AudioEffect
繼承
DynamicsProcessing
屬性

備註

動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 它由多個階段組成,包括均衡、多頻段壓縮與限制器。

頻段數與主動級數可自訂,且大多數參數可即時控制,如增益、起放時間、閾值等。

這個效果是由通道實例化並控制的。 每個通道的基本架構相同,但其所有參數都獨立於其他通道。

基本通道配置如下:

Channel 0          Channel 1       ....       Channel N-1
                 Input              Input                       Input
                   |                  |                           |
              +----v----+        +----v----+                 +----v----+
              |inputGain|        |inputGain|                 |inputGain|
              +---------+        +---------+                 +---------+
                   |                  |                           |
             +-----v-----+      +-----v-----+               +-----v-----+
             |   PreEQ   |      |   PreEQ   |               |   PreEQ   |
             +-----------+      +-----------+               +-----------+
                   |                  |                           |
             +-----v-----+      +-----v-----+               +-----v-----+
             |    MBC    |      |    MBC    |               |    MBC    |
             +-----------+      +-----------+               +-----------+
                   |                  |                           |
             +-----v-----+      +-----v-----+               +-----v-----+
             |  PostEQ   |      |  PostEQ   |               |  PostEQ   |
             +-----------+      +-----------+               +-----------+
                   |                  |                           |
             +-----v-----+      +-----v-----+               +-----v-----+
             |  Limiter  |      |  Limiter  |               |  Limiter  |
             +-----------+      +-----------+               +-----------+
                   |                  |                           |
                Output             Output                      Output

其中階段為:輸入增益:輸入增益因子(分貝)單位。 0 dB 表示電平沒有變化。 前置EQ:多頻段均衡器。 MBC:多頻段壓縮器 後期均衡器:多頻段均衡器限制器:單頻段壓縮器/限制器。

應用程式會建立一個 DynamicsProcessing 物件,在音訊框架中實例化並控制此音訊效果。 DynamicsProcessor.Config 與 DynamicsProcessor.Config.Builder 可用來協助配置多階段及各頻段參數(如有需要)。

詳情請參閱各階段文件。

若建立時未指定設定,則會選擇預設設定。

若要將動態處理附加到特定的 AudioTrack 或 MediaPlayer,建構效果時請指定該 AudioTrack 或 MediaPlayer 的音訊會話 ID(參見 AudioTrack#getAudioSessionId() 及 MediaPlayer#getAudioSessionId())。

若要將 DynamicsProcessing 附加到特定的 AudioTrack 或 MediaPlayer,建構 DynamicsProcessing 時,請指定該 AudioTrack 或 MediaPlayer 的音訊會話 ID。

有關音頻課程的詳細資訊請參見 android.media.MediaPlayer#getAudioSessionId() 。

關於控制音效的更多細節,請參見 android.media.audiofx.AudioEffect 職業。

Java 文件 android.media.audiofx.DynamicsProcessing。

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

建構函式

名稱 Description
DynamicsProcessing(Int32, Int32, DynamicsProcessing+Config)

職業建造者。

DynamicsProcessing(Int32)

職業建造者。

欄位

名稱 Description
ActionCloseAudioEffectControlSession

意圖向效果控制應用或服務發出音訊會話已關閉,且不應再套用效果的訊號。

(繼承來源 AudioEffect)
ActionDisplayAudioEffectControlPanel

打算啟動一個音效控制面板的介面。

(繼承來源 AudioEffect)
ActionOpenAudioEffectControlSession

意圖向效果控制應用程式或服務發出訊號,表示已開啟新的音訊工作階段,並需要套用音訊效果。

(繼承來源 AudioEffect)
AlreadyExists
已淘汰.

內部運作狀態。

(繼承來源 AudioEffect)
ContentTypeGame
已淘汰.

當播放內容類型為遊戲音效時的價值#EXTRA_CONTENT_TYPE

(繼承來源 AudioEffect)
ContentTypeMovie
已淘汰.

當播放內容類型為影片或電影時的價值#EXTRA_CONTENT_TYPE

(繼承來源 AudioEffect)
ContentTypeMusic
已淘汰.

當播放內容類型是音樂時的價值#EXTRA_CONTENT_TYPE

(繼承來源 AudioEffect)
ContentTypeVoice
已淘汰.

當播放內容類型為語音音訊時的價值#EXTRA_CONTENT_TYPE

(繼承來源 AudioEffect)
EffectAuxiliary

效果連接模式為輔助。

(繼承來源 AudioEffect)
EffectInsert

效果連接模式為插入。

(繼承來源 AudioEffect)
EffectPostProcessing

效果連線模式是後處理。

(繼承來源 AudioEffect)
EffectPreProcessing

效果連線模式是預處理。

(繼承來源 AudioEffect)
Error
已淘汰.

未說明錯誤。

(繼承來源 AudioEffect)
ErrorBadValue
已淘汰.

操作失敗是因為參數值錯誤。

(繼承來源 AudioEffect)
ErrorDeadObject
已淘汰.

操作失敗,因為遠端物件失效。

(繼承來源 AudioEffect)
ErrorInvalidOperation
已淘汰.

手術失敗是因為申請在錯誤的州。

(繼承來源 AudioEffect)
ErrorNoInit
已淘汰.

操作失敗是因為物件初始化不良。

(繼承來源 AudioEffect)
ErrorNoMemory
已淘汰.

由於記憶體不足,操作失敗。

(繼承來源 AudioEffect)
ExtraAudioSession

包含應套用效果的音訊會話 ID。

(繼承來源 AudioEffect)
ExtraContentType

顯示應用程式播放的內容類型。

(繼承來源 AudioEffect)
ExtraPackageName

包含呼叫應用程式的套件名稱。

(繼承來源 AudioEffect)
Success
已淘汰.

手術成功。

(繼承來源 AudioEffect)
VariantFavorFrequencyResolution
已淘汰.

偏向頻率解析度的變異指數。

VariantFavorTimeResolution
已淘汰.

偏向時間解析度解析度的變體指數。

屬性

名稱 Description
ChannelCount

取得效果引擎中的通道數量

Class

回傳此 Object的執行時類別。

(繼承來源 Object)
Enabled

回傳效應啟用狀態

(繼承來源 AudioEffect)
Handle

底層 Android 實例的帳號。

(繼承來源 Object)
HasControl

檢查這個 AudioEffect 物件是否控制效果引擎。

(繼承來源 AudioEffect)
Id

回報效應唯一識別碼。

(繼承來源 AudioEffect)
JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
ThresholdClass

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

(繼承來源 AudioEffect)
ThresholdType

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

(繼承來源 AudioEffect)

方法

名稱 Description
Clone()

建立並回傳此物件的副本。

(繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
GetChannelByChannelIndex(Int32)

取得同一通道的輸入增益和所有處理階段設定。

GetConfig()

回傳用來設定此效果的 Config 物件。

GetDescriptor()

取得效果描述符。

(繼承來源 AudioEffect)
GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetInputGainByChannelIndex(Int32)

取得一個通道的輸入增益。

GetLimiterByChannelIndex(Int32)

取得一個聲道的限制器階段設定。

GetMbcBandByChannelIndex(Int32, Int32)

取得一個頻道的多頻段壓縮器頻段設定。

GetMbcByChannelIndex(Int32)

取得一個通道的多頻段壓縮器階段設定。

GetPostEqBandByChannelIndex(Int32, Int32)

會取得一個聲道的後均衡器頻段設定。

GetPostEqByChannelIndex(Int32)

取得一個聲道的後均衡器階段設定。

GetPreEqBandByChannelIndex(Int32, Int32)

取得一個通道的預均衡器頻段設定。

GetPreEqByChannelIndex(Int32)

取得一個聲道的預均衡器階段設定。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
Release()

釋出原生 AudioEffect 資源。

(繼承來源 AudioEffect)
SetAllChannelsTo(DynamicsProcessing+Channel)

為所有頻道設定完整的頻道設定。

SetChannelTo(Int32, DynamicsProcessing+Channel)

為一個頻道設定完整的頻道設定。

SetControlStatusListener(AudioEffect+IOnControlStatusChangeListener)

設定聽眾 AudioEffect 會在效果引擎控制被接管或回傳時通知。

(繼承來源 AudioEffect)
SetEnabled(Boolean)

啟用或關閉這個效果。

(繼承來源 AudioEffect)
SetEnableStatusListener(AudioEffect+IOnEnableStatusChangeListener)

設定聽者 AudioEffect 會在效果引擎啟用或關閉時通知。

(繼承來源 AudioEffect)
SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetInputGainAllChannelsTo(Single)

設定所有通道的輸入增益。

SetInputGainbyChannel(Int32, Single)

設定一個通道的輸入增益。

SetLimiterAllChannelsTo(DynamicsProcessing+Limiter)

為所有頻道設定限制器階段設定。

SetLimiterByChannelIndex(Int32, DynamicsProcessing+Limiter)

設定一個聲道的限制器階段設定。

SetMbcAllChannelsTo(DynamicsProcessing+Mbc)

為所有頻道設定多頻段壓縮器舞台設定。

SetMbcBandAllChannelsTo(Int32, DynamicsProcessing+MbcBand)

為所有聲道設定多頻段壓縮器頻段設定。

SetMbcBandByChannelIndex(Int32, Int32, DynamicsProcessing+MbcBand)

設定一個聲道的多頻段壓縮器頻段設定。

SetMbcByChannelIndex(Int32, DynamicsProcessing+Mbc)

為一個聲道設定多頻段壓縮器階段設定。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
SetPostEqAllChannelsTo(DynamicsProcessing+Eq)

為所有頻道設定均衡器後階段設定。

SetPostEqBandAllChannelsTo(Int32, DynamicsProcessing+EqBand)

設定所有頻道的後均衡器頻段設定。

SetPostEqBandByChannelIndex(Int32, Int32, DynamicsProcessing+EqBand)

設定一個聲道的後均衡器頻段設定。

SetPostEqByChannelIndex(Int32, DynamicsProcessing+Eq)

設定一個聲道的均衡器後階段設定。

SetPreEqAllChannelsTo(DynamicsProcessing+Eq)

為所有聲道設定預均衡器階段設定。

SetPreEqBandAllChannelsTo(Int32, DynamicsProcessing+EqBand)

為所有頻道設定預均衡器頻段設定。

SetPreEqBandByChannelIndex(Int32, Int32, DynamicsProcessing+EqBand)

設定一個聲道的預等化頻段設定。

SetPreEqByChannelIndex(Int32, DynamicsProcessing+Eq)

設定一個通道的預等化器階段設定。

ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
Wait()

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

(繼承來源 Object)
Wait(Int64, Int32)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)

事件

名稱 Description
ControlStatus

當該應用獲得或失去對效果引擎的控制時,會發生這種情況。

(繼承來源 AudioEffect)
EnableStatus

當控制應用程式改變效果引擎的啟用狀態時,會發生這種情況。

(繼承來源 AudioEffect)

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於