{{tag>baladeur audio}}

----

====== Fichier « .is_audio_player » ======
===== Introduction =====

Les véritables capacités des « baladeurs multimédia » (formats supportés, dossiers devant contenir les fichiers musicaux...) ne peuvent, en général, être détectées de façon fiable.\\
C'est pour pallier ce problème que [[http://www.marcuscom.com/hal-spec/hal-spec.html#device-properties-portable_audio_player|la norme HAL]] implémente le fichier « ''.is_audio_player'' ».\\
Placé à la racine d'un volume, il vous permet de décrire les spécifications que vous souhaitez, aussi finement que nécessaire.

Si vous disposez d'un lecteur multimédia qui nécessite un fichier .is_audio_player, cela signifie qu'il n'est pas reconnu automatiquement par Ubuntu et qu'il s'agit d'un bug (i.e. que votre lecteur ne figure pas dans la liste des lecteurs détectés automatiquement). Afin que d'autres utilisateurs comme vous ne soient pas obligés de définir un tel fichier et que votre lecteur soit reconnu automatiquement dans les prochaines versions d'Ubuntu, merci de rapporter le bug en exécutant la commande : //ubuntu-bug media-player-info// ou, si vous le préférez en ajoutant un commentaire sur [[http://ernstfamily.ch/jonathan/2010/10/aidez-moi-a-faire-en-sorte-que-votre-lecteur-multimedia-ou-votre-telephone-soit-automatiquement-reconnu-comme-tel-sous-linux/|cet article]].

===== Cas typique (le plus simple) =====

Si vous souhaitez qu'un volume (une clef USB, un disque dur ou même un baladeur multimédia qui n'est pas reconnu comme tel) soit considéré comme un baladeur multimédia par des logiciels comme [[:Rhythmbox]], [[:Banshee]], [[:Amarok]] et bien d'autres, il vous suffit de créer un fichier « ''.is_audio_player'' » vide à sa racine.\\
Les paramètres par défaut seront alors utilisés, ceux-ci devraient convenir dans la plupart des cas.


===== Options les plus courantes =====

Voici un exemple pratique des propriétés que vous pouvez rajouter dans ce fichier ''.is_audio_player'' (chacune est expliquée plus en détail par la suite).
<note tip>Pour une liste exhaustive de toutes les propriétés disponibles, référez vous à [[http://www.marcuscom.com/hal-spec/hal-spec.html#device-properties-portable_audio_player|la norme HAL]]</note>


<code>
audio_folders=Musique/,Autre dossier/sous dossier
folder_depth=8
output_formats=audio/mpeg,application/ogg,audio/x-ms-wma
input_formats=audio/mpeg
</code>


==== Paramètre « audio_folders » ====

Liste l'ensemble des dossiers pouvant contenir de la musique. Les autres dossiers seront ignorés.
\\L'ordre est important, car les transferts de musique se feront vers le premier dossier de la liste.

En l'absence de ce paramètre, la musique est cherchée dans tout le volume et les transferts se font vers la racine.


==== Paramètre « folder_depth » ====

Indique le nombre de dossiers enfants dans lesquels des fichiers musicaux peuvent être trouvés : 
  * Ce paramètre est relatif au dossier contenant de la musique, tel que précisé dans //<audio_folders>// ;
  * Tout fichiers audio situé dans un dossier enfant supplémentaire ne sera pas vu ;
  * La valeur **0** indique qu'il n'y a pas de limite de profondeur de sous-dossiers.

Exemples :
  * Si le baladeur stocke toute la musique avec l'arborescence ///<audio_folders>/**<Artiste>/<Album>**//, utilisez le paramètre //folder_depth=2// ;
  * Pour une compilation des Beatles contenant deux disques avec l'arborescence ///<audio_folders>/**Beatles/Compilation/Disque1**//, avec le paramètre //folder_depth=2//, les fichiers audio situé dans //Disque1// ne seront pas vus.

Ce paramètre est également utilisé lors de l'importation de nouveaux morceaux :
  * //folder_depth=**0**// : place les fichiers à la racine du premier dossier indiqué dans //audio_folders// sous la forme \\ //<audio_folders>/**<artiste> - <album> - <n° de piste> - <nom du morceau>**// ;
  * //folder_depth=**1**// : place les fichiers dans un sous-dossier. Celui ci sera placé dans le premier indiqué dans //audio_folders// sous la forme \\ //<audio_folders>/**<artiste> - <album>/<n° de piste> - <nom du morceau>**// ;
  * //folder_depth=**2 et plus**// : place les fichiers dans deux sous-dossier. Ceux ci seront placés dans le premier indiqué dans //audio_folders// sous la forme \\ //<audio_folders>/**<artiste>/<album>/<n° de piste> - <nom du morceau>**//.

En l'absence de paramètres, //folder_depth=0// est utilisé par défaut.


==== Paramètre « output_formats » ====

Indique les formats supportés par le baladeur en type mime. Le premier type indiqué sera celui utilisé pour la conversion automatique lors de l'importation de nouveau morceaux.

Types mime les plus utilisés :
  * audio/mpeg (mp3) ;
  * application/ogg (ogg) ;
  * audio/x-ms-wma (wma).

En l'absence de ce paramètre, le logiciel utilisé pour l'importation utilisera le format spécifié dans ses préférences.


==== Paramètre « input_formats » ====

Indique les formats que peut enregistrer le baladeur avec le micro ou depuis une émission de radio.

Types mime plus utilisés :
  * audio/mpeg (mp3) ;
  * application/ogg (ogg) ;
  * audio/x-ms-wma (wma).

En l'absence de ce paramètre, il est considéré que le baladeur ne peut pas enregistrer d'audio.

===== Référence =====

  * [[http://www.marcuscom.com/hal-spec/hal-spec.html#device-properties-portable_audio_player|la norme HAL]]

----

//Contributeurs : [[utilisateurs:Percherie]], [[:utilisateurs:Malizor]]//