Construire un AudioPlayer avec PhoneGap Réglage de l'application

Ceci est la troisième et dernière partie de la série sur Audero Audio Player. Dans cet article, je vais passer en revue les fichiers restants afin que vous puissiez terminer le projet et jouer avec..


Aperçu de la série

  • Configuration de l'application
  • Logique d'application
  • Réglage de l'application

Réglage du style

jQuery Mobile fait beaucoup pour vous en améliorant les éléments des pages pour les appareils dotés d'écrans plus petits. Cependant, il y en a que je n’aime pas, et nous les ajusterons dans notre style.css fichier. Ceci est également utilisé pour styler la balise du joueur.

Par défaut, même si vous ne disposez pas de boutons dans l'en-tête ou le pied de page, le cadre réserve toujours de l'espace des deux côtés des éléments et tronque les titres longs. Ce comportement est également appliqué à d'autres éléments. Nous pouvons le changer simplement en appliquant la règle espace blanc: normal! important; à nos éléments ciblés comme .titre ui.

La source de la feuille de style est montrée ici:

 .ui-header .ui-title, .ui-footer .ui-title, .ui-btn-inner * white-space: normal! important;  .photo text-align: center;  # player-play, # player-stop display: inline-block; largeur: 48px; hauteur: 48px;  # player-play background-image: url ('… /images/play.png');  # player-stop background-image: url ('… /images/stop.png');  # time-slider display: none;  div.ui-slider-track margin: 0; largeur: 100%; 

Configuration personnalisée jQuery Mobile

jQuery Mobile a une configuration par défaut qui devrait être suffisante pour la plupart des projets avec des exigences simples. Cependant, vous voudrez parfois modifier ou prendre le contrôle de certains comportements par défaut. Vous pouvez y parvenir en écrivant un fichier de configuration. Le fichier jquery.mobile.config.js est exactement où nous aurons la configuration. Veuillez noter que vous devez inclure le fichier de configuration. avant les fichiers jQuery Mobile. Lorsque jQuery Mobile démarre, il déclenche le mobileinit événement, qui est celui que vous devez lier pour remplacer les paramètres par défaut.

Nous allons faire le changement en attribuant des valeurs aux propriétés de la $ .mobile objet. Je ne changerai pas beaucoup de propriétés. Je vais plutôt changer l'option pour que le texte soit affiché sur le widget chargeur de page et le thème.

La source complète du fichier est listée ci-dessous:

 $ (document) .on ('mobileinit', function () // Widget Page Loader $ .mobile.loader.prototype.options.text = 'Chargement…'; $ .mobile.loader.prototype.options.textVisible = true ; // Thème $ .mobile.page.prototype.options.theme = 'a'; $ .mobile.page.prototype.options.headerTheme = 'a'; $ .mobile.page.prototype.options.contentTheme = 'a '; $ .mobile.page.prototype.options.footerTheme =' a '; $ .mobile.page.prototype.options.backBtnTheme =' a ';);

Configuration de construction

Le service Adobe PhoneGap Build vous permet de spécifier les métadonnées d'une application, telles que l'auteur et la description, à l'aide d'un fichier de configuration. Ce fichier s'appelle config.xml. Expliquer le format en profondeur dépasse le cadre de cette série, mais je vais vous donner un bref aperçu. Si vous voulez en savoir plus sur ce sujet, consultez la page de documentation officielle.

le config.xml Le fichier suit la spécification du widget W3C et doit rester à la racine de l'application, au même niveau que le index.html fichier. Sa première ligne est la déclaration XML et la racine du document est un balise qui a plusieurs attributs possibles. Les plus importants sont identifiant (identifiant unique de votre projet), et version (qui spécifie la version de l'application). À l'intérieur de balise, vous pouvez écrire les métadonnées de votre application. Dans notre fichier, nous en utiliserons beaucoup, mais les plus importants sont les suivants:

  • prénom (obligatoire): nom de l'application. Il ne doit pas être unique.
  • la description (obligatoire): description de l'application. C'est particulièrement important car il sera affiché dans la liste des marchés de l'application.
  • icône (facultatif): l'icône à afficher sur les appareils qui installeront votre application. Si vous ne le spécifiez pas, le logo Cordova sera utilisé.
  • éclaboussure (facultatif): cette balise définit l'écran de démarrage de l'application, qui est l'image affichée lors du chargement..
  • fonctionnalité (facultatif): Spécifie les fonctionnalités que vous souhaitez utiliser. Par exemple, Android, avant d'installer une application, indique à l'utilisateur les autorisations nécessaires et, si l'utilisateur y consent, le logiciel continue..
  • préférence (facultatif): ensemble de préférences que vous souhaitez appliquer à votre application. C'est une balise fermée et vous pouvez avoir zéro ou plus balises à l'intérieur du fichier. Il a deux attributs, et les deux sont obligatoires: prénom et valeur. Vous pouvez définir de nombreuses préférences, mais la plus importante à mon avis est de spécifier la version de Cordova utilisée..

le Cette balise est également très importante car, pour citer la documentation, fournit à votre application un accès à des ressources sur d'autres domaines - en particulier, elle permet de charger des pages de domaines externes pouvant prendre en charge l'intégralité de votre affichage Web. Rappelant ce que nous avons discuté dans la section Gestion des liens externes à partir du message précédent, pour ouvrir les liens externes dans Cordova WebView, nous devons les ajouter à la liste blanche de l'application. Étant donné que notre application ne récupère pas les liens de sources externes non sécurisées, nous pouvons raccourcir le processus pour autoriser l'utilisation de toute ressource externe * Caractère spécial. Par exemple:

J'ai souligné les points clés du format et vous pouvez maintenant comprendre la source du fichier de configuration. Le fichier complet est ci-dessous:

   Audero Audio Player Audero Audio Player est un lecteur audio de base qui collecte les fichiers audio et permet ensuite à l'utilisateur de les écouter. Cette application vous permet également de mettre à jour la liste à tout moment pour inclure d'autres fichiers éventuellement téléchargés après l'exécution de l'opération pour la première fois. Vous pouvez également supprimer tout fichier audio indésirable de la liste en cliquant sur une icône à droite du nom de la chanson. La liste des sons est classée par ordre alphabétique avec des séparateurs de lettres pour organiser et regrouper les éléments de la liste, et une zone de recherche permet de filtrer les fichiers.. Aurelio De Rosa                  

Lancer l'application

Dans la dernière section, tous les fichiers de logique métier, HTML et CSS de l'application ont été créés. Il est donc temps de définir les fonctions de saisie de l'application et de les lire. La fonction ciblée sera la initApplication () méthode du Application classe. Il fonctionnera une fois que Cordova sera complètement chargé, ce qui vous permettra d'appeler en toute sécurité les API Cordova. Pour ce faire, nous allons définir initApplication () en tant que fonction de rappel pour le prêt événement en ajoutant le code suivant à la index.html fichier. Vous pouvez le voir en regardant l'extrait suivant:

 

Améliorations possibles

Vous êtes maintenant à la fin du projet. Cela étant dit, chaque projet a sa place pour des améliorations et de nouvelles fonctionnalités. Par conséquent, avant de conclure la série, j'aimerais vous en suggérer quelques-unes..

La première fonctionnalité que vous pouvez ajouter est l'internationalisation (i18n) de l'application. Notre lecteur n'a pas beaucoup de texte, il est donc très facile de le traduire dans d'autres langues. Pour traduire l'application, vous pouvez utiliser l'API de globalisation, une API ajoutée au noyau à partir de la version 2.2.0. De plus, une bibliothèque spécifique à jQuery telle que jquery-i18n-properties ou jQuery-i18n serait sûrement utile pour cette fonctionnalité..

Autres suggestions mineures sont:

  • Autoriser l'utilisateur à créer une liste de lecture.
  • Créez un bouton "Tout lire" pour lire toutes les chansons de la liste..
  • Créer un système de classement pour l'audio afin que l'utilisateur puisse filtrer et ordonner les chansons par classement.
  • Ajouter un bouton "Répéter" pour que l'utilisateur puisse continuer à écouter la chanson en cours.

Ces suggestions ne sont que quelques-unes des améliorations que vous pouvez apporter à la Audero Audio Player. En utilisant les informations de ce tutoriel et vos propres compétences, vous pouvez faire beaucoup, beaucoup plus.


Conclusion

Comme vous l'avez vu tout au long de cette série, vous pouvez créer des applications puissantes et utiles à l'aide de technologies Web et de cadres populaires. Maintenant, à vous de jouer avec ce projet. Essayez de démarrer votre propre projet pour tester ce que vous avez appris dans cette série.!