Visualizer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。
[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- 継承
- 属性
注釈
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 オーディオ録音インターフェイスではなく、部分的かつ低品質のオーディオ コンテンツのみを返します。 ただし、特定のオーディオ データ (ボイス メールなど) のプライバシーを保護するには、ビジュアライザーの使用にandroid.permission.RECORD_AUDIOアクセス許可が必要です。
コンストラクターに渡されるオーディオ セッション ID は、視覚化するオーディオ コンテンツを示します:<br><ul><li>セッションが 0 の場合、オーディオ出力ミックスは視覚化されます</li><li>セッションが 0 でない場合、このオーディオ セッションを使用した特定の android.media.MediaPlayer または android.media.AudioTrack からのオーディオは、 </li></ul に視覚化されます。>
オーディオ コンテンツの 2 種類の表現をキャプチャできます。 <br><ul><li>Waveform データ: #getWaveForm(byte[]) メソッドを使用した連続する 8 ビット (符号なし) モノラル サンプル</li><li>周波数データ: #getFft(byte[]) メソッドを使用した 8 ビット振幅 FFT</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 され、ピーク時および RMS 監視用に #MEASUREMENT_MODE_PEAK_RMS されます。 測定値は、 #getMeasurementPeakRms(MeasurementPeakRms)を使用して取得できます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| 名前 | 説明 |
|---|---|
| Visualizer(Int32) |
クラス コンストラクター。 |
| Visualizer(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
フィールド
| 名前 | 説明 |
|---|---|
| AlreadyExists |
古い.
内部操作の状態。 |
| Error |
古い.
予測できないエラーです。 |
| ErrorBadValue |
古い.
パラメーター値が正しくないため、操作に失敗しました。 |
| ErrorDeadObject |
古い.
リモート オブジェクトが停止したため、操作に失敗しました。 |
| ErrorInvalidOperation |
古い.
操作が間違った状態で要求されたために失敗しました。 |
| ErrorNoInit |
古い.
オブジェクトの初期化が正しくないため、操作に失敗しました。 |
| ErrorNoMemory |
古い.
メモリ不足のため、操作に失敗しました。 |
| MeasurementModeNone |
古い.
測定を実行しない測定モードを定義します。 |
| MeasurementModePeakRms |
古い.
"フル スケール" より下の mB のピーク値と RMS 値を計算する測定モードを定義します。通常、0mB は最大サンプル値です (ただし、以下の注を参照)。 |
| ScalingModeAsPlayed |
古い.
再生ボリュームがキャプチャされたデータの範囲に影響を与えるキャプチャ モード (スケール) を定義します。 |
| ScalingModeNormalized |
古い.
キャプチャされたデータの内容に基づいて増幅が適用されるキャプチャ モードを定義します。 |
| StateEnabled |
古い.
アクティブなビジュアライザー オブジェクトの状態。 |
| StateInitialized |
古い.
使用する準備ができているビジュアライザー オブジェクトの状態。 |
| StateUninitialized |
古い.
作成時に正常に初期化されなかったビジュアライザー オブジェクトの状態 |
| Success |
古い.
正常な操作。 |
プロパティ
| 名前 | 説明 |
|---|---|
| CaptureSize |
現在のキャプチャ サイズを返します。 |
| Class |
この |
| Enabled |
ビジュアライザーの現在のアクティブ化状態を取得します。 |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| JniIdentityHashCode |
相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object) |
| JniManagedPeerState |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| JniPeerMembers |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 |
| MaxCaptureRate |
コールバック キャプチャ メソッドの最大キャプチャ レートを返します。 |
| MeasurementMode |
このオーディオ効果によって実行される現在の測定モードを返します |
| PeerReference |
このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object) |
| SamplingRate |
キャプチャされたオーディオのサンプリング レートを返します。 |
| ScalingMode |
キャプチャされた視覚化データの現在のスケーリング モードを返します。 |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
メソッド
| 名前 | 説明 |
|---|---|
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| Equals(Object) |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| GetCaptureSizeRange() |
キャプチャ サイズの範囲を返します。 |
| GetFft(Byte[]) |
現在再生中のオーディオ コンテンツの周波数キャプチャを返します。 |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| GetMeasurementPeakRms(Visualizer+MeasurementPeakRms) |
最新のピークおよび RMS 測定を取得します。 |
| GetWaveForm(Byte[]) |
現在再生中のオーディオ コンテンツの波形キャプチャを返します。 |
| JavaFinalize() |
古い.
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| Release() |
ネイティブ ビジュアライザー リソースを解放します。 |
| SetCaptureSize(Int32) |
キャプチャ サイズ (i) を設定します。 |
| SetDataCaptureListener(Visualizer+IOnDataCaptureListener, Int32, Boolean, Boolean) |
OnDataCaptureListener インターフェイスを登録し、キャプチャを更新する速度と、要求されたキャプチャの種類を指定します。 |
| SetEnabled(Boolean) |
視覚化エンジンを有効または無効にします。 |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| SetMeasurementMode(VisualizerMeasurementMode) |
このオーディオ効果によって実行される測定モードの組み合わせを設定します。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| SetScalingMode(VisualizerScalingMode) |
キャプチャした視覚化データに適用されるスケーリングの種類を設定します。 |
| ToArray<T>() |
このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object) |
| ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object) |
| Wait() |
現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IJavaPeerable.Disposed() |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| IJavaPeerable.Finalized() |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 (継承元 JavaObject) |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
Visualizer クラスを使用すると、アプリケーションは視覚化のために現在再生中のオーディオの一部を取得できます。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|