Aangepaste lagen

mimoLive kan worden aangepast door nieuwe lagen toe te voegen. De echte kracht van lagen ligt in het feit dat ze eigenlijk gemaakt zijn met een MacOS X technologie genaamd Quartz Composer. Bijna alles is mogelijk met Quartz Compositions. Je kunt interactieve tv-programma's maken waarbij je publiek het volgende kan insturen SMS of twitterberichten die op het scherm worden weergegeven. Aandelengrafieken maken op basis van online gegevens. Scores bijhouden in een sportwedstrijd. Spelletjes spelen op het scherm. Misschien vind je inspiratie in sommige lagen die met mimoLive worden meegeleverd. Om met mimoLive te kunnen werken, moeten de Quartz Compositions bepaalde elementen bevatten, zodat mimoLive en de layer met elkaar kunnen praten en de layer de mediabestanden kan weergeven die mimoLive ernaar stuurt. In theorie kan iedereen zijn eigen lagen maken. Deze pagina beschrijft op technisch niveau hoe je lagen kunt maken met Quartz Composer.

Een aangepaste laag kopen

Als je niet zelf in Quartz Composer wilt duiken, laat ons het dan voor je doen. We hebben uitgebreide ervaring met het maken van lagen voor mimoLive, inclusief datavisualisatie zoals aandelengrafieken, die je kunt gebruiken om precies de juiste laag voor jou te maken. Alsjeblieft neem contact op met de verkoopafdeling voor meer informatie.

Een aangepaste laag maken - Aan de slag

Masterclass Coderingslagen voor mimoLive

Pre-aanvragen

Er zijn enkele voorwaarden voordat je kunt beginnen met het ontwikkelen van lagen voor mimoLive:

• U hebt een geldige mimoLive-licentie nodig om uw lagen in mimoLive te testen en uit te voeren.
• Je moet het programma Quartz Composer van Apple geïnstalleerd hebben. Het is een gratis ontwikkelprogramma dat je kunt downloaden op de ontwikkelaarswebsite van Apple. Je moet je wel eerst registreren als Mac Developer (http://developer.apple.com). Hier vind je De gebruikershandleiding voor Quartz Composer door Apple.
• Lua patch - Je hebt de Lua patch nodig om mimoLive Layers te openen in Quartz Composer vanaf mimoLive 1.9. Deze is open source en beschikbaar via GitHub. We gebruiken deze patch als vervanging voor de QuartzComposer JavaScript patch omdat deze niet stabiel draait in mimoLive. (Download de patch hier:[https://github.com/boinx/QCLua/releases )
• JSON Patch en OAuth patch - Er zijn nog twee aangepaste patches die momenteel alleen worden gebruikt in de Twitter-laag. Als je de Twitter-laag aanpast, moet je de patches downloaden en installeren voordat je begint met bewerken.

Blanco Laag Sjabloon
U kunt ons gratis Quartz compositiebestand gebruiken als startpunt voor uw eigen lagen. Het bevat een basisset van in- en uitgangen en de vereiste eigenschappen die u moet wijzigen in het dialoogvenster "Bewerk informatie" van Quartz Composer.

Downloaden Laag sjabloon v1.0

Het voorbeeld van Hello-World

Als eerste en eenvoudig voorbeeld maken we een basiscompositie van Quartz en gebruiken die als laag in mimoLive.

1. Start de toepassing Quartz Composer
2. Kies Bestand ⇢ Nieuw leeg in de menubalk. Je krijgt een nieuw leeg Quartz Composer document.
3. Open de Patch Library met de knop in de linkerbovenhoek. Er verschijnt een klein venster met een lijst van alle Quartz Composer-patches.
4. Zoek in de Patchbibliotheek de Patch met de naam Billboard. Je kunt dit snel doen door enkele voorletters van de patchnaam in te typen in het zoekveld onder in het venster van de Patchbibliotheek. Dit is een Render Patch. Het tekent een afbeelding plat op het uitvoerscherm.
5. Sleep de patch van de bibliotheek naar je lege editorvenster. De patch blijft hangen waar je hem neerzet. Je kunt hem verplaatsen door erop te klikken en te slepen. Let op: De patch heeft verschillende ingangen die zijn gemarkeerd met een verbindingspunt aan de linkerkant van elke waarde.
6. Zoek nu de patch Afbeelding met String in de Patchbibliotheek en sleep deze naar je editorvenster. Plaats het aan de rechterkant van de Billboard patch. De Afbeelding met String patch is een Generator patch die een afbeelding genereert met een tekst die je kunt opgeven met de invoerwaarde String.
7. Verbind de Image-uitgang van de Image with String-patch met de Image-ingang van de Billboard-patch.
8. Als de Quartz Composer Viewer nu niet zichtbaar is, klik dan op de Viewer knop in de rechterbovenhoek. Je zou een venster moeten zien met een dambord op de achtergrond en "Hello World!" in witte letters erboven.
9. Ga terug naar het Editor-venster en klik met de rechtermuisknop op de Afbeelding met string-patch om er een contextmenu voor te openen.
10. Selecteer Invoegsplitser invoegen ⇢ String van dat contextmenu. Er verschijnt een nieuwe patch van het type Invoersplitser op het document die door zijn uitvoer verbonden is met de invoer String van de Afbeelding met String patch.
11. Klik opnieuw met de rechtermuisknop op deze nieuw aangemaakte ingangssplitter en selecteer Ingangen publiceren ⇢ Ingang. Er verschijnt een tekstvak waarin wordt gevraagd om een naam voor deze gepubliceerde invoer. Verander deze in Mijn tekst. Houd er rekening mee dat deze gepubliceerde invoer zichtbaar is voor mimoLive en wordt weergegeven in de parameterweergave aan de linkerkant wanneer de laag wordt geselecteerd in mimoLive.
12. Open het blad met samenstellingsinformatie door Bewerken ⇢ Bewerk informatie.... Je krijgt een blad met een lijst van sleutelwaardeparen.
13. Voeg een nieuwe sleutel toe door linksonder op de knop + te klikken. Er verschijnt een nieuwe regel in de lijst waarin om een sleutelnaam wordt gevraagd.
14. Voer tv_LayerProtocolVersion in als de Eigendomschakel de Klasse optie van ''String'' naar ''Number'' en zet een ''1'' in de Waarde kolom.
15. Klik op de Gedaan knop in de linkerbenedenhoek om het blad te sluiten.
16. Sla deze compositie op je bureaublad op met de naam Hello World.qtz
17. Start mimoLive, maar maak nog geen document.
18. Selecteer Bestand ⇢ Laagcomposities importeren... in de menubalk. Er verschijnt een dialoogvenster Bestand kiezen. Selecteer het bestand Hello World.qtz dat je eerder op het bureaublad hebt opgeslagen.
19. Maak nu een nieuw mimoLive-document met Bestand ⇢ Nieuw.... De mimoLive Template Chooser zal verschijnen.
20. Selecteer de sjabloon Blank en klik op de knop Choose in de rechterbenedenhoek. Een nieuw mimoLive Document venster verschijnt met daarin een enkele Placer laag die jezelf weergeeft terwijl je voor je computer zit.
21. Open het Lagenarchief door te klikken op de knop "+" in de rechterbovenhoek van de kolom Lagen.
22. Zoek de Hello World-laag die je zojuist hebt geïmporteerd en sleep een instantie naar de bovenkant van de lagenstapel in het midden van het document.
23. Zoek je zelf gedefinieerde invoer genaamd Mijn tekst en wijzig de tekst van het invoerveld.
24. Nadat je op de knop Live van die laag hebt geklikt, verschijnt je tekst boven de video.

Gefeliciteerd! Je hebt zojuist een nieuwe mimoLive laag aangemaakt! In de volgende secties gaan we dieper in op wat nodig is om een goede mimoLive-burger te zijn.

Houd er rekening mee dat we in deze documentatie niet alle details kunnen uitleggen over het gebruik van de Quartz Composer Editor. Als je meer wilt weten over Quartz Composer, lees dan The Quartz Composer User Guide op de Apple Developer website.

Omgaan met lagen in mimoLive

Een laag exporteren vanuit mimoLive

Als je een ingebouwde mimoLive-laag wilt wijzigen, kun je die laag exporteren in mimoLive door de volgende stappen uit te voeren:

• Open het lagenarchief met de knop "+" rechtsboven in de kolom Lagen.
• Zoek en selecteer de laag die je wilt gebruiken als basis voor je nieuwe laag.
• Open het contextmenu door met de rechtermuisknop op die laag te klikken.
• Selecteer Laagopbouw exporteren... in dat contextmenu.
• Je wordt gevraagd om een bestandsnaam in te voeren en een locatie in te stellen waar je de laag wilt opslaan.

Een laag importeren in mimoLive

Zodra je klaar bent met het bewerken of maken van je aangepaste laag, moet je je laag importeren in mimoLive. Er zijn verschillende manieren om een laag in mimoLive te importeren:

Een laag importeren met het menu Bestand

• Selecteer Bestand ⇢ Laagcomposities importeren....
• Er verschijnt een dialoogvenster Bestand kiezen.
• Selecteer het QuartzComposition-bestand en druk op "Importeren".

Een laag importeren met de bestandsnaamextensie ".tvlayer".

Deze techniek is handig bij het verzenden van aangepaste lagen naar andere mimoLive-gebruikers (bijv. je klanten) die niet bekend zijn met het handmatig importeren van aangepaste lagen. Het is echter niet erg handig tijdens de ontwikkeling, omdat QuartzComposer het bestand niet opent als je de extensie ervan wijzigt.

• Zoek je compositie in Finder.
• Klik eenmaal op de bestandsnaam om de naam van het bestand te wijzigen. Een kader rond de bestandsnaam geeft aan dat je de naam gaat wijzigen.
• Voeg de extensie .tvlayer toe aan het einde en druk op Return. De Finder vraagt of je de extensie echt wilt wijzigen. Accepteer deze vraag.
• Dubbelklik op het compositiebestand. Nu zal mimoLive het bestand automatisch openen en importeren als nieuwe laag. Bij succes krijgt u een melding.

Aangepaste laag API

mimoLive verwacht dat de Quartz Compositions de Aangepaste laag API. In dit onderdeel leer je de minimale implementatie.

Minimale implementatie

De minimale implementatie van het Layer Protocol heeft alleen betrekking op Quartz Composition Properties die kunnen worden bewerkt in de Quartz Composer editor door te kiezen voor Editor ⇢ Informatie bewerken (⌥⌘I).

Het is belangrijk om te weten hoe deze waarden door mimoLive worden gebruikt, zodat mimoLive laagversieconflicten kan afhandelen.

• tv_LayerProtocolVersion: Wanneer we het protocol van de laag wijzigen, verhogen we de versie van het laagprotocol. Hiermee zijn oudere mimoLive versies in staat om de gebruiker te vertellen of een laag wordt gebruikt (bijv. opgeslagen in een mimoLive document) die een nieuwere protocol versie heeft en daarom mogelijk niet correct wordt behandeld door mimoLive.
• tv_LayerIdentifier: Deze waarde moet uniek zijn voor al je lagen. Onze lagen hebben het voorvoegsel com.boinx.layer.*. Gebruik je eigen schema om over de hele wereld unieke identifiers te hebben. Let op dat mimoLive de bestandsnaam niet gebruikt om lagen te vergelijken!
• tv_LayerVersion: Als mimoLive de laagversie anders vindt voor een laag die is opgeslagen in een document dan de laag die is geïnstalleerd in de lagenrepository, gebruikt het de volgende regels om te beslissen wat te doen:
  - Als de versie van de documentlaag hoger is dan die van het archief: bewaar de versie van het document
  - Als de versie van de documentlaag lager is dan die van het archief, maar hetzelfde hoofdnummer heeft (bijv. 2.4 vs 2.6), vervang dan de documentlaag door de nieuwe.
  Als het hoofdnummer van de laagversie anders is, zal mimoLive de laag behandelen als een incompatibele vervanging en de documentlaag niet bijwerken!

Toevoegingen aan gemeenschappelijk eigendom

• auteursrecht:
• beschrijving:
• naam:
• tv_Tagline: