AudioTrack 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
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 類別負責管理並播放單一 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) |
類別構造器,且 。 |
| 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 |
已淘汰.
此模式表示不進行元資料封裝,這是透過 傳送音訊資料 |
| Error |
已淘汰.
表示通用操作失敗。 |
| ErrorBadValue |
已淘汰.
表示因使用無效值而失敗。 |
| ErrorDeadObject |
已淘汰.
錯誤代碼表示回報該物件已不再有效,需要重新建立。 |
| ErrorInvalidOperation |
已淘汰.
表示因方法使用不當而失敗。 |
| FlushFromAccuracyBestEffort |
已淘汰.
用來指示框架的準確度模式 |
| FlushFromAccuracyExact |
已淘汰.
指示 AudioTrack 的準確度模式 |
| FlushWrittenFramesSupported |
已淘汰.
支援恆定旗標值以表示 |
| Success |
已淘汰.
表示手術成功。 |
| SupplementaryAudioPlacementLeft |
已淘汰.
補充音訊放置位置。 |
| SupplementaryAudioPlacementNormal |
已淘汰.
補充音響放置正常。 |
| SupplementaryAudioPlacementRight |
已淘汰.
補充音訊位置,對。 |
屬性
| 名稱 | Description |
|---|---|
| AudioAttributes |
退還 |
| AudioDescriptionMixLeveldB |
回傳音訊描述的混音音量(dB)。 |
| AudioFormat |
回傳已設定的音訊資料編碼。 |
| AudioSessionId |
回傳音訊會話 ID。 |
| BufferCapacityInFrames |
回傳緩衝區的最大大小 |
| BufferSizeInFrames |
回傳應用程式寫入的緩衝區有效大小 |
| ChannelConfiguration |
回傳已設定的通道位置遮罩。 |
| ChannelCount |
回傳設定好的頻道數量。 |
| Class |
回傳此 |
| CodecProvenance |
回傳設定時指定編 |
| DualMonoMode |
回傳雙單聲道模式的呈現設定。 |
| Format |
會回傳已設定 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsOffloadedPlayback |
回傳該軌道是否被設定 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| LogSessionId |
傳回 |
| MaxVolume |
回傳最大增益值,該值大於或等於1.0。 |
| Metrics |
回傳關於目前 AudioTrack 實例的 Metrics 資料。 |
| MinVolume |
回傳最小增益值,即常數 0.0。 |
| NativeFrameCount |
已淘汰.
回傳原生 |
| NotificationMarkerPosition |
回傳標記位置以影格表示。 |
| OffloadDelay |
回傳已卸載軌道的解碼延遲,以影格表示,先前設定為 |
| OffloadPadding |
回傳已卸載軌道的解碼器填充,以幀表示,先前設定為 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| PerformanceMode |
回傳 的當前效能模式。 |
| PlaybackHeadPosition |
回傳以影格表示的播放頭位置。 |
| PlaybackParams |
回傳目前的播放參數。 -或- 設定播放參數。 |
| PlaybackRate |
回傳目前播放的取樣率以 Hz 為單位。 |
| PlayState |
回傳 AudioTrack 實例的播放狀態。 |
| PositionNotificationPeriod |
回傳以幀表示的通知更新期間。 |
| PreferredDevice |
回傳由 |
| RoutedDevice |
回傳並 |
| RoutedDevices |
回傳一份清單,識別 |
| SampleRate |
回傳設定好的音訊來源取樣率(Hz)。 |
| StartThresholdInFrames |
回傳串流開始閾值。 |
| State |
回傳 AudioTrack 實例的狀態。 |
| StreamType |
回傳此 AudioTrack 的音量串流類型。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| UnderrunCount |
回傳自 AudioTrack 建立以來,應用程式層寫緩衝區中欠載次數。 |
| WrittenFramesCount |
回傳寫入 的 Stream |
方法
事件
| 名稱 | Description |
|---|---|
| MarkerReached |
當音軌報告其播放頭已達到設定的通知標記時。 |
| PeriodicNotification |
當軌道定期提供播放位置通知時,會發生這種情況。 |
| RoutingChanged |
當軌道發出音訊路線變更通知時,會發生這種情況。 |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |