語言

AudioTrack 類別

定義

AudioTrack 類別負責管理並播放單一 Java 應用程式的音訊資源。

[Android.Runtime.Register("android/media/AudioTrack", DoNotGenerateAcw=true)]
public class AudioTrack : Java.Lang.Object, Android.Media.IAudioRouting, Android.Media.IVolumeAutomation, IDisposable
[<Android.Runtime.Register("android/media/AudioTrack", DoNotGenerateAcw=true)>]
type AudioTrack = class
    inherit Object
    interface IAudioRouting
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IVolumeAutomation
繼承
AudioTrack
屬性
實作

備註

AudioTrack 類別負責管理並播放單一 Java 應用程式的音訊資源。 它允許將 PCM 音訊緩衝區串流到音訊匯流器進行播放。 這是透過使用其中一種 #write(byte[], int, int)、 #write(short[], int, int)和 #write(float[], int, int, int) 方法之一,將資料「推送」到 AudioTrack 物件來達成的。

AudioTrack 實例可在兩種模式下運作:靜態或串流。<br> 在串流模式下,應用程式會用 write() 以下一種方法,連續寫入 AudioTrack 的資料串流。 這些是區塊,當資料從 Java 層傳輸到原生層並排隊播放時,會回傳。 串流模式在播放以下音訊資料區塊時最為有用:

<UL><LI>因為聲音播放時間太長而無法放入記憶體,</ LI><LI>太大無法放入記憶體,原因是音訊資料的特性(高取樣率、每取樣位元數等)</li><li>在先前排隊音訊播放時接收或產生。</li></ul>

當處理適合記憶體且需要以最低延遲播放的短音時,應選擇靜態模式。 因此,靜態模式會被偏好用於經常播放且負擔最小的介面與遊戲音效。

建立時,AudioTrack 物件會初始化其對應的音訊緩衝區。 在建構過程中指定的緩衝區大小,決定了 AudioTrack 在資料耗盡前能播放多久。<br> 對於使用靜態模式的 AudioTrack,這個大小是可播放的最大音效大小。<br> 在串流模式下,資料會以大小小於或等於總緩衝區大小的區塊寫入音訊匯流器。

AudioTrack 尚未最終定型,因此允許子職業,但不建議使用此類方式。

Java 文件 android.media.AudioTrack。

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

建構函式

名稱 Description
AudioTrack(AudioAttributes, AudioFormat, Int32, AudioTrackMode, Int32)

類別構造器,且 。AudioAttributesAudioFormat

AudioTrack(IntPtr, JniHandleOwnership)

用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

AudioTrack(Stream, Int32, ChannelConfiguration, Encoding, Int32, AudioTrackMode, Int32)
已淘汰.

帶有音訊會話的職業構造器。

AudioTrack(Stream, Int32, ChannelConfiguration, Encoding, Int32, AudioTrackMode)
已淘汰.

職業建造者。

AudioTrack(Stream, Int32, ChannelOut, Encoding, Int32, AudioTrackMode, Int32)

帶有音訊會話的職業構造器。

AudioTrack(Stream, Int32, ChannelOut, Encoding, Int32, AudioTrackMode)

職業建造者。

欄位

名稱 Description
DualMonoModeLl
已淘汰.

此模式表示立體聲串流應將左側音訊聲道複製至右側音訊聲道。

DualMonoModeLr
已淘汰.

此模式表示立體聲串流應將左右聲道混合呈現,並同時傳送至兩個聲道。

DualMonoModeOff
已淘汰.

此模式會關閉任何雙單聲道呈現效果。

DualMonoModeRr
已淘汰.

此模式表示立體聲串流應將右側音訊聲道複製到左聲道中呈現。

EncapsulationMetadataTypeDvbAdDescriptor
已淘汰.

DVB AD 描述符的封裝元資料類型。

EncapsulationMetadataTypeFrameworkTuner
已淘汰.

框架調諧器資訊的封裝元資料類型。

EncapsulationMetadataTypeSupplementaryAudioPlacement
已淘汰.

用於放置補充音訊的封裝元資料類型。

EncapsulationModeElementaryStream
已淘汰.

此模式表示以基本串流有效載荷封裝元資料。

EncapsulationModeNone
已淘汰.

此模式表示不進行元資料封裝,這是透過 傳送音訊資料 AudioTrack的預設模式。

Error
已淘汰.

表示通用操作失敗。

ErrorBadValue
已淘汰.

表示因使用無效值而失敗。

ErrorDeadObject
已淘汰.

錯誤代碼表示回報該物件已不再有效,需要重新建立。

ErrorInvalidOperation
已淘汰.

表示因方法使用不當而失敗。

FlushFromAccuracyBestEffort
已淘汰.

用來指示框架的準確度模式 #flushWrittenFramesFromPosition(long, int) 會將資料沖刷到盡可能接近但不會低於要求的位置。

FlushFromAccuracyExact
已淘汰.

指示 AudioTrack 的準確度模式 #flushWrittenFramesFromPosition(long, int) 必須從指定位置清除。

FlushWrittenFramesSupported
已淘汰.

支援恆定旗標值以表示 #flushWrittenFramesFromPosition(long, int) 。

Success
已淘汰.

表示手術成功。

SupplementaryAudioPlacementLeft
已淘汰.

補充音訊放置位置。

SupplementaryAudioPlacementNormal
已淘汰.

補充音響放置正常。

SupplementaryAudioPlacementRight
已淘汰.

補充音訊位置,對。

屬性

名稱 Description
AudioAttributes

退還 AudioAttributes 配置中的二手。

AudioDescriptionMixLeveldB

回傳音訊描述的混音音量(dB)。

AudioFormat

回傳已設定的音訊資料編碼。

AudioSessionId

回傳音訊會話 ID。

BufferCapacityInFrames

回傳緩衝區的最大大小 AudioTrack (以幀為單位)。

BufferSizeInFrames

回傳應用程式寫入的緩衝區有效大小 AudioTrack 。

ChannelConfiguration

回傳已設定的通道位置遮罩。

ChannelCount

回傳設定好的頻道數量。

Class

回傳此 Object的執行時類別。

(繼承來源 Object)
CodecProvenance

回傳設定時指定編 AudioTrack 解碼器的來源。

DualMonoMode

回傳雙單聲道模式的呈現設定。

Format

會回傳已設定 AudioTrack 的格式。

Handle

底層 Android 實例的帳號。

(繼承來源 Object)
IsOffloadedPlayback

回傳該軌道是否被設定 Builder#setOffloadedPlayback(boolean) 為 true。

JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

LogSessionId

傳回 LogSessionId。 -或- 將實例設定 LogSessionId 到這個 AudioTrack 以收集指標。

MaxVolume

回傳最大增益值,該值大於或等於1.0。

Metrics

回傳關於目前 AudioTrack 實例的 Metrics 資料。

MinVolume

回傳最小增益值,即常數 0.0。

NativeFrameCount
已淘汰.

回傳原生 AudioTrack 緩衝區的影格數。

NotificationMarkerPosition

回傳標記位置以影格表示。

OffloadDelay

回傳已卸載軌道的解碼延遲,以影格表示,先前設定為 #setOffloadDelayPadding(int, int),若未修改則為 0。

OffloadPadding

回傳已卸載軌道的解碼器填充,以幀表示,先前設定為 #setOffloadDelayPadding(int, int),若從未修改則為 0。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
PerformanceMode

回傳 的當前效能模式。AudioTrack

PlaybackHeadPosition

回傳以影格表示的播放頭位置。

PlaybackParams

回傳目前的播放參數。 -或- 設定播放參數。

PlaybackRate

回傳目前播放的取樣率以 Hz 為單位。

PlayState

回傳 AudioTrack 實例的播放狀態。

PositionNotificationPeriod

回傳以幀表示的通知更新期間。

PreferredDevice

回傳由 #setPreferredDevice所指定的選擇輸出。

RoutedDevice

回傳並 AudioDeviceInfo 識別此 AudioTrack 目前的路由。

RoutedDevices

回傳一份清單,識別 AudioDeviceInfo 此 AudioTrack 目前的路由。

SampleRate

回傳設定好的音訊來源取樣率(Hz)。

StartThresholdInFrames

回傳串流開始閾值。AudioTrack

State

回傳 AudioTrack 實例的狀態。

StreamType

回傳此 AudioTrack 的音量串流類型。

ThresholdClass

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

ThresholdType

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

UnderrunCount

回傳自 AudioTrack 建立以來,應用程式層寫緩衝區中欠載次數。

WrittenFramesCount

回傳寫入 的 StreamAudioTrack音訊幀數。

方法

名稱 Description
AddOnCodecFormatChangedListener(IExecutor, AudioTrack+IOnCodecFormatChangedListener)

新增 以 OnCodecFormatChangedListener 接收編解碼器格式變更事件 AudioTrack的通知。

AddOnRoutingChangedListener(AudioTrack+IOnRoutingChangedListener, Handler)
已淘汰.

新增並 AudioRouting.OnRoutingChangedListener 接收此 AudioTrack 路由變更通知。

AddOnRoutingChangedListener(IAudioRoutingOnRoutingChangedListener, Handler)

新增並 AudioRouting.OnRoutingChangedListener 接收此 AudioTrack 路由變更通知。

AttachAuxEffect(Int32)

為音軌附加輔助效果。

Clone()

建立並回傳此物件的副本。

(繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
CreateVolumeShaper(VolumeShaper+Configuration)

回傳一個 VolumeShaper 物件,可用來修改播放器或軌道的音量包絡。

Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
Flush()

清除目前排隊播放的音訊資料。

FlushWrittenFramesFromPosition(Int64, Int32)

從該位置清除所有資料。

GetFlushWrittenFramesFromPositionSupport(AudioFormat, AudioAttributes)

回傳一個位元遮罩,代表目前對 AudioTrack 在卸載模式下的 #flushWrittenFramesFromPosition(long, int) 支援功能,該功能由給定 AudioFormat 的 和 AudioAttributes建立。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetMinBufferSize(Int32, ChannelOut, Encoding)

回傳在該 #MODE_STREAM 模式中建立 AudioTrack 物件所需的估計最小緩衝區大小。

GetNativeOutputSampleRate(Stream)

回傳指定串流類型的輸出取樣率(Hz)。

GetTimestamp(AudioTimestamp)

按需投票取得時間戳記。

IsDirectPlaybackSupported(AudioFormat, AudioAttributes)

回傳系統目前是否支援具有所提供屬性的音訊格式直接播放。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
Pause()

暫停音訊資料的播放。

Play()

開始播放 AudioTrack。

RegisterStreamEventCallback(IExecutor, AudioTrack+StreamEventCallback)

註冊回撥以通知串流事件。

Release()

釋出原生 AudioTrack 資源。

ReloadStaticData()

將靜態緩衝區內的播放頭位置設為零,也就是倒帶回到靜態緩衝區的起點。

RemoveOnCodecFormatChangedListener(AudioTrack+IOnCodecFormatChangedListener)

移除 OnCodecFormatChangedListener 先前新增的 ,以接收編解碼器格式變更事件。

RemoveOnRoutingChangedListener(AudioTrack+IOnRoutingChangedListener)
已淘汰.

移除 AudioRouting.OnRoutingChangedListener 先前新增的接收轉接通知的物件。

RemoveOnRoutingChangedListener(IAudioRoutingOnRoutingChangedListener)

移除 AudioRouting.OnRoutingChangedListener 先前新增的接收轉接通知的物件。

SetAudioDescriptionMixLeveldB(Single)

設定音訊描述的混音音量以分貝為單位。

SetAuxEffectSendLevel(Single)

將音訊軌道的傳送電平設定為附加的輔助效果 #attachAuxEffect(int)。

SetBufferSizeInFrames(Int32)

限制應用程式寫入的緩衝區有效大小 AudioTrack 。

SetDualMonoMode(Int32)

在輸出裝置上設定雙單聲道模式的呈現。

SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetLoopPoints(Int32, Int32, Int32)

設定迴圈點數和迴圈數量。

SetNotificationMarkerPosition(Int32)

設定通知標記的位置。

SetOffloadDelayPadding(Int32, Int32)

配置當前壓縮串流在卸載模式下的延遲與填充值。

SetOffloadEndOfStream()

宣告該軌道上最後一次寫入()操作提供了該串流的最後緩衝區。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
SetPlaybackHeadPosition(Int32)

設定播放頭在靜態緩衝區內的位置。

SetPlaybackPositionUpdateListener(AudioTrack+IOnPlaybackPositionUpdateListener, Handler)

設定聽者,AudioTrack 會在到達先前設定的標記或每次週期性播放頭位置更新時通知聽眾。

SetPlaybackPositionUpdateListener(AudioTrack+IOnPlaybackPositionUpdateListener)

設定聽者,AudioTrack 會在到達先前設定的標記或每次週期性播放頭位置更新時通知聽眾。

SetPlaybackRate(Int32)

設定這首曲目的播放取樣率。

SetPositionNotificationPeriod(Int32)

設定定期通知事件的週期。

SetPreferredDevice(AudioDeviceInfo)

指定一個音訊裝置(透過物件 AudioDeviceInfo )來路由此 AudioTrack 的輸出。

SetPresentation(AudioPresentation)

設定音訊呈現。

SetStartThresholdInFrames(Int32)

設定串流開始閾值。AudioTrack

SetState(Int32)
已淘汰.

設定實例的初始化狀態。

SetStereoVolume(Single, Single)
已淘汰.

在 AudioTrack 上設定指定的左、右輸出增益值。

SetVolume(Single)

設定該軌道所有通道的指定輸出增益值。

Stop()

音訊資料停止播放。

ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
UnregisterStreamEventCallback(AudioTrack+StreamEventCallback)

取消註冊先前註冊的 #registerStreamEventCallback(Executor, StreamEventCallback)回撥事件通知。

Wait()

導致目前執行緒等待被喚醒,通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。

(繼承來源 Object)
Wait(Int64, Int32)

會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。

(繼承來源 Object)
Wait(Int64)

會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。

(繼承來源 Object)
Write(Byte[], Int32, Int32, WriteMode)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

Write(Byte[], Int32, Int32)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

Write(ByteBuffer, Int32, WriteMode, Int64)

將音訊資料寫入音訊匯入,在串流模式下播放HW_AV_SYNC軌。

Write(ByteBuffer, Int32, WriteMode)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

Write(Int16[], Int32, Int32, WriteMode)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

Write(Int16[], Int32, Int32)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

Write(Single[], Int32, Int32, WriteMode)

將音訊資料寫入音訊匯流器以供播放(串流模式),或將音訊資料複製到後續播放(靜態緩衝模式)。

WriteAsync(Byte[], Int32, Int32, WriteMode)

啟動一個任務,呼叫位元組陣列以提供的寫入模式寫入。

WriteAsync(Byte[], Int32, Int32)

啟動一個任務,呼叫阻塞位元組陣列寫入。

WriteAsync(ByteBuffer, Int32, WriteMode, Int64)

啟動一個任務,呼叫帶有時間戳記的串流位元組緩衝區寫入。

WriteAsync(ByteBuffer, Int32, WriteMode)

啟動一個任務,呼叫位元組緩衝區寫入。

WriteAsync(Int16[], Int32, Int32, WriteMode)

啟動一項任務,呼叫 16 位元樣本陣列以提供的寫入模式寫入。

WriteAsync(Int16[], Int32, Int32)

啟動一項任務,呼叫阻塞性的 16 位元 樣本陣列寫入。

WriteAsync(Single[], Int32, Int32, WriteMode)

啟動一個任務,呼叫浮點樣本陣列寫入。

事件

名稱 Description
MarkerReached

當音軌報告其播放頭已達到設定的通知標記時。

PeriodicNotification

當軌道定期提供播放位置通知時,會發生這種情況。

RoutingChanged

當軌道發出音訊路線變更通知時,會發生這種情況。

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 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 端是否有效。

適用於