根據預設,ExoPlayer 只會記錄錯誤。如要記錄玩家事件,您可以使用 EventLogger
類別。額外的記錄有助於瞭解玩家的行為,以及對播放問題進行偵錯。EventLogger
會實作 AnalyticsListener
,因此用 ExoPlayer
註冊例項十分簡單:
Kotlin
player.addAnalyticsListener(EventLogger())
Java
player.addAnalyticsListener(new EventLogger());
觀察記錄最簡單的方法是使用 Android Studio 的 logcat 分頁。您可以依照套件名稱 (若使用試用版應用程式,則為 androidx.media3.demo.main
) 選取應用程式為可進行偵錯的程序,並選取「Show only selected application」讓 Logcat 分頁只記錄該應用程式。您可以使用運算式 EventLogger|ExoPlayerImpl
進一步篩選記錄,只取得 EventLogger
和玩家本身的記錄。
除了使用 Android Studio 的 Logcat 分頁之外,您也可以使用主控台。例如:
adb logcat EventLogger:* ExoPlayerImpl:* *:s
玩家資訊
ExoPlayerImpl
類別提供兩行重要的玩家版本、執行應用程式的裝置和 OS,以及已載入 ExoPlayer 的模組:
ExoPlayerImpl: Init 59a18ab [AndroidXMedia3/1.0.0-rc02] [flame, Pixel 4, Google, 33]
ExoPlayerImpl: Release 59a18ab [AndroidXMedia3/1.0.0-rc02] [flame, Pixel 4, Google, 33] [media3.common, media3.datasource, media3.ui, media3.exoplayer, media3.decoder, media3.exoplayer.dash, media3.extractor]
播放狀態
系統會記錄播放器狀態變更,如下所示:
EventLogger: playWhenReady [eventTime=0.00, mediaPos=0.00, window=0, true, USER_REQUEST]
EventLogger: state [eventTime=0.01, mediaPos=0.00, window=0, BUFFERING]
EventLogger: state [eventTime=0.93, mediaPos=0.00, window=0, period=0, READY]
EventLogger: isPlaying [eventTime=0.93, mediaPos=0.00, window=0, period=0, true]
EventLogger: playWhenReady [eventTime=9.40, mediaPos=8.40, window=0, period=0, false, USER_REQUEST]
EventLogger: isPlaying [eventTime=9.40, mediaPos=8.40, window=0, period=0, false]
EventLogger: playWhenReady [eventTime=10.40, mediaPos=8.40, window=0, period=0, true, USER_REQUEST]
EventLogger: isPlaying [eventTime=10.40, mediaPos=8.40, window=0, period=0, true]
EventLogger: state [eventTime=20.40, mediaPos=18.40, window=0, period=0, ENDED]
EventLogger: isPlaying [eventTime=20.40, mediaPos=18.40, window=0, period=0, false]
在此範例中,播放器準備完成後,開始播放 0.93 秒。使用者會在 9.4 秒後暫停播放,並在 10.4 秒後恢復播放。播放時間從 20.4 秒後結束。方括號內的常用元素如下:
[eventTime=float]
:玩家建立後至今的時鐘時間。[mediaPos=float]
:目前的播放位置。[window=int]
:目前視窗索引。[period=int]
:該時間範圍內的目前週期。
每一行中的最後一個元素代表所回報狀態的值。
媒體曲目
當可用或所選測試群組有所變更時,系統會記錄曲目資訊。這項功能在開始播放時至少會發生一次。以下範例顯示自動調整串流的追蹤記錄記錄:
EventLogger: tracks [eventTime=0.30, mediaPos=0.00, window=0, period=0,
EventLogger: group [
EventLogger: [X] Track:0, id=133, mimeType=video/avc, bitrate=261112, codecs=avc1.4d4015, res=426x240, fps=30.0, supported=YES
EventLogger: [X] Track:1, id=134, mimeType=video/avc, bitrate=671331, codecs=avc1.4d401e, res=640x360, fps=30.0, supported=YES
EventLogger: [X] Track:2, id=135, mimeType=video/avc, bitrate=1204535, codecs=avc1.4d401f, res=854x480, fps=30.0, supported=YES
EventLogger: [X] Track:3, id=160, mimeType=video/avc, bitrate=112329, codecs=avc1.4d400c, res=256x144, fps=30.0, supported=YES
EventLogger: [ ] Track:4, id=136, mimeType=video/avc, bitrate=2400538, codecs=avc1.4d401f, res=1280x720, fps=30.0, supported=NO_EXCEEDS_CAPABILITIES
EventLogger: ]
EventLogger: group [
EventLogger: [ ] Track:0, id=139, mimeType=audio/mp4a-latm, bitrate=48582, codecs=mp4a.40.5, channels=2, sample_rate=22050, supported=YES
EventLogger: [X] Track:1, id=140, mimeType=audio/mp4a-latm, bitrate=127868, codecs=mp4a.40.2, channels=2, sample_rate=44100, supported=YES
EventLogger: ]
EventLogger: ]
在這個範例中,玩家從五個可用的視訊軌中選取了四個。第五個視訊軌未選取,因為其超過裝置功能,如 supported=NO_EXCEEDS_CAPABILITIES
所示。播放器會在播放期間調整所選視訊軌。當玩家在不同音軌之間調整時,系統會登入與下方類似的一行:
EventLogger: downstreamFormat [eventTime=3.64, mediaPos=3.00, window=0, period=0, id=134, mimeType=video/avc, bitrate=671331, codecs=avc1.4d401e, res=640x360, fps=30.0]
此記錄行表示玩家已切換到 640x360 解析度的影片軌道進入媒體三秒。
選取解碼器
在大多數情況下,ExoPlayer 會使用從基礎平台取得的 MediaCodec
算繪媒體。解碼器初始化時,此動作會記錄在下列行:
EventLogger: videoDecoderInitialized [0.77, 0.00, window=0, period=0, video, OMX.qcom.video.decoder.avc]
EventLogger: audioDecoderInitialized [0.79, 0.00, window=0, period=0, audio, OMX.google.aac.decoder]