ListHelper.java

This code comes from an Android project that handles the extraction and management of audio and video streams, specifically for platforms like YouTube. Here is a detailed explanation of the main sections of the code:

Constants:

  1. AUDIO_FORMAT_EFFICIENCY_RANKING: A list of audio formats ranked by efficiency. The least efficient format is MP3 and the most efficient is WEBMA.
  2. HIGH_RESOLUTION_LIST: A set containing high video resolutions (1440p and 2160p).
  3. AUDIO_TRACK_TYPE_RANKING and AUDIO_TRACK_TYPE_RANKING_DESCRIPTIVE: These lists define the priority order of audio track types. The first list prioritizes DESCRIPTIVE > DUBBED > ORIGINAL. The second list reverses this order if descriptive audio is preferred.

Supported ITAG identifiers:

  • SUPPORTED_ITAG_IDS: A list of integers representing the ITAG identifiers (YouTube) supported for different video and audio formats (like MP3, M4A, WEBMA, etc.).

Methods:

  • getDefaultAudioFormat: Returns the default audio format by comparing audio streams according to a given ranking. It uses a comparator to compare formats and other stream properties.
  • getDefaultAudioTrackGroup: Groups audio streams based on context and returns the group with the highest-ranked audio track.
  • getAudioFormatIndex: Returns the index of the preferred audio format from a list of audio streams, based on a track identifier or the default format.
  • getStreamsOfSpecifiedDelivery: Filters streams by delivery method (for example, streaming or download) and returns the filtered list.
  • getUrlAndNonTorrentStreams: Filters the stream list, keeping only those with a URL, removing torrent-based streams.
  • getPlayableStreams: Filters streams to keep only those playable by the player, excluding unsupported formats and torrent streams.
  • getFilteredAudioStreams: Filters a list of audio streams and prioritizes those preferred based on track type, language, and format.
  • getGroupedAudioStreams: Groups audio streams by track identifier and sorts them by name and quality.
  • getFilteredStreamList: A helper function that filters a list of streams based on a given predicate.
  • computeDefaultResolution: Calculates and retrieves the preferred resolution for video playback based on user settings and available resolutions.
  • getAudioIndexByHighestRank: Finds the index of the highest-ranked audio stream using a comparator.
  • getAudioFormatComparator: Creates a comparator to compare audio streams by format, bitrate, and user preferences.
  • getAudioTrackComparator: Generates a comparator that sorts audio streams based on track preferences, such as language, type (original, dubbed, or descriptive), and user settings.
  • getAudioTrackNameComparator: A comparator that sorts audio streams by track name and language.

Key concepts:

  • Comparator: A comparison mechanism used to rank or sort audio and video streams based on various criteria such as format, quality, and user preferences.
  • SharedPreferences: Used to store and retrieve user settings, such as preferred audio or video format, language, and resolution.
  • Stream and AudioStream: These classes represent multimedia streams (audio or video) managed by the code.
  • Locale: Represents the user's language or regional settings, influencing track sorting and selection.

Summary:

This code provides methods for filtering, sorting, and managing audio and video streams. It focuses primarily on user preferences (such as preferred language, audio track type, and format) to determine the best streams for playback. By using comparators and preference settings, it ensures the user gets the most suitable audio or video stream, whether they prefer a specific format, high efficiency, or descriptive audio.

Ce code provient d'un projet Android qui gère l'extraction et la gestion des flux audio et vidéo, spécifiquement pour des plateformes comme YouTube. Voici une explication détaillée des principales sections du code :

Constantes :

  1. AUDIO_FORMAT_EFFICIENCY_RANKING : Une liste de formats audio classés par ordre d'efficacité. Le format le moins efficace est MP3 et le plus efficace est WEBMA.
  2. HIGH_RESOLUTION_LIST : Un ensemble qui contient les résolutions vidéo élevées (1440p et 2160p).
  3. AUDIO_TRACK_TYPE_RANKING et AUDIO_TRACK_TYPE_RANKING_DESCRIPTIVE : Ces listes définissent l'ordre de priorité des types de pistes audio. La première liste priorise DESCRIPTIVE > DUBBED > ORIGINAL. La deuxième liste inverse cet ordre si l'audio descriptif est préféré.

Identifiants ITAG pris en charge :

  • SUPPORTED_ITAG_IDS : Une liste d'entiers représentant les identifiants ITAG (YouTube) pris en charge pour différents formats vidéo et audio (comme MP3, M4A, WEBMA, etc.).

Méthodes :

  • getDefaultAudioFormat : Retourne le format audio par défaut en comparant les flux audio selon un classement donné. Il utilise un comparateur pour comparer les formats et autres propriétés des flux.
  • getDefaultAudioTrackGroup : Regroupe les flux audio en fonction du contexte et retourne le groupe ayant la piste audio la mieux classée.
  • getAudioFormatIndex : Retourne l'index du format audio préféré à partir d'une liste de flux audio, en fonction d'un identifiant de piste ou du format par défaut.
  • getStreamsOfSpecifiedDelivery : Filtre les flux par méthode de livraison (par exemple, streaming ou téléchargement) et retourne la liste filtrée.
  • getUrlAndNonTorrentStreams : Filtre la liste de flux en ne conservant que ceux qui ont une URL, en supprimant les flux basés sur torrent.
  • getPlayableStreams : Filtre les flux pour ne conserver que ceux qui sont jouables par le lecteur, en excluant les formats non pris en charge et les flux torrent.
  • getFilteredAudioStreams : Filtre une liste de flux audio et privilégie ceux qui sont préférés en fonction du type de piste, de la langue et du format.
  • getGroupedAudioStreams : Regroupe les flux audio par identifiant de piste et les trie par nom et qualité.
  • getFilteredStreamList : Fonction auxiliaire qui filtre une liste de flux en fonction d'un prédicat donné.
  • computeDefaultResolution : Calcule et récupère la résolution préférée pour la lecture vidéo en fonction des paramètres utilisateur et des résolutions disponibles.
  • getAudioIndexByHighestRank : Trouve l'index du flux audio le mieux classé en fonction d'un comparateur.
  • getAudioFormatComparator : Crée un comparateur pour comparer les flux audio par format, débit binaire et préférences utilisateur.
  • getAudioTrackComparator : Génère un comparateur qui trie les flux audio en fonction des préférences de piste, telles que la langue, le type (original, doublé ou descriptif), et les paramètres utilisateur.
  • getAudioTrackNameComparator : Un comparateur qui trie les flux audio en fonction du nom de la piste et de la langue.

Concepts clés :

  • Comparator : Un mécanisme de comparaison utilisé pour classer ou trier les flux audio et vidéo en fonction de divers critères tels que le format, la qualité et les préférences utilisateur.
  • SharedPreferences : Utilisé pour stocker et récupérer les paramètres de l'utilisateur, tels que le format audio ou vidéo préféré, la langue et la résolution.
  • Stream et AudioStream : Ces classes représentent les flux multimédias (audio ou vidéo) que le code gère.
  • Locale : Représente la langue ou les paramètres régionaux de l'utilisateur, ce qui influence le tri et la sélection des pistes.

Résumé :

Ce code fournit des méthodes pour filtrer, trier et gérer les flux audio et vidéo. Il se concentre principalement sur les préférences de l'utilisateur (comme la langue préférée, le type de piste audio et le format) afin de déterminer les meilleurs flux pour la lecture. En utilisant des comparateurs et des paramètres de préférences, il garantit que l'utilisateur obtient le flux audio ou vidéo le plus adapté, qu'il préfère un format spécifique, une grande efficacité ou un audio descriptif.