語言

AudioTrack.FlushWrittenFramesFromPosition(Int64, Int32) 方法

定義

從該位置清除所有資料。

[Android.Runtime.Register("flushWrittenFramesFromPosition", "(JI)J", "GetFlushWrittenFramesFromPosition_JIHandler", ApiSince=37)]
public virtual long FlushWrittenFramesFromPosition(long positionInFrames, int accuracy);
[<Android.Runtime.Register("flushWrittenFramesFromPosition", "(JI)J", "GetFlushWrittenFramesFromPosition_JIHandler", ApiSince=37)>]
abstract member FlushWrittenFramesFromPosition : int64 * int -> int64
override this.FlushWrittenFramesFromPosition : int64 * int -> int64

參數

positionInFrames
Int64

以框架計算的起點來沖洗。 值必須介於 0 與總寫入幀之間。

accuracy
Int32

沖洗時的精確度要求。 用 #FLUSH_FROM_ACCURACY_BEST_EFFORT 來表示盡量接近所要求位置的同花順。 用 #FLUSH_FROM_ACCURACY_EXACT 來表示必須從所要求的位置沖洗。

傳回

就是實際沖洗的姿勢。

屬性

備註

從該位置清除所有資料。

若此操作成功回傳,呼叫此方法後的 write(byte, int, int) 將從該方法回傳的框架位置寫入。 getWrittenFramesCount() 方法可用來尋找目前的幀位置。

此方法僅允許在卸載模式下(即以 Builder.setOffloadedPlayback(布林)設定為 true)建立的曲目)。 應用程式可以在資料播放時呼叫此函式來清除資料。

支援此方法取決於裝置的能力。 在建立 AudioTrack 之前,請呼叫 getFlushWrittenFramesFromPositionSupport(AudioFormat,AudioAttributes)查詢 AudioFormat 和 AudioAttributes 是否支援此方法。 如果 getFlushWrittenFramesFromPositionSupport(AudioFormat, AudioAttributes) 回傳 0,則會拋出 UnsupportedOperationException。

當客戶要求從某個位置沖洗時,音響系統會根據該位置、所要求的沖洗準確度以及能丟棄的數量,回傳實際沖洗的位置。 所有實際沖洗位置的資料都會被丟棄。 當串流被清除時,串流端點(若由 setOffloadEndOfStream())設定)會被重置。

用戶端在此函式回傳前不得寫入任何資料。 否則,資料可能會被損壞。 當方法成功返回且串流處於活動狀態時,若音訊資料不足,用戶端必須立即寫入資料,否則播放可能會未完。

Android 參考資料。android.media.AudioTrack.flushWrittenFramesFromPosition

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

適用於