語言

AudioTrack.GetTimestamp(AudioTimestamp) 方法

定義

按需投票取得時間戳記。

[Android.Runtime.Register("getTimestamp", "(Landroid/media/AudioTimestamp;)Z", "GetGetTimestamp_Landroid_media_AudioTimestamp_Handler")]
public virtual bool GetTimestamp(Android.Media.AudioTimestamp? timestamp);
[<Android.Runtime.Register("getTimestamp", "(Landroid/media/AudioTimestamp;)Z", "GetGetTimestamp_Landroid_media_AudioTimestamp_Handler")>]
abstract member GetTimestamp : Android.Media.AudioTimestamp -> bool
override this.GetTimestamp : Android.Media.AudioTimestamp -> bool

參數

timestamp
AudioTimestamp

指的是呼叫者所分配並擁有的非空 AudioTimestamp 實例。

傳回

若有時間戳記,則為 true;若無時間戳記,則為 false。 若有時間戳記可用,AudioTimestamp 實例會以幀單位為單位填入位置,並附上該幀呈現或承諾呈現的估計時間。 若無時間戳記,任何提供的實例均保持不變。 在音訊時鐘穩定期間,或在路線變更期間及之後,時間戳記可能會暫時無法使用。 若路由不支援時間戳,該路由將永久無法使用時間戳記。 在這種情況下,近似的框架位置可以用 得到 #getPlaybackHeadPosition。 不過,偶爾繼續查詢時間戳記,以便在路徑變更後恢復,可能會很有用。

屬性

備註

按需投票取得時間戳記。

如果你需要在初次預熱或路由或模式切換後追蹤時間戳,應定期申請新時間戳,直到報告的時間戳顯示幀位正在前進,或直到確定該路線時間戳無法使用為止。

當時鐘以穩定速率前進後,大約每 10 秒到每分鐘查詢一次新的時間戳。 頻繁呼叫此方法效率較低。 而且,呼叫此方法的頻率高於建議,反而適得其反,因為連續時間戳報告間的短期差異並不具意義。 如果你需要高解析度的幀位置與呈現時間對應,可以考慮在應用程式層級實作,基於低解析度時間戳記。

回傳位置的音訊資料可能已經呈現,或尚未呈現但已承諾將呈現。 無法請求對應特定局面的時間,或請求對應特定時間的(分數)局面。 如果你需要這些功能,可以考慮在應用程式層級實作。

Java 文件 android.media.AudioTrack.getTimestamp(android.media.AudioTimestamp)。

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

適用於