Domyślnie ExoPlayer rejestruje tylko błędy. Do rejestrowania zdarzeń odtwarzacza można użyć klasy EventLogger
. Dodatkowe logowanie, jakie oferuje odtwarzacz, może pomóc w zrozumieniu działania odtwarzacza oraz do debugowania problemów z odtwarzaniem. EventLogger
implementuje AnalyticsListener
, więc zarejestrowanie instancji za pomocą ExoPlayer
jest łatwe:
Kotlin
player.addAnalyticsListener(EventLogger())
Java
player.addAnalyticsListener(new EventLogger());
Najłatwiejszym sposobem obserwowania dziennika jest użycie karty logcat w Android Studio. Swoją aplikację jako proces z możliwością debugowania możesz wybrać na podstawie nazwy pakietu (androidx.media3.demo.main
, jeśli korzystasz z aplikacji demonstracyjnej), a następnie zezwolić karcie logcat na logowanie się tylko dla tej aplikacji. Aby to zrobić, wybierz pokaż tylko wybraną aplikację. Można dodatkowo filtrować logowanie za pomocą wyrażenia EventLogger|ExoPlayerImpl
, aby uzyskiwać logowanie tylko z platformy EventLogger
i z samego odtwarzacza.
Zamiast karty Logcat w Android Studio możesz użyć konsoli. Przykład:
adb logcat EventLogger:* ExoPlayerImpl:* *:s
Informacje o odtwarzaczu
Klasa ExoPlayerImpl
zawiera 2 ważne informacje o wersji odtwarzacza, urządzeniu i systemie operacyjnym, na którym działa aplikacja, oraz o załadowanych modułach 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]
Stan odtwarzania
Zmiany stanu gracza są zapisywane w tych wierszach:
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]
W tym przykładzie odtwarzanie rozpoczyna się 0,93 sekundy po przygotowaniu odtwarzacza. Użytkownik wstrzymuje odtwarzanie po 9,4 sekundy i wznawia odtwarzanie jeszcze jedną sekundę po upływie 10,4 sekundy. Odtwarzanie kończy się 10 sekund później w 20,4 sekundy. Typowe elementy w nawiasach kwadratowych to:
[eventTime=float]
: czas od utworzenia gracza.[mediaPos=float]
: bieżąca pozycja odtwarzania.[window=int]
: indeks bieżącego okna.[period=int]
: bieżący okres w tym oknie.
Ostatnie elementy w każdym wierszu wskazują wartość stanu, którego dotyczy raport.
Ścieżki audio
Informacje o utworach są rejestrowane po zmianie dostępnych lub wybranych ścieżek. co najmniej raz na początku odtwarzania. Przykład poniżej pokazuje rejestrowanie ścieżki w przypadku strumienia adaptacyjnego:
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: ]
W tym przykładzie odtwarzacz wybrał cztery z pięciu dostępnych
ścieżek wideo. Piąta ścieżka wideo nie została wybrana, ponieważ przekracza możliwości urządzenia, co wskazuje supported=NO_EXCEEDS_CAPABILITIES
.
Podczas odtwarzania odtwarzacz dostosowuje się do wybranych ścieżek wideo. Gdy odtwarzacz dostosowuje się do innej ścieżki, jest rejestrowany w wierszu, który wygląda tak jak poniżej:
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]
Ten wiersz logu wskazuje, że odtwarzacz przełączył się na ścieżkę wideo w rozdzielczości 640 x 360, przechodząc do odtwarzania multimediów przez 3 sekundy.
Wybór dekodera
W większości przypadków ExoPlayer renderuje multimedia przy użyciu tagu MediaCodec
pobranego z platformy, która bazuje na tej platformie. Po zainicjowaniu dekodera są to rejestrowane w wierszach w ten sposób:
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]