Virtualizer 類別

定義

命名空間:: Android.Media.Audiofx

組件:: Mono.Android.dll

重要

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

音訊虛擬化器是指用來空間化音訊通道的效果。

[Android.Runtime.Register("android/media/audiofx/Virtualizer", DoNotGenerateAcw=true)]
public class Virtualizer : Android.Media.Audiofx.AudioEffect

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

繼承: Object

JavaObject

Object

AudioEffect
Virtualizer

屬性: RegisterAttribute

備註

音訊虛擬化器是指用來空間化音訊通道的效果。此效應的具體行為取決於音訊輸入通道數量及裝置的音訊輸出通道類型與數量。例如，在立體聲輸入與立體聲耳機輸出的情況下，當此效果開啟時會使用立體聲擴寬效果。

應用程式會建立一個虛擬化器物件，用以實例化並控制音訊框架中的虛擬化引擎。

虛擬化器實作中暴露的方法、參數類型與單元，直接映射自 OpenSL ES 1.0.1 規範（http://www.khronos.org/opensles/) 針對 SLVirtualizerItf 介面）所定義的。詳情請參閱此規範。

要將虛擬器附加到特定的 AudioTrack 或 MediaPlayer，建構虛擬化器時，請指定該 AudioTrack 或 MediaPlayer 的音訊會話 ID。

注意：使用會話 0 將虛擬化器附加到全域音訊輸出混音中已不再被推薦。

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

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

此會員已被棄用。使用這個 android.media.Spatializer 類別來查詢平台在空間化（音訊頻道虛擬化的另一個名稱）方面的能力，以及 android.media.AudioAttributes.Builder#setSpatializationBehavior(int) 描述你希望在支援空間化時播放內容的方式。

Java 文件 android.media.audiofx.Virtualizer。

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

建構函式

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

欄位

名稱	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)
ParamStrength	虛擬化器效應強度。
ParamStrengthSupported	是虛擬化引擎支援的強度參數。
Success	已淘汰. 手術成功。 (繼承來源 AudioEffect)

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Enabled	回傳效應啟用狀態 (繼承來源 AudioEffect)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HasControl	檢查這個 AudioEffect 物件是否控制效果引擎。 (繼承來源 AudioEffect)
Id	回報效應唯一識別碼。 (繼承來源 AudioEffect)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	音訊虛擬化器是指用來空間化音訊通道的效果。 (繼承來源 JavaObject)
JniPeerMembers	音訊虛擬化器是指用來空間化音訊通道的效果。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Properties	取得虛擬化器的特性。
RoundedStrength	獲得目前效果的強度。
StrengthSupported	表示是否支持設定強度。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
VirtualizationMode	如果有虛擬化模式，請回傳。

方法

名稱	Description
CanVirtualize(ChannelIn, VirtualizationMode)	檢查此虛擬化器是否支援通道遮罩與虛擬化模式的組合。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	音訊虛擬化器是指用來空間化音訊通道的效果。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	音訊虛擬化器是指用來空間化音訊通道的效果。 (繼承來源 JavaObject)
Equals(Object)	音訊虛擬化器是指用來空間化音訊通道的效果。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
ForceVirtualizationMode(VirtualizationMode)	強制虛擬化器效應使用指定的處理模式。
GetDescriptor()	取得效果描述符。 (繼承來源 AudioEffect)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetSpeakerAngles(ChannelIn, VirtualizationMode, Int32[])	查詢結合頻道遮罩與虛擬化模式的虛擬喇叭角度（方位角與仰角）。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Release()	釋出原生 AudioEffect 資源。 (繼承來源 AudioEffect)
SetControlStatusListener(AudioEffect+IOnControlStatusChangeListener)	設定聽眾 AudioEffect 會在效果引擎控制被接管或回傳時通知。 (繼承來源 AudioEffect)
SetEnabled(Boolean)	啟用或關閉這個效果。 (繼承來源 AudioEffect)
SetEnableStatusListener(AudioEffect+IOnEnableStatusChangeListener)	設定聽者 AudioEffect 會在效果引擎啟用或關閉時通知。 (繼承來源 AudioEffect)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetParameterListener(Virtualizer+IOnParameterChangeListener)	註冊一個 OnParameterChangeListener 介面。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	音訊虛擬化器是指用來空間化音訊通道的效果。 (繼承來源 JavaObject)
SetStrength(Int16)	設定虛擬化器效應的強度。
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)
EnableStatus	音訊虛擬化器是指用來空間化音訊通道的效果。 (繼承來源 AudioEffect)
Parameter	音訊虛擬化器是指用來空間化音訊通道的效果。

明確介面實作

名稱	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)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	音訊虛擬化器是指用來空間化音訊通道的效果。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於