EIP 2012 Projet Livepad. Documentation technique 1.5

Transcription

1 EIP 2012 Projet Livepad 1.5 Marc Mathieu Benjamin Netter David Ngo Pierre Pasteau Denis Togbe

2 Informations sur le projet Groupe Nom du projet Type de document Marc Mathieu Benjamin Netter David Ngo Pierre Pasteau DenisTogbe Livepad Version 1.5 Référence Statut du document LIVEPAD-TD-1.5 À valider Rédaction et modification Historique des révisions du document Version Date Nom Description /03/2011 Groupe Livepad Initialisation du document /05/2011 Groupe Livepad Refonte de la mise en page /05/2011 Groupe Livepad Correction orthographe /07/2011 Denis Togbe Mise à jour des architectures /12/2011 Denis Togbe Ajout de schéma /01/2012 Denis Togbe Finalisation du document EIP

3 Résumé L'application Livepad pour ipad permet de jouer et de mixer de la musique à l'aide des instruments suivants : Platines et table de mixage. Boite à rythmes. Synthétiseur. Afin de contribuer au projet il est nécessaire de possèder les outils suivant : Un ordinateur Apple équipé de Mac OS X Lion 10.7 ou supérieur. Une tablette Apple ipad. Xcode 4. ios SDK 5. Ainsi que des connaissances en langage Objective-C, bibliothèque OpenGL, UIKit et Cocoa Touch. L'application s'architecture autour de la structure MVC (Modèle Vue Contrôleur). À chaque vue est associé un contrôleur (selon la nomenclature «nom de la vue» + «Controller») afin de récupérer les événements (interaction avec l'écran) et effectuer différentes actions en fonction du type d'événement. Des éléments graphiques personnalisés ont du être créés à l'aide d'uikit et OpenGL. Le traitement du son se fait avec la librairie FMOD. EIP

4 Table des matières 1.Le projet Environnement de travail Matériel Logiciels Technologies utilisées Langages Librairies Structure du projet Architecture MVC Structure des différents composants Éléments graphiques basiques LPKnob LPJog LPCrossfader LPSlider Éléments graphiques évolués Visualisation du spectre sonore Traitement audio Sélection d'une chanson Lecture d'une chanson Représentation du son Jeux de tests Tests fonctionnel Test de robustesse Glossaire EIP

5 1. Le projet L'application Livepad pour ipad permet de jouer et de mixer de la musique à la manière des plus grands DJs. Plusieurs instruments sont proposés : Les platines, avec lesquels il est possible de lancer de la musique depuis sa propre librairie musicale, et la table de mixage, qui permet d'appliquer différents effets sonores sur les musiques en cours de lecture. La boite à rythme, permettant de jouer des samples en direct à la manière des plus grands beatmakers. Le synthétiseur, véritable piano virtuel. Il est possible en plus de régler différentes options propre à l'application. EIP

6 2. Environnement de travail 2.1. Matériel Le matériel nécessaire au développement de l'application est au minimum : Un ordinateur Apple équipé de Mac OS X Lion 10.7 ou supérieur. Une tablette Apple ipad Logiciels Afin de participer au développement de la version ipad de l'application Livepad il est nécessaire de s'équiper d'une licence de développement Apple (permettant de compiler et exécuter le projet sur la tablette) et du SDK ios. Toutes les étapes permettant de créer un compte et récupérer le SDK sont décrites sur le ios Dev Center. Une fois le SDK récupéré il est nécessaire de l'installer. Celui-ci devrait mettre à disposition du développeur l'ide Xcode accompagné d'interface Builder pour la réalisation d'interface. À partir de là il ne reste plus qu'à lancer le projet depuis le finder. Les versions utilisées pour le développement ont été : Xcode 4 ios SDK 5 EIP

7 3. Technologies utilisées 3.1. Langages Les langages utilisés sont : Objective-C Différentes ressources sont disponibles sur internet pour se mettre à niveau sur ces langages Librairies Les librairies utilisées spécifiquement au développement de l'application sur ipad sont celles fournies par Apple, à savoir UIKit, Cocoa Touch et tous les outils contenus dans le SDK ios. Afin de traiter certains aspects graphiques nous utilisons la librairie OpenGL. Parmis les différentes utilisations nous pouvons citer entre autre le rendu d'animations et d'éléments graphiques trop complexes pour être développé avec UIKit. Afin de traiter le son digitalement nous utilisons la librairie FMOD. EIP

8 4. Structure du projet 4.1. Architecture MVC L'application, comme la plupart des applications ios, utilise le modèle MVC (Modèle Vue Contrôleur) pour structurer l'application. Les vues sont ici représentées par les différents écrans avec lesquels l'utilisateur peut interagir : Une vue globale globale va gérer la transition entre les différents écrans. C'est la LivepadView. Une vue est dédiée à chaque instrument : TurntablesView (platines et table de mixage), DrumMachineView (boite à rythme) et SynthesizerView (synthétiseur). Une vue est utilisée pour afficher les réglages de l'application : SettingsView. À chaque vue est associé un contrôleur (selon la nomenclature «nom de la vue» + «Controller») afin de récupérer les événements (interaction avec l'écran) et effectuer différentes actions en fonction du type d'événement. Par exemple lorsque l'utilisateur va appuyer sur le bouton «play» de la platine de droite, la vue TurntablesView va notifier au contrôleur TurntablesViewController que l'utilisateur à appuyer sur le bouton, et le contrôleur va donc agir en conséquence (ici jouer la chanson). Les vues et les éléments qu'elles contiennent sont dessinées à l'aide d'interface Builder, à quelques exception près, afin de faciliter le travail en cas de modification. EIP

9 4.2. Structure des différents composants Le projet s'architecture autour de 4 composants clés. Les contrôleurs TurntablesController, DumMachineController et SynthesizerController récupèrent les évènements utilisateurs, les convertissent et font appel aux différentes méthodes. Un composant SoundSystem s'occupe de faciliter la manipulation du son. Il est en lien direct avec les contrôleurs TurntablesController, DumMachineController et SynthesizerController. Un contrôleur PageSlider permet d'altèrner entre les 3 vues. Un contrôleur principal "MainController" gère la cohésion entre tous ces contrôleur. EIP

10 4.3. Éléments graphiques basiques Certains éléments basiques non implémentés par défaut ont dû être créé pour l'occasion. Ils se basent sur les éléments et classes de bases fournis par le framework UIKit et étendent les fonctionnalités afin de convenir à nos besoin LPKnob LPKnob est une classe désignant les boutons rotatifs. En faisant tourner le bouton sur lui même on influe sur une valeur. Cette valeur peut donc être récupérée et utilisée pour différents traitements : changement des aigus, médiums et graves, augmentation du pitch etc LPJog LPJog est utilisé pour simuler une platine. Son comportement est similaire à celui de LPKnob sauf qu'il n'est pas limité par une quelconque valeur. On peut donc le faire tourner à 360 indéfiniment. Il est utilisé principalement pour avancer et reculer dans la chanson LPCrossfader EIP

11 LPCrossfader est utilisé afin de simuler un crossfader. Cet élément agit comme un slider horizontal. En le bougeant de droite à gauche on réduit ou augmente l'importance du volume de la chanson concernée LPSlider LPSlider est utilisé afin de créer des sliders verticaux plus jolis que ceux proposés de base par UIKit. L'utilisateur peut interagir avec en faisant glisser le petit élément de haut en bas. Ainsi il influence sur une valeur qui peut être utilisée pour diverses raison (tempo, volume etc.) Éléments graphiques évolués Certains éléments graphiques nécessitent un gros travail de réalisation. Ces éléments sont conçus à l'aide la bibliothèque OpenGL Visualisation du spectre sonore Une zone située au dessus de chaque jog représente le spectre sonore de la EIP

12 chanson en cours de lecture. Celui-ci interagit avec les classes en charge du traitement audio Traitement audio Sélection d'une chanson L'utilisateur peut séléctionner une chanson présente dans la librairie ipod. Apple ne permet pas d'intéragir (appliquer des effets etc.) avec la chanson obtenu autrement que pour la jouer. Afin de contourner cette limite il faut importer la chanson au sein de la sandbox à partir de laquelle l'application est lancée. Ceci se fait à l'aide de la classe TSLibraryImport. Une fois le fichier importé on peut donc l'ouvrir à l'aide d'openal et intéragir avec Lecture d'une chanson Afin d'optimiser la lecture d'une chanson nous utilisons un système de streaming. La chanson n'est en effet pas chargée entièrement au moment de sa séléction. La chanson est plutôt lue morceau par morceau. Ainsi pendant que l'application charge le reste de la chanson, les morceaux de la chansons déjà chargés sont eux mis bout à bout et joués Représentation du son Au sein de l'application, le son est décomposé en PCM (Pulse Code Modulation). Pulse Code Modulation est une technique qui consiste à représenter des sons au format analogue sous format digital. Échantillonnage et quantification d'un signal analogique (en rouge) par un PCM 4-bit (source : Wikipédia) «Il s'agit d'une représentation numérique d'un signal analogique où la hauteur du signal est prélevée régulièrement à intervalles uniformes de durée T. Chaque échantillon est quantifié sur une série de symboles dans un code numérique, qui est habituellement un code binaire.» (source : Wikipédia) Les hertz représentent la densité de l échantillonnage. Pour fournir une EIP

13 bonne qualité de son, une fréquence de 44,1khz est utilisée sur tous les sons. L'utilisation de cette représentation numérique du son nous permet de travailler directement dessus et d appliquer tous les effets souhaités dans la mesure où le processeur de la tablette graphique n est pas surchargé. EIP

14 5. Jeux de tests 5.1. Tests fonctionnel Les fonctionnalités disponibles au sein de l'application doivent être conformes à celles décrites au sein du cahier des charges Test de robustesse Lors des tests de l'application d'un point de vue utilisateur il faut prendre en compte certains points sensibles : Stabilité : l'application ne doit en aucun cas quitter inopinément. Fluidité : on ne doit pas constater de latence lors de l'utilisation, notamment lors du chargement d'une chanson, de sa lecture EIP

15 6. Glossaire DJ Disc Jokey. Personne en charge de jouer harmonieusement plusieurs chansons afin d'ambiancer des soirées. EIP Epitech Innovative Project. Projets de fin d'étude réalisés par les étudiants de l'école Epitech en 2 ans à partir de leur 3 ème année. Epitech European Institute of Technology. École d'informatique en 5 ans. ipad Tablette tactile produite par le fabriquant Apple. EIP