mimoLive® - Manuale d'uso

Selettori generici
Solo corrispondenze esatte
Ricerca nel titolo
Ricerca nel contenuto
Selettori del tipo di post

Manuale - Tabella dei contenuti

Livelli personalizzati

Indice dei contenuti

mimoLive può essere personalizzato aggiungendo nuovi livelli. La vera potenza dei livelli sta nel fatto che sono realizzati con una tecnologia di MacOS X chiamata Quartz Composer. Quasi tutto è possibile con Quartz Composer. È possibile creare programmi televisivi interattivi in cui il pubblico può inviare SMS o messaggi di Twitter che vengono visualizzati sullo schermo. Creare grafici azionari da dati online. Tenere i punteggi di una partita sportiva. Giocare a giochi sullo schermo. Potreste trovare ispirazione in alcuni dei livelli inclusi in mimoLive. Per funzionare con mimoLive, le Composizioni Quartz devono contenere alcuni elementi in modo che mimoLive e il livello possano parlare tra loro e che il livello possa visualizzare i file multimediali che mimoLive gli invia. In teoria, chiunque può creare i propri livelli. Questa pagina descrive a livello tecnico come creare livelli utilizzando Quartz Composer.

Acquisto di un livello personalizzato

Se non si vuole lavorare su Quartz Composer, possiamo farlo noi. Abbiamo una vasta esperienza nella creazione di livelli per mimoLive, compresa la visualizzazione di dati come i grafici azionari, che può essere sfruttata per creare il livello giusto per voi. Per favore contattare il reparto vendite per i dettagli.

Creazione di un livello personalizzato - Operazioni preliminari

Livelli di codifica Masterclass per mimoLive

Pre-richieste

Ci sono alcuni prerequisiti prima di poter iniziare a sviluppare livelli per mimoLive:

  • È necessario disporre di una licenza mimoLive valida per testare ed eseguire i livelli in mimoLive.
  • È necessario aver installato l'applicazione Quartz Composer di Apple. Si tratta di uno strumento di sviluppo gratuito che si può scaricare dal sito web di Apple dedicato agli sviluppatori. Tuttavia, è necessario registrarsi prima come sviluppatore Mac (http://developer.apple.com). Qui è possibile trovare Guida all'uso di Quartz Composer da Apple.
  • Patch Lua - Per aprire i livelli di mimoLive in Quartz Composer a partire da mimoLive 1.9 è necessaria la patch Lua. È open source e disponibile su GitHub. Questa patch sostituisce la patch JavaScript di QuartzComposer perché non funziona in modo stabile in mimoLive. (Scaricare la patch da qui:[https://github.com/boinx/QCLua/releases )
  • JSON Toppa e Patch OAuth - Esistono altre due patch personalizzate, attualmente utilizzate solo nel livello Twitter. Quando si personalizza il livello Twitter, è necessario scaricare e installare le patch prima di iniziare la modifica.

Modello di livello vuoto
È possibile utilizzare il nostro file Quartz Composition gratuito come punto di partenza per i propri livelli personalizzati. Contiene un set di base di ingressi e uscite e le proprietà necessarie da modificare nella finestra di dialogo "Modifica informazioni" di Quartz Composer.

Scarica Layer Template v1.0

L'esempio di Hello-World

Come primo e semplice esempio, creeremo una composizione Quartz di base e la utilizzeremo come livello in mimoLive.

  1. Avviare l'applicazione Quartz Composer
  2. Scegliere File ⇢ Nuovo spazio vuoto nella barra dei menu. Si otterrà un nuovo documento Quartz Composer vuoto.
  3. Aprire la Libreria patch con il pulsante nell'angolo in alto a sinistra. Si aprirà una piccola finestra con un elenco di tutte le patch di Quartz Composer.
  4. Nella Libreria patch trovare la patch denominata Billboard. È possibile farlo rapidamente digitando alcune lettere iniziali del nome della patch nel campo di ricerca in fondo alla finestra della Libreria patch. Si tratta di una patch di rendering. Disegna un'immagine piatta sullo schermo di uscita.
  5. Trascinate la patch dalla libreria alla finestra vuota dell'editor. La patch rimarrà lì dove l'avete lasciata. È possibile spostarla trascinandola con un clic. Nota bene: la patch ha diversi ingressi che sono contrassegnati da un punto di connessione sul lato sinistro di ciascun valore.
  6. Ora trovate la patch Immagine con stringa nella Libreria patch e trascinatela nella finestra dell'editor. Posizionatela sul lato destro della patch Billboard. La patch Immagine con stringa è una patch Generatore che genera un'immagine contenente un testo che si può specificare con il valore di input String.
  7. Collegare l'uscita Image del patch Image with String con l'ingresso Image del patch Billboard.
  8. Se il Quartz Composer Viewer non è ancora visibile, fare clic sul pulsante Viewer nell'angolo in alto a destra. Dovrebbe apparire una finestra con una scacchiera sullo sfondo e "Hello World!" in lettere bianche sopra di essa.
  9. Tornate alla finestra dell'Editor e fate clic con il tasto destro del mouse sulla patch Immagine con stringa per visualizzare il relativo menu contestuale.
  10. Selezionare Inserire lo splitter di ingresso ⇢ Stringa del menu contestuale. Sul documento apparirà una nuova patch di tipo Input Splitter, collegata in uscita alla stringa di ingresso della patch Image With String.
  11. Fate nuovamente clic con il tasto destro del mouse su questo splitter di ingresso appena creato e selezionate Pubblicare gli ingressi ⇢ Ingresso. Viene visualizzata una casella di testo che chiede il nome di questo input pubblicato. Modificarlo in Testo personale. Si noti che questo input pubblicato è visibile a mimoLive e sarà presentato nella vista dei parametri a sinistra quando il layer è selezionato in mimoLive.
  12. Aprire il Foglio informativo di composizione selezionando Editor ⇢ Modifica informazioni.... Si otterrà un foglio con un elenco di coppie chiave-valore.
  13. Aggiungere una nuova chiave facendo clic sul pulsante + in basso a sinistra. Nell'elenco apparirà una nuova riga con la richiesta del nome della chiave.
  14. Immettere tv_LayerProtocolVersion come parametro Proprietà, commutare il Classe da ''Stringa'' a ''Numero'' e inserire un ''1'' nell'opzione Valore colonna.
  15. Fare clic sul pulsante Fatto nell'angolo in basso a sinistra per chiudere il foglio.
  16. Salvare questa composizione sul desktop con il nome Hello World.qtz
  17. Avviare mimoLive, non creare ancora un documento.
  18. Selezionare File ⇢ Importazione di composizioni di livelli... dalla barra dei menu. Verrà visualizzata una finestra di dialogo per la scelta del file. Selezionate il file Hello World.qtz precedentemente salvato sul Desktop.
  19. Creare ora un nuovo documento mimoLive con File ⇢ Nuovo.... Verrà visualizzato il Template Chooser di mimoLive.
  20. Selezionare il modello Blank e premere il pulsante Choose nell'angolo in basso a destra. Verrà visualizzata una nuova finestra di mimoLive Document contenente un singolo livello Placer che ritrae l'utente seduto davanti al computer.
  21. Aprire il Repository dei livelli facendo clic sul pulsante "+" nell'angolo superiore destro della colonna Livelli.
  22. Individuare il livello Hello World appena importato e trascinarne un'istanza in cima alla pila dei livelli al centro del documento.
  23. Individuare l'input autodefinito chiamato Il mio testo e modificare il testo del campo di input.
  24. Dopo aver fatto clic sul pulsante Live di quel livello, il testo apparirà sul video.

Congratulazioni! Avete appena creato un nuovo livello mimoLive! Nelle sezioni seguenti vogliamo approfondire ciò che è necessario per essere un buon cittadino di mimoLive.

Si noti che in questa documentazione non è possibile spiegare in dettaglio come utilizzare Quartz Composer Editor. Se volete saperne di più su Quartz Composer, leggete la Guida dell'utente di Quartz Composer sul sito web degli sviluppatori Apple.

Gestione dei livelli in mimoLive

Esportazione di un livello da mimoLive

Se si desidera modificare un livello mimoLive incorporato, è possibile esportarlo in mimoLive con i seguenti passaggi:

  • Aprire l'archivio dei livelli con il pulsante "+" nell'angolo superiore destro della colonna Livelli.
  • Individuare e selezionare il livello che si desidera utilizzare come base per il nuovo livello.
  • Aprire il menu contestuale facendo clic con il pulsante destro del mouse sul livello.
  • Selezionare Esportazione della composizione dei livelli... in quel menu contestuale.
  • Verrà chiesto di inserire un nome di file e di impostare una posizione in cui salvare il livello.

Importare un livello in mimoLive

Una volta terminata la modifica o la creazione del livello personalizzato, è necessario importare il livello in mimoLive. Esistono diversi modi per importare un livello in mimoLive:

Importare un livello utilizzando il menu File
  • Selezionare File ⇢ Importazione di composizioni di livelli....
  • Verrà visualizzata una finestra di dialogo per la scelta dei file.
  • Selezionare il file QuartzComposition e premere "Importa".
Importare un livello utilizzando l'estensione del nome del file ".tvlayer".

Questa tecnica è utile quando si inviano livelli personalizzati ad altri utenti di mimoLive (ad esempio i clienti) che non hanno familiarità con l'importazione manuale di livelli personalizzati. Tuttavia, non è molto utile durante lo sviluppo, perché QuartzComposer non apre il file quando si cambia l'estensione.

  • Trovate la vostra composizione nel Finder.
  • Fare clic una volta sul nome del file per modificarlo. Un riquadro attorno al nome del file indica che si sta per modificarlo.
  • Aggiungete l'estensione .tvlayer alla fine e premete Return. Il Finder vi chiederà se volete davvero cambiare l'estensione. Accettate.
  • Fare doppio clic sul file di composizione. Ora mimoLive aprirà e importerà automaticamente il file come nuovo livello. Al termine dell'operazione, verrà visualizzato un avviso.

Strato personalizzato API

mimoLive si aspettano che le Composizioni al quarzo adottino il Strato personalizzato API. In questa sezione si apprenderà l'implementazione minima.

Implementazione minima

L'implementazione minima del Protocollo di livello coinvolge solo le Proprietà di composizione di Quartz, che possono essere modificate nell'editor di Quartz Composer selezionando Editor ⇢ Modifica informazioni (⌥⌘I).

NomeTipoValore del campione
tv_LayerProtocolVersionNumero (reale)1.2
tv_LayerIdentifierStringacom.example.layer.mylayer
tv_LayerVersionNumero (reale)1.01

È importante sapere come questi valori vengono usati da mimoLive, in modo che mimoLive possa gestire i conflitti di versione dei livelli.

  • tv_LayerProtocolVersion: Quando cambiamo il protocollo del livello, aumentiamo la versione del protocollo del livello. In questo modo le versioni più vecchie di mimoLive sono in grado di dire all'utente se viene utilizzato un livello (ad esempio memorizzato in un documento mimoLive) che ha una versione di protocollo più recente e quindi potrebbe non essere trattato correttamente da mimoLive.
  • tv_LayerIdentifier: Questo valore deve essere unico per ogni livello. I nostri livelli hanno il prefisso com.boinx.layer.*. Si prega di utilizzare il proprio schema per avere identificatori unici in tutto il mondo. Si noti che mimoLive non usa il nome del file per confrontare i livelli!
  • tv_LayerVersion: Se mimoLive trova la versione del livello diversa per un livello memorizzato in un documento rispetto al livello installato nel repository dei livelli, utilizza le seguenti regole per decidere cosa fare:
    - Se la versione del livello del documento è superiore a quella del repository: mantenere la versione del documento
    - Se la versione del livello del documento è inferiore a quella del repository, ma con lo stesso numero maggiore (ad esempio, 2.4 vs 2.6), sostituire il livello del documento con quello nuovo.
    Se il numero maggiore della versione del livello è diverso, mimoLive tratterà il livello come una sostituzione incompatibile e non aggiornerà il livello del documento!

Aggiunte alla proprietà comune

  • copyright:
  • descrizione:
  • nome:
  • tv_Tagline:

Il vostro feedback

Come valuta la sua esperienza con questa funzione di mimoLive?

Newsletter via e-mail

Italiano

Partecipate alla dimostrazione Zoom® in diretta 24/7

*necessario