AudioEffect 類別

定義

命名空間:: Android.Media.Audiofx

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。

[Android.Runtime.Register("android/media/audiofx/AudioEffect", DoNotGenerateAcw=true)]
public class AudioEffect : Java.Lang.Object

[<Android.Runtime.Register("android/media/audiofx/AudioEffect", DoNotGenerateAcw=true)>]
type AudioEffect = class
    inherit Object

繼承: Object

JavaObject

Object
AudioEffect

衍生: Android.Media.Audiofx.AcousticEchoCanceler

Android.Media.Audiofx.AutomaticGainControl

Android.Media.Audiofx.BassBoost

Android.Media.Audiofx.DynamicsProcessing

Android.Media.Audiofx.EnvironmentalReverb

更多…

屬性: RegisterAttribute

備註

AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。

應用程式不應直接使用 AudioEffect 類別，而是使用其衍生類別來控制特定效果：<ul><li>android.media.audiofx.Equalizer</li li><>/liandroid.media.audiofx.Virtualizer<><li>android.media.audiofx.BassBoost</li><>android.media.audiofx.PresetReverb< li/li><>android.media.audiofx.EnvironmentalReverb<><>android.media.audiofx.DynamicsProcessing<><>android.media.audiofx.HapticGenerator<></ul>

若要將音訊效果套用到特定的 AudioTrack 或 MediaPlayer 實例，應用程式在建立 AudioEffect 時必須指定該實例的音訊會話 ID。（詳見 android.media.MediaPlayer#getAudioSessionId() 音頻課程細節）

注意：使用 session 0 將插入效果（均衡器、低音增強、虛擬化器）附加到全域音訊輸出混音中，是不被推薦的。

若指定音頻工作階段中不存在相同效果類型的實例，建立 AudioEffect 物件會在音訊框架中建立相應的效果引擎。如果有，這個實例就會被使用。

建立 AudioEffect 物件（或衍生類別）的應用程式會根據優先權參數，要麼獲得效果引擎的控制權。若優先權高於當前效果引擎擁有者的優先權，控制權將轉移至新物件。否則控制權將保留在前一個物件手中。在這種情況下，適當的監聽者會通知新應用程式引擎狀態或控制權的所有權變更。

Java 文件 android.media.audiofx.AudioEffect。

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

建構函式

名稱	Description
AudioEffect(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
ActionCloseAudioEffectControlSession	意圖向效果控制應用或服務發出音訊會話已關閉，且不應再套用效果的訊號。
ActionDisplayAudioEffectControlPanel	打算啟動一個音效控制面板的介面。
ActionOpenAudioEffectControlSession	意圖向效果控制應用程式或服務發出訊號，表示已開啟新的音訊工作階段，並需要套用音訊效果。
AlreadyExists	已淘汰. 內部運作狀態。
ContentTypeGame	已淘汰. 當播放內容類型為遊戲音效時的價值`#EXTRA_CONTENT_TYPE`
ContentTypeMovie	已淘汰. 當播放內容類型為影片或電影時的價值`#EXTRA_CONTENT_TYPE`
ContentTypeMusic	已淘汰. 當播放內容類型是音樂時的價值`#EXTRA_CONTENT_TYPE`
ContentTypeVoice	已淘汰. 當播放內容類型為語音音訊時的價值`#EXTRA_CONTENT_TYPE`
EffectAuxiliary	效果連接模式為輔助。
EffectInsert	效果連接模式為插入。
EffectPostProcessing	效果連線模式是後處理。
EffectPreProcessing	效果連線模式是預處理。
Error	已淘汰. 未說明錯誤。
ErrorBadValue	已淘汰. 操作失敗是因為參數值錯誤。
ErrorDeadObject	已淘汰. 操作失敗，因為遠端物件失效。
ErrorInvalidOperation	已淘汰. 手術失敗是因為申請在錯誤的州。
ErrorNoInit	已淘汰. 操作失敗是因為物件初始化不良。
ErrorNoMemory	已淘汰. 由於記憶體不足，操作失敗。
ExtraAudioSession	包含應套用效果的音訊會話 ID。
ExtraContentType	顯示應用程式播放的內容類型。
ExtraPackageName	包含呼叫應用程式的套件名稱。
Success	已淘汰. 手術成功。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
EffectTypeAec	UUID 用於聲學回聲消除器（AEC）
EffectTypeAgc	UUID 用於自動增益控制（AGC）
EffectTypeBassBoost	低音增強效果的 UUID
EffectTypeDynamicsProcessing	Dynamics Processing 的 UUID
EffectTypeEnvReverb	環境迴響效應的UUID
EffectTypeEqualizer	UUID 用於均衡器效果
EffectTypeHapticGenerator	UUID 代表觸覺產生器。
EffectTypeLoudnessEnhancer	UUID 代表響度增強器
EffectTypeNs	UUID 用於噪音抑制器（NS）
EffectTypePresetReverb	UUID 用於預設混響效果
EffectTypeVirtualizer	虛擬化效果的UUID
Enabled	回傳效應啟用狀態
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HasControl	檢查這個 AudioEffect 物件是否控制效果引擎。
Id	回報效應唯一識別碼。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
JniPeerMembers	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
Equals(Object)	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetDescriptor()	取得效果描述符。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
QueryEffects()	查詢平台上所有可用的效果。
Release()	釋出原生 AudioEffect 資源。
SetControlStatusListener(AudioEffect+IOnControlStatusChangeListener)	設定聽眾 AudioEffect 會在效果引擎控制被接管或回傳時通知。
SetEnabled(Boolean)	啟用或關閉這個效果。
SetEnableStatusListener(AudioEffect+IOnEnableStatusChangeListener)	設定聽者 AudioEffect 會在效果引擎啟用或關閉時通知。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

事件

名稱	Description
ControlStatus	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。
EnableStatus	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	AudioEffect 是控制 Android 音效框架所提供的音效的基礎類別。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於