pbojinov/TVMLCatalogUsingTVMLTemplates

Fév 5, 2022
admin

Exigences

Exigences de construction: Xcode 7.1, tvOS 9.0 Exigences de durée de vie: tvOS 9.0 ou version ultérieure

Introduction

Cet exemple montre comment utiliser le framework TVMLKit pour afficher du contenu TVML dans une application tvOS et fournit un catalogue des modèles TVML principaux. Pour une liste complète des modèles et des éléments disponibles, consultez la référence du langage de balisage Apple TV.

Structure

Le projet est divisé en deux parties:

  • TVMLCatalog : ce répertoire contient le projet Xcode et les fichiers associés. L’Appdélégué.le fichier swift gère la configuration du framework TVMLKit et le lancement du contexte JavaScript pour gérer l’application.client
  • : ce répertoire contient les fichiers JavaScript et XML nécessaires au rendu de l’application. Le contenu de ce répertoire doit être hébergé sur un serveur accessible depuis l’appareil.

Une fois l’application configurée et en cours d’exécution, vous travaillerez principalement dans le répertoire client. C’est là que vous définissez les modèles que vous souhaitez présenter à l’utilisateur et contrôlez la présentation et le cycle de vie de l’application avec JavaScript. Lorsque vous définissez de nouveaux modèles à présenter, expérimentez les styles disponibles pour avoir une idée de la flexibilité fournie dans TVMLKit et de leur personnalisation.

Pour aider au débogage et à l’expérimentation, vous pouvez utiliser Safari WebInspector pour l’attacher au contexte JavaScript. WebInspector vous fournit un environnement de débogage JavaScript complet. Vous devrez activer le menu Développer à partir de Safari > Préférences > Avancé. Sélectionnez votre appareil dans le menu déroulant Développer pour afficher une liste des contextes JavaScript en cours d’exécution.

Lorsque vous êtes prêt à ajouter des fonctionnalités plus avancées à votre application, ouvrez les fichiers clients et lisez la référence du langage de balisage Apple TV. Vous pouvez ajouter de nouvelles API JavaScript, créer de nouveaux modèles ou éléments XML et transmettre des informations supplémentaires dans le contexte JavaScript au lancement. Vous pouvez également étendre les capacités de votre application en créant une extension TopShelfExtenstion pour présenter des éléments dans l’étagère supérieure lorsque votre application est déplacée vers la première ligne du menu principal de l’Apple TV.

Instructions d’installation :

Pour démarrer un serveur local, exécutez la commande suivante dans un terminal dans le dossier ‘client’ pour créer un serveur Web simple.

python -m SimpleHTTPServer 9001
  • Ouvrez le catalogue TVMLC.projet xcodeproj dans Xcode
  • Si le code client est hébergé sur un serveur distant ou si vous exécutez cette application sur l’Apple TV, modifiez la propriété suivante dans AppDelegate.swift:
    • Remplacez la valeur TVBaseURL par l’URL hébergeant le contenu du répertoire client
    • Notez que les informations.plist désactive actuellement la sécurité du transport des applications via NSAllowsArbitraryLoads. C’est seulement pour simplifier le processus d’examen de l’échantillon. Vos propres applications doivent s’appuyer sur des serveurs correctement sécurisés qui ne nécessitent pas la désactivation de la sécurité du transport des applications.
  • Créez et exécutez l’application
  • Lors de l’exécution de cette application sur un appareil, vous devrez ajouter un profil de signature dans les paramètres de construction des projets.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée.