mimoLive peut être personnalisé en ajoutant de nouveaux calques. La véritable puissance des calques réside dans le fait qu'ils sont créés à l'aide d'une technologie MacOS X appelée Quartz Composer. Presque tout est possible avec les compositions Quartz. Vous pouvez créer des émissions de télévision interactives dans lesquelles votre public peut envoyer des SMS ou des messages Twitter qui s'affichent à l'écran. Créer des graphiques boursiers à partir de données en ligne. Comptabiliser les scores d'un match sportif. Jouer à des jeux à l'écran. Vous pouvez trouver de l'inspiration dans certaines des couches incluses dans mimoLive. Pour fonctionner avec mimoLive, les compositions Quartz doivent contenir certains éléments afin que mimoLive et le calque puissent communiquer et que le calque puisse afficher les fichiers multimédias que mimoLive lui envoie. En théorie, tout le monde peut créer ses propres calques. Cette page décrit, d'un point de vue technique, comment créer des calques à l'aide de Quartz Composer.
Achat d'une couche personnalisée
Si vous ne souhaitez pas vous plonger vous-même dans Quartz Composer, laissez-nous le faire pour vous. Nous avons une grande expérience de la création de couches pour mimoLive, y compris de la visualisation de données telles que les graphiques boursiers, que vous pouvez mettre à profit pour créer la couche qui vous convient le mieux. S'il vous plaît contacter le service commercial pour plus de détails.
Création d'un calque personnalisé - Démarrage
Masterclass Couches de codage pour mimoLive
Pré-requis
Vous devez remplir certaines conditions avant de pouvoir commencer à développer des couches pour mimoLive :
- Vous devez disposer d'une licence mimoLive valide pour tester et exécuter vos calques dans mimoLive.
- Vous devez avoir installé l'application Quartz Composer d'Apple. Il s'agit d'un outil de développement gratuit que vous pouvez télécharger sur le site web des développeurs d'Apple. Cependant, vous devez d'abord vous enregistrer en tant que développeur Mac (http://developer.apple.com). Vous y trouverez Guide de l'utilisateur de Quartz Composer par Apple.
- Patch Lua - Vous aurez besoin du patch Lua pour ouvrir les couches mimoLive dans Quartz Composer à partir de mimoLive 1.9. Il est open source et disponible sur GitHub. Nous utilisons ce patch pour remplacer le patch JavaScript de QuartzComposer car il ne fonctionne pas de manière stable dans mimoLive. (Téléchargez le patch ici :[https://github.com/boinx/QCLua/releases )
- JSON Patch et Patch OAuth - Il existe deux autres patchs personnalisés qui ne sont actuellement utilisés que dans la couche Twitter. Lorsque vous personnalisez la couche Twitter, vous devez télécharger et installer les correctifs avant de commencer l'édition.
Modèle de calque vierge
Vous pouvez utiliser notre fichier de composition Quartz gratuit comme point de départ pour vos couches personnalisées. Il contient un ensemble d'entrées et de sorties de base et les propriétés requises que vous devez modifier dans la boîte de dialogue "Editer les informations" de Quartz Composer.
Télécharger Layer Template v1.0
L'exemple de Hello-World
Comme premier exemple simple, nous allons créer une composition Quartz de base et l'utiliser comme couche dans mimoLive.
- Démarrer l'application Quartz Composer
- Choisir Fichier ⇢ Nouveau vide dans la barre de menu. Vous obtiendrez un nouveau document Quartz Composer vide.
- Ouvrez la bibliothèque de patchs en cliquant sur le bouton situé dans le coin supérieur gauche. Une petite fenêtre apparaîtra avec une liste de tous les patchs de Quartz Composer.
- Dans la bibliothèque des patchs, recherchez le patch intitulé Billboard. Vous pouvez le faire rapidement en tapant les premières lettres du nom du patch dans le champ de recherche situé en bas de la fenêtre de la bibliothèque de patchs. Il s'agit d'un patch de rendu. Il dessine une image à plat sur l'écran de sortie.
- Faites glisser le patch de la bibliothèque vers votre fenêtre d'édition vierge. Le patch restera collé à l'endroit où vous l'avez déposé. Vous pouvez le déplacer en cliquant dessus. Remarque : le patch a plusieurs entrées qui sont marquées par un point de connexion sur le côté gauche de chaque valeur.
- Trouvez maintenant le patch Image with String dans la bibliothèque de patchs et faites-le glisser dans votre fenêtre d'édition. Positionnez-le sur le côté droit du patch Billboard. Le patch Image with String est un patch générateur qui génère une image contenant un texte que vous pouvez spécifier avec la valeur d'entrée String.
- Connectez la sortie Image du patch Image with String à l'entrée Image du patch Billboard.
- Si la visionneuse Quartz Composer n'est pas visible pour l'instant, cliquez sur le bouton Visionneuse dans le coin supérieur droit. Vous devriez voir une fenêtre avec un damier en arrière-plan et "Hello World !" en lettres blanches au-dessus.
- Retournez dans la fenêtre de l'éditeur et cliquez avec le bouton droit de la souris sur le patch Image with String pour faire apparaître un menu contextuel.
- Sélectionner Insert Input Splitter ⇢ String de ce menu contextuel. Un nouveau patch de type Séparateur d'entrée apparaîtra sur le document et sera connecté par sa sortie à la chaîne d'entrée du patch Image avec chaîne.
- Cliquez à nouveau avec le bouton droit de la souris sur le séparateur d'entrée nouvellement créé et sélectionnez Publier les entrées ⇢ Entrée. Une zone de texte apparaît et demande le nom de cette entrée publiée. Remplacez-le par Mon texte. Veuillez noter que cette entrée publiée est visible dans mimoLive et qu'elle sera présentée dans la vue des paramètres à gauche lorsque la couche est sélectionnée dans mimoLive.
- Ouvrez la fiche d'information sur la composition en sélectionnant Éditeur ⇢ Modifier les informations.... Vous obtiendrez une feuille contenant une liste de paires clé-valeur.
- Ajoutez une nouvelle clé en cliquant sur le bouton + en bas à gauche. Une nouvelle ligne apparaîtra dans la liste pour demander un nom de clé.
- Saisissez tv_LayerProtocolVersion en tant que paramètre Propriété, commuter le Classe de ''String'' à ''Number'' et mettre un ''1'' dans l'option ''String'' à ''Number''. Valeur colonne.
- Cliquez sur le bouton Terminé dans le coin inférieur gauche pour fermer la feuille.
- Enregistrez cette composition sur votre bureau sous le nom Hello World.qtz
- Lancez mimoLive, ne créez pas encore de document.
- Sélectionner Fichier ⇢ Importer des compositions de calques... dans la barre de menu. Une boîte de dialogue de sélection de fichier s'affiche. Veuillez sélectionner le fichier Hello World.qtz précédemment enregistré sur le Bureau.
- Créez maintenant un nouveau document mimoLive avec Fichier ⇢ Nouveau.... Le sélecteur de modèles mimoLive s'affiche.
- Sélectionnez le modèle Vierge et cliquez sur le bouton Choisir dans le coin inférieur droit. Une nouvelle fenêtre de document mimoLive s'affiche, contenant un seul calque Placer dans lequel vous êtes assis devant votre ordinateur.
- Ouvrez le référentiel des couches en cliquant sur le bouton "+" dans le coin supérieur droit de la colonne Couches.
- Trouvez le calque Hello World que vous venez d'importer et faites glisser une instance au sommet de la pile de calques au milieu du document.
- Recherchez l'entrée définie par vos soins, appelée Mon texte, et modifiez le texte du champ de saisie.
- Après avoir cliqué sur le bouton "Live" de ce calque, votre texte apparaîtra sur la vidéo.
Félicitations ! Vous venez de créer une nouvelle couche mimoLive ! Dans les sections suivantes, nous allons entrer dans les détails de ce qui est nécessaire pour être un bon citoyen de mimoLive.
Veuillez noter que nous ne pouvons pas expliquer en détail comment utiliser l'éditeur Quartz Composer dans cette documentation. Si vous souhaitez en savoir plus sur Quartz Composer, veuillez lire le Guide de l'utilisateur de Quartz Composer sur le site Apple Developer.
Gestion des calques dans mimoLive
Exportation d'une couche à partir de mimoLive
Si vous souhaitez modifier une couche intégrée dans mimoLive, vous pouvez exporter cette couche dans mimoLive en suivant les étapes suivantes :
- Ouvrez le référentiel des calques à l'aide du bouton "+" situé dans le coin supérieur droit de la colonne Calques.
- Recherchez et sélectionnez le calque que vous souhaitez utiliser comme base pour votre nouveau calque.
- Ouvrez le menu contextuel en cliquant avec le bouton droit de la souris sur ce calque.
- Sélectionner Exporter la composition des couches... dans ce menu contextuel.
- Il vous sera demandé de saisir un nom de fichier et de définir l'emplacement où enregistrer la couche.
Importation d'une couche dans mimoLive
Une fois que vous avez fini de modifier ou de créer votre couche personnalisée, vous devez l'importer dans mimoLive. Il existe plusieurs façons d'importer une couche dans mimoLive :
Importation d'une couche à l'aide du menu Fichier
- Sélectionnez Fichier ⇢ Importer des compositions de calques....
- Une boîte de dialogue de sélection de fichiers s'affiche.
- Sélectionnez votre fichier QuartzComposition et cliquez sur "Importer".
Importer une couche en utilisant l'extension de nom de fichier ".tvlayer"
Cette technique est utile lorsque vous envoyez des calques personnalisés à d'autres utilisateurs de mimoLive (par exemple vos clients) qui ne sont pas familiarisés avec l'importation manuelle de calques personnalisés. Elle n'est cependant pas très pratique en cours de développement, car QuartzComposer n'ouvre pas le fichier lorsque vous en modifiez l'extension.
- Recherchez votre composition dans le Finder.
- Cliquez une fois sur le nom du fichier pour le modifier. Un cadre autour du nom du fichier indique que vous êtes sur le point de le modifier.
- Ajoutez l'extension .tvlayer à la fin et appuyez sur Return. Le Finder vous demandera si vous souhaitez réellement modifier l'extension. Veuillez accepter.
- Double-cliquez sur le fichier de composition. mimoLive ouvrira et importera automatiquement le fichier en tant que nouveau calque. Un message d'alerte s'affiche en cas de succès.
Couche personnalisée API
mimoLive s'attend à ce que les compositions de Quartz adoptent le système de la Couche personnalisée API. Dans cette section, vous apprendrez la mise en œuvre minimale.
Mise en œuvre minimale
La mise en œuvre minimale du protocole de couche n'implique que les propriétés de composition de Quartz, qui peuvent être modifiées dans l'éditeur de Quartz Composer en sélectionnant Éditeur ⇢ Modifier les informations (⌥⌘I).
| Nom | Type | Valeur de l'échantillon |
|---|---|---|
| tv_LayerProtocolVersion | Nombre (réel) | 1.2 |
| tv_LayerIdentifier | Chaîne | com.example.layer.mylayer |
| tv_LayerVersion | Nombre (réel) | 1.01 |
Il est important de savoir comment ces valeurs sont utilisées par mimoLive afin que mimoLive puisse gérer les conflits de version des couches.
- tv_LayerProtocolVersion : Lorsque nous modifions le protocole de la couche, nous augmentons la version du protocole de la couche. Cela permet aux anciennes versions de mimoLive de signaler à l'utilisateur l'utilisation d'une couche (par exemple, stockée dans un document mimoLive) dont la version du protocole est plus récente et qui risque donc de ne pas être traitée correctement par mimoLive.
- tv_LayerIdentifier : Cette valeur doit être unique pour chacune de vos couches. Nos couches ont le préfixe com.boinx.layer.*. Veuillez utiliser votre propre schéma afin d'avoir des identifiants uniques dans le monde entier. Veuillez noter que mimoLive n'utilise pas le nom de fichier pour comparer les couches !
- tv_LayerVersion : Si mimoLive constate que la version d'un calque stocké dans un document est différente de celle d'un calque installé dans le référentiel de calques, il utilise les règles suivantes pour décider de ce qu'il convient de faire :
- Si la version de la couche documentaire est supérieure à celle du référentiel : conserver la version du document.
- Si la version du calque de document est inférieure à celle du référentiel, mais qu'elle a le même numéro majeur (par exemple, 2.4 contre 2.6), remplacez le calque de document par le nouveau.
Si le numéro majeur de la version du calque est différent, mimoLive traitera le calque comme un remplacement incompatible et ne mettra pas à jour le document du calque !
Ajouts aux biens communs
- le droit d'auteur :
- description :
- nom :
- tv_Tagline :