Per impostazione predefinita, ExoPlayer registra solo gli errori. Per registrare gli eventi del player, è possibile
utilizzare la classe EventLogger. Il logging aggiuntivo fornito può essere utile per capire cosa sta facendo il player e per eseguire il debug dei problemi di riproduzione. EventLogger implementa AnalyticsListener, quindi registrare un'istanza
con un ExoPlayer è facile:
Kotlin
player.addAnalyticsListener(EventLogger())
Java
player.addAnalyticsListener(new EventLogger());
Il modo più semplice per osservare il log è utilizzare la scheda logcat di Android Studio. Puoi selezionare l'app come processo di cui è possibile eseguire il debug in base al nome del pacchetto (androidx.media3.demo.main se utilizzi l'app demo) e indicare alla scheda logcat di registrare solo per quell'app selezionando Mostra solo l'applicazione selezionata. È
possibile filtrare ulteriormente il logging con l'espressione
EventLogger|ExoPlayerImpl, in modo da ottenere il logging solo da EventLogger e dal
player stesso.
Un'alternativa all'utilizzo della scheda logcat di Android Studio è utilizzare la console. Ad esempio:
adb logcat EventLogger:* ExoPlayerImpl:* *:s
Informazioni sul giocatore
La classe ExoPlayerImpl fornisce due righe importanti sulla versione del player, sul dispositivo e sul sistema operativo su cui è in esecuzione l'app e sui moduli di ExoPlayer che sono stati caricati:
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]
Stato di riproduzione
Le modifiche allo stato del player vengono registrate in righe come queste:
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]
In questo esempio, la riproduzione inizia 0,93 secondi dopo la preparazione del player. L'utente mette in pausa la riproduzione dopo 9,4 secondi e la riprende un secondo dopo a 10,4 secondi. La riproduzione termina dieci secondi dopo a 20,4 secondi. Gli elementi comuni tra parentesi quadre sono:
[eventTime=float]: il tempo effettivo trascorso dalla creazione del player.[mediaPos=float]: la posizione di riproduzione corrente.[window=int]: l'indice della finestra corrente.[period=int]: il periodo corrente nella finestra.
Gli elementi finali di ogni riga indicano il valore dello stato segnalato.
Tracce multimediali
Le informazioni sulle tracce vengono registrate quando i brani disponibili o selezionati cambiano. Questo si verifica almeno una volta all'inizio della riproduzione. L'esempio seguente mostra il logging delle tracce per uno stream adattivo:
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: ]
In questo esempio, il player ha selezionato quattro delle cinque tracce video disponibili. La quinta traccia video non è stata selezionata perché supera le
capacità del dispositivo, come indicato da supported=NO_EXCEEDS_CAPABILITIES.
Il player si adatterà alle tracce video selezionate durante la riproduzione. Quando il player si adatta da una traccia all'altra, viene registrato in una riga come quella riportata di seguito:
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]
Questa riga di log indica che il player è passato alla traccia video con risoluzione 640 x 360 dopo tre secondi di riproduzione dei contenuti multimediali.
Selezione decoder
Nella maggior parte dei casi, ExoPlayer esegue il rendering dei contenuti multimediali utilizzando un elemento MediaCodec acquisito dalla
piattaforma sottostante. Quando un decoder viene inizializzato, viene registrato in righe come queste:
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]