Visualizer 類別

定義

命名空間:

Android.Media.Audiofx

組件:

Mono.Android.dll

視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。

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

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

繼承

Object

Object

Visualizer

屬性

RegisterAttribute

備註

視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 它不是音訊錄製介面，只會傳回部分和低品質的音訊內容。 不過，若要保護特定音訊資料的隱私權， (例如語音信箱) 使用視覺化檢視需要許可權android.permission.RECORD_AUDIO。

傳遞至建構函式的音訊會話識別碼會指出哪些音訊內容應該視覺化： < br <> ul <> li > 如果會話是 0，音訊輸出混合會視覺化 < /li li > 如果會話不是 0，則來自特定 android.media.MediaPlayer 或 android.media.AudioTrack 使用此音訊會話的音訊會視覺化 < 為 /li <><> /ul>

可以擷取音訊內容的兩種標記法：br <> ul >< li > Waveform 資料： < 連續的 8 位 (未帶正負號的) mono 範例：使用 #getWaveForm(byte[]) 方法/li >< li Frequency 資料：8 位大小 FFT，方法是使用 #getFft(byte[]) method << /li >>< /ul>

您可以分別 #getCaptureSize() 呼叫 和 #setCaptureSize(int) 方法來擷取或指定擷取的長度。 擷取大小必須是 所傳回 #getCaptureSizeRange() 範圍中的 2 乘冪。

除了使用 #getWaveForm(byte[]) 和 #getFft(byte[]) 方法所述的輪詢擷取模式之外，也可以使用 方法來安裝接聽程式來 #setDataCaptureListener(OnDataCaptureListener, int, boolean, boolean) 取得回呼模式。 呼叫接聽程式擷取方法的速率，以及指定傳回的資料類型。

在擷取資料之前，必須呼叫 #setEnabled(boolean) 方法來啟用視覺化檢視。 當不再需要資料擷取時，應該停用視覺化檢視。

#release()當不再使用視覺化檢視來釋放與視覺化檢視實例相關聯的原生資源時，最好呼叫 方法。

在輸出混合上建立視覺化檢視 (音訊會話 0) 需要許可權 android.Manifest.permission#MODIFY_AUDIO_SETTINGS

視覺化檢視類別也可用來對播放的音訊執行測量。 要執行的度量是藉由使用 #setMeasurementMode(int) 設定所要求測量模式的遮罩來定義。 支援的值是 #MEASUREMENT_MODE_NONE 取消任何度量，以及 #MEASUREMENT_MODE_PEAK_RMS 尖峰和 RMS 監視。 度量可透過 #getMeasurementPeakRms(MeasurementPeakRms) 擷取。

的 android.media.audiofx.Visualizer JAVA 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據中所述的詞彙使用。

建構函式

Visualizer(Int32)	類別建構函式。
Visualizer(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。

欄位

AlreadyExists	已淘汰. 內部作業狀態。
Error	已淘汰. 未指定的錯誤。
ErrorBadValue	已淘汰. 作業失敗，因為參數值不正確。
ErrorDeadObject	已淘汰. 作業失敗，因為遠端物件無效。
ErrorInvalidOperation	已淘汰. 作業失敗，因為要求處於錯誤狀態。
ErrorNoInit	已淘汰. 作業失敗，因為物件初始化不正確。
ErrorNoMemory	已淘汰. 作業因為記憶體不足而失敗。
MeasurementModeNone	已淘汰. 定義不會執行任何度量的度量模式。
MeasurementModePeakRms	已淘汰. 定義測量模式，以 mB 計算「完整小數位數」下方的尖峰和 RMS 值，其中 0mB 通常是最大樣本值 (，但請參閱下列注意事項) 。
ScalingModeAsPlayed	已淘汰. 定義擷取模式，其中播放音量會影響 (調整) 擷取資料的範圍。
ScalingModeNormalized	已淘汰. 定義擷取模式，其中會根據擷取資料的內容套用放大。
StateEnabled	已淘汰. 作用中之視覺化檢視物件的狀態。
StateInitialized	已淘汰. 準備好使用之視覺化檢視物件的狀態。
StateUninitialized	已淘汰. 建立時未成功初始化的視覺化檢視物件狀態
Success	已淘汰. 成功的作業。

屬性

CaptureSize	傳回目前的擷取大小。
Class	傳回這個 Object 的執行時間類別。 (繼承來源 Object)
Enabled	取得視覺化檢視的目前啟用狀態。
Handle	基礎 Android 實例的控制碼。 (繼承來源 Object)
JniIdentityHashCode	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
JniPeerMembers	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。
MaxCaptureRate	傳回回回呼擷取方法的最大擷取速率。
MeasurementMode	傳回這個音訊效果所執行的目前測量模式
PeerReference	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
SamplingRate	傳回所擷取音訊的取樣率。
ScalingMode	傳回所擷取視覺效果資料的目前縮放模式。
ThresholdClass	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式碼使用。
ThresholdType	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式碼使用。

方法

Clone()	建立並傳回這個 物件的複本。 (繼承來源 Object)
Dispose()	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
Dispose(Boolean)	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
GetCaptureSizeRange()	傳回擷取大小範圍。
GetFft(Byte[])	傳回目前播放音訊內容的頻率擷取。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetMeasurementPeakRms(Visualizer+MeasurementPeakRms)	擷取最新的尖峰和 RMS 測量。
GetWaveForm(Byte[])	傳回目前播放音訊內容的信號擷取。
JavaFinalize()	當垃圾收集判斷物件沒有其他參考時，由物件上的垃圾收集行程呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件的監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
Release()	釋放原生視覺化檢視資源。
SetCaptureSize(Int32)	設定擷取大小 i.
SetDataCaptureListener(Visualizer+IOnDataCaptureListener, Int32, Boolean, Boolean)	註冊 OnDataCaptureListener 介面，並指定擷取應該更新的速率，以及要求的擷取類型。
SetEnabled(Boolean)	啟用或停用視覺效果引擎。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetMeasurementMode(VisualizerMeasurementMode)	設定這個音訊效果所要執行之測量模式的組合。
SetScalingMode(VisualizerScalingMode)	設定在擷取視覺效果資料上套用的縮放類型。
ToArray<T>()	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
Wait()	讓目前的執行緒等到喚醒為止，通常是藉由 < em > notified < /em > 或 < em > interrupted < /em > 來喚醒。 (繼承來源 Object)
Wait(Int64)	讓目前的執行緒等到喚醒為止，通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ，或 < 直到經過一定數量的即時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的執行緒等到喚醒為止，通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ，或 < 直到經過一定數量的即時為止。 (繼承來源 Object)

明確介面實作

IJavaPeerable.Disposed()	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
IJavaPeerable.Finalized()	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。
GetJniTypeName(IJavaPeerable)	視覺化檢視類別可讓應用程式擷取目前播放音訊的一部分，以供視覺效果之用。