PlayQueueActivity.java

Method onCreateOptionsMenu:

• This method is called during the creation of the activity's options menu (e.g., during a long press or menu button press in the interface).
• It loads two menus via getMenuInflater().inflate() and calls the buildAudioTrackMenu() method, which specifically handles the construction of the menu related to the available audio tracks.

Managing Audio Track Selection:

• When the user selects an item from the menu (via onAudioTrackClick), the code checks if the group of the item is associated with the identifier MENU_ID_AUDIO_TRACK. If so, the onAudioTrackClick method is executed.
• This method takes the index of the selected item as a parameter, then checks if this change should be applied by comparing the selected item with the current audio track.

Method onAudioTrackUpdate:

• This method is used to update the audio track menu. It calls buildAudioTrackMenu() on each update to regenerate the display of the available options.

Building the Audio Track Menu (buildAudioTrackMenu):

• If menu is null, the method does nothing.
• It looks for an item in the menu (audioTrackSelector) and attempts to retrieve the list of available audio streams (availableStreams) from the current playback metadata.
• If multiple audio tracks are available and one is selected, it updates the title and subtitle of the menu item to reflect the selected audio.
• If no audio tracks are available, the menu item is hidden.

Interaction with the Media Player:

• When an audio track item is selected, the onAudioTrackClick method is called to change the active audio track in the player based on the selected index. It checks that the selected item is valid (in terms of index and availability) and updates the corresponding audio track in the player.

Méthode onCreateOptionsMenu :

• Cette méthode est appelée lors de la création du menu d'options de l'activité (par exemple, lors d'un appui long ou d'un bouton de menu dans l'interface).
• Elle charge deux menus via getMenuInflater().inflate() et appelle la méthode buildAudioTrackMenu(), qui gère spécifiquement la construction du menu lié aux pistes audio disponibles.

Gestion de la sélection des pistes audio :

• Lorsque l'utilisateur sélectionne un élément dans le menu (via onAudioTrackClick), le code vérifie si le groupe de l'élément est associé à l'identifiant MENU_ID_AUDIO_TRACK. Si c'est le cas, la méthode onAudioTrackClick est exécutée.
• Cette méthode prend en paramètre l'index de l'élément sélectionné, puis vérifie si ce changement doit être appliqué en comparant l'élément sélectionné avec la piste audio actuelle.

Méthode onAudioTrackUpdate :

• Cette méthode est utilisée pour mettre à jour le menu des pistes audio. Elle appelle buildAudioTrackMenu() à chaque mise à jour pour régénérer l'affichage des options disponibles.

Construction du menu des pistes audio (buildAudioTrackMenu) :

• Si menu est nul, la méthode ne fait rien.
• Elle recherche un élément du menu (audioTrackSelector) et tente de récupérer la liste des flux audio disponibles (availableStreams) à partir des métadonnées de la lecture actuelle.
• Si plusieurs pistes audio sont disponibles et que l'une est sélectionnée, elle met à jour le titre et le sous-titre de l'élément du menu pour refléter l'audio sélectionné.
• Si aucune piste audio n'est disponible, l'élément du menu est masqué.

Interaction avec le lecteur multimédia :

• Lorsqu'un élément de piste audio est sélectionné, la méthode onAudioTrackClick est appelée pour changer la piste audio active dans le lecteur en fonction de l'index sélectionné. Elle vérifie que l'élément sélectionné est valide (en termes d'index et de disponibilité) et met à jour la piste audio correspondante dans le lecteur.