Benutzerdefinierte Schichten

mimoLive kann durch Hinzufügen neuer Ebenen angepasst werden. Die wahre Stärke der Ebenen liegt in der Tatsache, dass sie mit einer MacOS X Technologie namens Quartz Composer erstellt werden. Mit Quartz Compositions ist fast alles möglich. Sie können interaktive TV-Shows erstellen, bei denen Ihr Publikum Beiträge einsenden kann. SMS oder Twitter-Nachrichten, die auf dem Bildschirm angezeigt werden. Erstellen Sie Aktiencharts aus Online-Daten. Den Spielstand bei einem Sportspiel verfolgen. Spielen Sie Spiele auf dem Bildschirm. Vielleicht lassen Sie sich von einigen der in mimoLive enthaltenen Ebenen inspirieren. Um mit mimoLive zu arbeiten, müssen die Quartz-Kompositionen bestimmte Elemente enthalten, damit mimoLive und die Ebene miteinander kommunizieren können und die Ebene die Mediendateien anzeigen kann, die mimoLive an sie sendet. Theoretisch kann jeder seine eigenen Layer erstellen. Diese Seite beschreibt auf technischer Ebene, wie man Layer mit dem Quartz Composer erstellt.

Kauf einer benutzerdefinierten Ebene

Wenn Sie sich nicht selbst in den Quartz Composer einarbeiten möchten, können Sie dies auch uns überlassen. Wir haben umfangreiche Erfahrung in der Erstellung von Layern für mimoLive, einschließlich Datenvisualisierung wie Aktiencharts, die Sie nutzen können, um genau den richtigen Layer für Sie zu erstellen. Bitte Kontakt mit der Verkaufsabteilung für Einzelheiten.

Erstellen einer benutzerdefinierten Ebene - Erste Schritte

Masterclass Codierschichten für mimoLive

Vorabanfragen

Bevor Sie mit der Entwicklung von Schichten für mimoLive beginnen können, müssen Sie einige Voraussetzungen erfüllen:

• Sie benötigen eine gültige mimoLive-Lizenz, um Ihre Layer in mimoLive zu testen und zu betreiben.
• Sie müssen das Programm Quartz Composer von Apple installiert haben. Es handelt sich dabei um ein kostenloses Entwicklungstool, das Sie auf der Entwickler-Website von Apple herunterladen können. Allerdings müssen Sie sich zunächst als Mac-Entwickler registrieren (http://developer.apple.com). Hier finden Sie Das Quartz Composer Benutzerhandbuch von Apple.
• Lua-Patch - Sie benötigen den Lua-Patch, um mimoLive Layers im Quartz Composer ab mimoLive 1.9 zu öffnen. Er ist Open Source und auf GitHub verfügbar. Wir verwenden diesen Patch als Ersatz für den QuartzComposer JavaScript Patch, da dieser in mimoLive nicht stabil läuft. (Laden Sie den Patch von hier herunter:[https://github.com/boinx/QCLua/releases )
• JSON Aufnäher und OAuth-Patch - Es gibt zwei weitere benutzerdefinierte Patches, die derzeit nur in der Twitter-Ebene verwendet werden. Wenn Sie die Twitter-Ebene anpassen, müssen Sie die Patches herunterladen und installieren, bevor Sie mit der Bearbeitung beginnen.

Leere Ebenenvorlage
Sie können unsere kostenlose Quartz Composition-Datei als Ausgangspunkt für Ihre benutzerdefinierten Ebenen verwenden. Sie enthält einen Basissatz von Ein- und Ausgängen und die erforderlichen Eigenschaften, die Sie im Dialog "Informationen bearbeiten" des Quartz Composers ändern müssen.

Ebenenvorlage v1.0 herunterladen

Das Hello-World-Beispiel

Als erstes und einfaches Beispiel werden wir eine einfache Quartz-Komposition erstellen und sie als Ebene in mimoLive verwenden.

1. Starten Sie die Anwendung Quartz Composer
2. Wählen Sie Datei ⇢ Neu leer in der Menüleiste. Sie erhalten ein neues leeres Quartz Composer-Dokument.
3. Öffnen Sie die Patch-Bibliothek mit der Schaltfläche in der oberen linken Ecke. Es öffnet sich ein kleines Fenster mit einer Liste aller Quartz Composer Patches.
4. Suchen Sie in der Patch-Bibliothek den Patch namens Billboard. Sie können dies schnell tun, indem Sie einige Anfangsbuchstaben des Patch-Namens in das Suchfeld am unteren Rand des Patch-Bibliothek-Fensters eintippen. Dies ist ein Render-Patch. Er zeichnet ein Bild flach auf den Ausgabebildschirm.
5. Ziehen Sie den Patch aus der Bibliothek in Ihr leeres Editorfenster. Der Patch bleibt dort, wo Sie ihn abgelegt haben. Sie können es verschieben, indem Sie es anklicken und ziehen. Bitte beachten Sie: Das Patch hat mehrere Eingänge, die mit einem Verbindungspunkt auf der linken Seite jedes Wertes markiert sind.
6. Suchen Sie nun in der Patch-Bibliothek das Patch "Bild mit Zeichenfolge" und ziehen Sie es in Ihr Editorfenster. Positionieren Sie es auf der rechten Seite des Billboard-Patches. Der Patch Image with String ist ein Generator-Patch, der ein Bild erzeugt, das einen Text enthält, den Sie mit dem Eingabewert String angeben können.
7. Verbinden Sie den Ausgang Image des Patches Image with String mit dem Eingang Image des Patches Billboard.
8. Wenn der Quartz Composer Viewer gerade nicht sichtbar ist, klicken Sie auf die Schaltfläche Viewer in der oberen rechten Ecke. Sie sollten ein Fenster mit einem Schachbrett im Hintergrund und "Hello World!" in weißen Buchstaben darüber sehen.
9. Kehren Sie zum Editor-Fenster zurück und klicken Sie mit der rechten Maustaste auf das Bild mit String-Patch, um ein Kontextmenü dafür zu öffnen.
10. Wählen Sie Eingangssplitter einfügen ⇢ String aus diesem Kontextmenü. Auf dem Dokument erscheint ein neues Feld vom Typ Eingabe-Splitter, das über seinen Ausgang mit dem Eingabe-String des Bild-mit-String-Feldes verbunden ist.
11. Klicken Sie erneut mit der rechten Maustaste auf diesen neu erstellten Eingangssplitter und wählen Sie Eingaben veröffentlichen ⇢ Eingabe. Es erscheint ein Textfeld, das nach dem Namen für diese veröffentlichte Eingabe fragt. Ändern Sie ihn in My Text. Bitte beachten Sie, dass diese veröffentlichte Eingabe für mimoLive sichtbar ist und in der Parameteransicht auf der linken Seite angezeigt wird, wenn die Ebene in mimoLive ausgewählt wird.
12. Öffnen Sie das Informationsblatt "Zusammensetzung", indem Sie Editor ⇢ Informationen bearbeiten.... Sie erhalten ein Blatt mit einer Liste von Schlüssel-Wert-Paaren.
13. Fügen Sie einen neuen Schlüssel hinzu, indem Sie unten links auf die Schaltfläche + klicken. In der Liste erscheint eine neue Zeile, in der Sie nach einem Schlüsselnamen gefragt werden.
14. Geben Sie tv_LayerProtocolVersion als Eigentumschalten Sie die Klasse von ''String'' auf ''Zahl'' und setzen Sie eine ''1'' in das Feld Wert Spalte.
15. Klicken Sie auf die Erledigt in der unteren linken Ecke, um das Blatt zu schließen.
16. Speichern Sie diese Komposition auf Ihrem Desktop unter dem Namen Hello World.qtz
17. Starten Sie mimoLive, erstellen Sie noch kein Dokument.
18. Wählen Sie Datei ⇢ Ebenenkompositionen importieren... in der Menüleiste. Es erscheint ein Dialog zur Dateiauswahl. Bitte wählen Sie die zuvor auf dem Desktop gespeicherte Datei Hello World.qtz aus.
19. Erstellen Sie nun ein neues mimoLive-Dokument mit Datei ⇢ Neu.... Der mimoLive Template Chooser wird angezeigt.
20. Wählen Sie die Vorlage "Blank" und klicken Sie auf die Schaltfläche "Auswählen" in der unteren rechten Ecke. Ein neues mimoLive-Dokument-Fenster wird angezeigt, das eine einzelne Placer-Ebene enthält, die Sie vor Ihrem Computer sitzend darstellt.
21. Öffnen Sie das Ebenen-Repository, indem Sie auf die "+"-Schaltfläche in der oberen rechten Ecke der Ebenenspalte klicken.
22. Suchen Sie die Ebene "Hello World", die Sie gerade importiert haben, und ziehen Sie eine Instanz an den oberen Rand des Ebenenstapels in der Mitte des Dokuments.
23. Suchen Sie Ihre selbst definierte Eingabe namens Mein Text und ändern Sie den Text des Eingabefeldes.
24. Nachdem Sie auf die Schaltfläche Live dieser Ebene geklickt haben, wird Ihr Text über dem Video angezeigt.

Herzlichen Glückwunsch! Sie haben gerade eine neue mimoLive-Ebene erstellt! In den folgenden Abschnitten wollen wir auf die Details eingehen, die notwendig sind, um ein guter mimoLive-Bürger zu sein.

Bitte beachten Sie, dass wir die Verwendung des Quartz Composer Editors in dieser Dokumentation nicht in allen Einzelheiten erklären können. Wenn Sie mehr über Quartz Composer erfahren möchten, lesen Sie bitte das Quartz Composer Benutzerhandbuch auf der Apple Developer Website.

Handhabung von Ebenen in mimoLive

Exportieren einer Ebene aus mimoLive

Wenn Sie eine eingebaute mimoLive-Ebene ändern möchten, können Sie diese Ebene mit den folgenden Schritten in mimoLive exportieren:

• Öffnen Sie das Ebenen-Repository mit der Schaltfläche "+" in der rechten oberen Ecke der Ebenenspalte.
• Suchen Sie die Ebene, die Sie als Basis für Ihre neue Ebene verwenden möchten, und wählen Sie sie aus.
• Öffnen Sie das Kontextmenü, indem Sie mit der rechten Maustaste auf die Ebene klicken.
• Wählen Sie Ebenenzusammensetzung exportieren... in diesem Kontextmenü.
• Sie werden aufgefordert, einen Dateinamen einzugeben und einen Speicherort für die Ebene festzulegen.

Importieren einer Ebene in mimoLive

Sobald Sie mit der Bearbeitung oder Erstellung Ihrer benutzerdefinierten Ebene fertig sind, müssen Sie Ihre Ebene in mimoLive importieren. Es gibt mehrere Möglichkeiten, eine Ebene in mimoLive zu importieren:

Importieren einer Ebene über das Menü Datei

• Wählen Sie Datei ⇢ Ebenenkompositionen importieren....
• Es wird ein Dialogfeld zur Dateiauswahl eingeblendet.
• Bitte wählen Sie Ihre QuartzComposition Datei und klicken Sie auf "Importieren".

Importieren einer Ebene mit der Dateinamenerweiterung ".tvlayer"

Diese Technik ist nützlich, wenn Sie benutzerdefinierte Ebenen an andere mimoLive-Benutzer (z. B. Ihre Kunden) senden, die mit dem manuellen Importieren benutzerdefinierter Ebenen nicht vertraut sind. Während der Entwicklung ist sie jedoch nicht sehr praktisch, da QuartzComposer die Datei nicht öffnet, wenn die Erweiterung geändert wird.

• Finden Sie Ihre Komposition im Finder.
• Klicken Sie einmal auf den Dateinamen, um den Namen der Datei zu ändern. Ein Kästchen um den Dateinamen zeigt an, dass Sie ihn gerade ändern.
• Fügen Sie die Erweiterung .tvlayer am Ende hinzu und drücken Sie den Zeilenschalter. Der Finder wird Sie fragen, ob Sie die Erweiterung wirklich ändern wollen. Bitte akzeptieren Sie.
• Doppelklicken Sie auf die Kompositionsdatei. Jetzt wird mimoLive die Datei automatisch öffnen und als neue Ebene importieren. Bei Erfolg werden Sie mit einer Meldung benachrichtigt.

Benutzerdefinierte Ebene API

mimoLive erwartet, dass die Quartz-Kompositionen die Benutzerdefinierte Ebene API. In diesem Abschnitt lernen Sie die minimale Implementierung kennen.

Minimale Implementierung

Die minimale Implementierung des Layer-Protokolls umfasst nur die Quartz Composition Properties, die im Quartz Composer-Editor durch Auswahl von Editor ⇢ Informationen bearbeiten (⌥⌘I).

Es ist wichtig zu wissen, wie diese Werte von mimoLive verwendet werden, damit mimoLive mit Versionskonflikten auf der Ebene umgehen kann.

• tv_LayerProtocolVersion: Immer wenn wir das Layer-Protokoll ändern, erhöhen wir die Layer-Protokollversion. Damit können ältere mimoLive-Versionen dem Benutzer mitteilen, wenn eine Schicht verwendet wird (z.B. in einem mimoLive-Dokument gespeichert), die eine neuere Protokollversion hat und daher von mimoLive nicht korrekt behandelt werden kann.
• tv_LayerIdentifier: Dieser Wert sollte ein eindeutiger Wert für jeden Ihrer Layer sein. Unsere Ebenen haben das Präfix com.boinx.layer.*. Bitte verwenden Sie Ihr eigenes Schema, um weltweit eindeutige Bezeichnungen zu haben. Bitte beachten Sie, dass mimoLive den Dateinamen nicht zum Vergleich von Layern verwendet!
• tv_LayerVersion: Wenn mimoLive für eine Ebene, die in einem Dokument gespeichert ist, eine andere Ebenenversion findet als für die Ebene, die im Ebenen-Repository installiert ist, verwendet es die folgenden Regeln, um zu entscheiden, was zu tun ist:
  - Wenn die Version der Dokumentenebene größer ist als die des Repository: Behalten Sie die Dokumentversion bei.
  - Wenn die Version der Dokumentenebene kleiner ist als die des Repositorys, aber die gleiche Hauptnummer hat (z. B. 2.4 gegenüber 2.6), dann ersetzen Sie die Dokumentenebene durch die neue.
  Wenn die Hauptversionsnummer der Ebene anders ist, wird mimoLive die Ebene als inkompatiblen Ersatz behandeln und die Dokumentenebene nicht aktualisieren!

Ergänzungen zum Gemeinschaftseigentum

• Urheberrecht:
• Beschreibung:
• Name:
• tv_Tagline: