Ajouter un utilisateur pour l'AudioEngine

Un article de XMIX.

Accueil → Documentation → Tutoriels → [ Ajouter un utilisateur pour l'AudioEngine ]

L'AudioEngine est le moteur qui assure la lecture des différents média sur la/les cartes audios disponnible(s) sur votre système. Pour configurer les accès à la (aux) carte(s) audio, le moteur utilise un fichier de configuration xmAudioEngine.xml. Dans ce fichier il est possible de définir un ou plusieurs utilisateurs qui pourront avoir des configurations différentes (comme les drivers utilisées, les cartes utilisées et les options de mixage, etc...) L'interface de configuration vous permet de positionner toute ces options. Par defaut nous avons un utilisateur pour le player en lui même, qui ne nécessite pas d'être déclaré. Si vous désirez réaliser votre propre configuration sous un utilisateur spécifique, il est nécessaire d'éditer le fichier pour ajouter un utilisateur. Ensuite vous pourrez utiliser l'interface de configuration afin de positionner vos options.

Description du fichier de config

Voici le fichier de configuration de l'AudioEngine par défaut (peut varier en fonction de votre config) :

 <?xml version="1.0" standalone="yes"?>
 <xmRoot>
     <xmUsers name="main">
         <xmUser name="player" pwd="****">
             <xmAudioGroup name="AG1" active="true" Driver="fmod" Mute="false">
                 <xmBassDriver name="bass" Interface="1">
                     <xmProperty name="MixRate" value="44100"/>
                     <xmProperty name="ModOption" value="10752"/>
                     <xmProperty name="HiPosRes" value="false"/>
                 </xmBassDriver>
                 <xmFModDriver name="fmod" Interface="1">
                     <xmProperty name="MixRate" value="44100"/>
                     <xmProperty name="NbSWChannel" value="128"/>
                     <xmProperty name="HiPosRes" value="false"/>
                 </xmFModDriver>
                 <xmProperty name="Volume" value="255"/>
                 <xmProperty name="Mute" value="false"/>
             </xmAudioGroup>
         </xmUser>
     </xmUsers>
 </xmRoot>

Ce fichier est de type xml ;-) ! et voici les principales balises :

 <xmRoot/>       : Racine du fichier
 <xmUsers/>      : Liste des utilisateurs déclarer dans l'AudioEngine
 <xmUser/>       : Défintion d'un utilisateur
 <xmAudioGroup/> : Définition d'un AudioGroup
 <xmBassDriver/> : Définition des paramètre de configuration du la DLL d'interface BASS
 <xmFModDriver/> : Définition des paramètre de configuration du la DLL d'interface FMod

Chaque élement xml possède deux types d'information :

• Les attribut ( name="", Interface="" etc..)
• Les propriétés (qui sont des sous-élements délimité par les balise <xmProperty/>

Nous avons choisi que chaque élément possède au moins un attribut name qui correspond au nom qui sera utilisé pour y accéder dans le langage ou aux travers des interfaces. C'est important qu'il ne contienne pas d'accent, d'espace ou de caractères spéciaux. D'une manière générale les attributs sont des informations obligatoires pour l'objet (l'élément) considéré, par contre les propriétés sont optionnelles.

Ajouter un utilisateur

Pour ajouter un utilisateur il faut ajouter un élément <xmUser/> sous l'élément <xmUsers/>. Ci dessous nous ajoutons l'utilisateur User1 au fichier de config décrit précédemantement :

 <?xml version="1.0" standalone="yes"?>
 <xmRoot>
     <xmUsers name="main">
         <xmUser name="player" pwd="****">
             <xmAudioGroup name="AG1" active="true" Driver="fmod" Mute="false">
                 <xmBassDriver name="bass" Interface="1">
                     <xmProperty name="MixRate" value="44100"/>
                     <xmProperty name="ModOption" value="10752"/>
                     <xmProperty name="HiPosRes" value="false"/>
                 </xmBassDriver>
                 <xmFModDriver name="fmod" Interface="1">
                     <xmProperty name="MixRate" value="44100"/>
                     <xmProperty name="NbSWChannel" value="128"/>
                     <xmProperty name="HiPosRes" value="false"/>
                 </xmFModDriver>
                 <xmProperty name="Volume" value="255"/>
                 <xmProperty name="Mute" value="false"/>
             </xmAudioGroup>
         </xmUser>
         <xmUser name="User1" pwd="monpasswd">
         </xmUser>
     </xmUsers>
 </xmRoot>

A noter que le mot de passe de l'utilisateur doit être préciser en claire ;-), sera probablement amélioré dans les futurs versions.

Modifier la config d'un utilisateur

Une fois le fichier de config modifié, lancer le XMIX puis allez dans le fenêtre de configuration,

Selectionnez Utilisateur dans la partie "Session", puis saisissez le login/password, enfin appuyez sur le bouton "Login"

Vous pouvez ajouter un AudioGroup en cliquant sur le bouton "Ajouter"

Vous pouvez maintenant choisir vos paramètres de pour l'AudioGroup que vous venez de créer. Une que vous avez valider en cliqaunt sur le bouton "Ok", le fichier de config sera mis à jour comme ci-dessous (à vos préférences près...)

  <?xml version="1.0" standalone="yes"?>
  <xmRoot>
      <xmUsers name="main">
          <xmUser name="player" pwd="****">
              <xmAudioGroup name="AG1" active="true" Driver="bass" Mute="false">
                  <xmBassDriver name="bass" Interface="1">
                      <xmProperty name="MixRate" value="44100"/>
                      <xmProperty name="ModOption" value="0"/>
                      <xmProperty name="HiPosRes" value="false"/>
                  </xmBassDriver>
                  <xmFModDriver name="fmod" Interface="1">
                      <xmProperty name="MixRate" value="44100"/>
                      <xmProperty name="NbSWChannel" value="128"/>
                      <xmProperty name="HiPosRes" value="false"/>
                  </xmFModDriver>
                  <xmProperty name="Volume" value="255"/>
                  <xmProperty name="Mute" value="false"/>
              </xmAudioGroup>
          </xmUser>
          <xmUser name="User1" pwd="monpasswd">
              <xmAudioGroup name="MonAG" Active="true" Driver="fmod">
                  <xmProperty name="Volume" value="176"/>
                  <xmProperty name="Mute" value="false"/>
                  <xmFModDriver name="fmod" Interface="1">
                         <xmProperty name="MixRate" value="44100"/>
                      <xmProperty name="HiPosRes" value="false"/>
                      <xmProperty name="NbSWChannel" value="128"/>
                  </xmFModDriver>
              </xmAudioGroup>
          </xmUser>
      </xmUsers>
  </xmRoot>

← Revenir