DynamicsProcessing 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。
[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
- 繼承
- 屬性
備註
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 它由多個階段組成,包括均衡、多頻段壓縮與限制器。
頻段數與主動級數可自訂,且大多數參數可即時控制,如增益、起放時間、閾值等。
這個效果是由通道實例化並控制的。 每個通道的基本架構相同,但其所有參數都獨立於其他通道。
基本通道配置如下:
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 |
已淘汰.
當播放內容類型為遊戲音效時的價值 |
| ContentTypeMovie |
已淘汰.
當播放內容類型為影片或電影時的價值 |
| ContentTypeMusic |
已淘汰.
當播放內容類型是音樂時的價值 |
| ContentTypeVoice |
已淘汰.
當播放內容類型為語音音訊時的價值 |
| 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 |
回傳此 |
| Enabled |
回傳效應啟用狀態 (繼承來源 AudioEffect) |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| HasControl |
檢查這個 AudioEffect 物件是否控制效果引擎。 (繼承來源 AudioEffect) |
| Id |
回報效應唯一識別碼。 (繼承來源 AudioEffect) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 JavaObject) |
| JniPeerMembers |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 AudioEffect) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 AudioEffect) |
方法
事件
| 名稱 | Description |
|---|---|
| ControlStatus |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 AudioEffect) |
| EnableStatus |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 AudioEffect) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
動態處理是一種用於均衡和改變聲音動態範圍特性的音訊效果。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |