{"id":32482,"date":"2023-03-08T15:12:49","date_gmt":"2023-03-08T14:12:49","guid":{"rendered":"https:\/\/mimolive.com\/?post_type=user-manual&#038;p=32482"},"modified":"2025-06-16T19:00:05","modified_gmt":"2025-06-16T17:00:05","slug":"strati-personalizzati","status":"publish","type":"user-manual","link":"https:\/\/mimolive.com\/it\/user-manual\/custom-layers\/","title":{"rendered":"Strati personalizzati"},"content":{"rendered":"<p>mimoLive pu\u00f2 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 \u00e8 possibile con Quartz Composer. \u00c8 possibile creare programmi televisivi interattivi in cui il pubblico pu\u00f2 inviare <span class=\"caps\">SMS<\/span> 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\u00f2 creare i propri livelli. Questa pagina descrive a livello tecnico come creare livelli utilizzando Quartz Composer.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"purchasing-a-custom-layer\">Acquisto di un livello personalizzato<\/h3>\n\n\n\n<p>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\u00f2 essere sfruttata per creare il livello giusto per voi. Per favore <a href=\"https:\/\/boinx.com\/contact\/\" target=\"_blank\" rel=\"noreferrer noopener\">contattare il reparto vendite<\/a> per i dettagli.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"creating-a-custom-layer---getting-started\">Creazione di un livello personalizzato - Operazioni preliminari<\/h3>\n\n\n\n<p><a href=\"https:\/\/www.youtube.com\/watch?v=JudWtmnDTbE\" target=\"_blank\" rel=\"noreferrer noopener\">Livelli di codifica Masterclass per mimoLive<\/a><\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"pre-requisitions\">Pre-richieste<\/h4>\n\n\n\n<p>Ci sono alcuni prerequisiti prima di poter iniziare a sviluppare livelli per mimoLive:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u00c8 necessario disporre di una licenza mimoLive valida per testare ed eseguire i livelli in mimoLive.<\/li>\n\n\n\n<li>\u00c8 necessario aver installato l'applicazione Quartz Composer di Apple. Si tratta di uno strumento di sviluppo gratuito che si pu\u00f2 scaricare dal sito web di Apple dedicato agli sviluppatori. Tuttavia, \u00e8 necessario registrarsi prima come sviluppatore Mac (http:\/\/developer.apple.com). Qui \u00e8 possibile trovare <a href=\"https:\/\/developer.apple.com\/library\/mac\/#documentation\/graphicsimaging\/conceptual\/QuartzComposerUserGuide\/qc_intro\/qc_intro.html\" target=\"_blank\" rel=\"noreferrer noopener\">Guida all'uso di Quartz Composer<\/a> da Apple.<\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/boinx\/QCLua\" target=\"_blank\" rel=\"noreferrer noopener\">Patch Lua<\/a> - Per aprire i livelli di mimoLive in Quartz Composer a partire da mimoLive 1.9 \u00e8 necessaria la patch Lua. \u00c8 open source e disponibile su GitHub. Questa patch sostituisce la patch JavaScript di QuartzComposer perch\u00e9 non funziona in modo stabile in mimoLive. (Scaricare la patch da qui:<a href=\"https:\/\/github.com\/boinx\/QCLua\/releases\" target=\"_blank\" rel=\"noreferrer noopener\">[https:\/\/github.com\/boinx\/QCLua\/releases<\/a> )<\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/boinx\/QCJSON\" target=\"_blank\" rel=\"noreferrer noopener\"><span class=\"caps\">JSON<\/span> Toppa<\/a> e <a href=\"https:\/\/github.com\/boinx\/QCOAuth\" target=\"_blank\" rel=\"noreferrer noopener\">Patch OAuth<\/a> - Esistono altre due patch personalizzate, attualmente utilizzate solo nel livello Twitter. Quando si personalizza il livello Twitter, \u00e8 necessario scaricare e installare le patch prima di iniziare la modifica.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"blank-layer-template\">Modello di livello vuoto<br>\u00c8 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\u00e0 necessarie da modificare nella finestra di dialogo \"Modifica informazioni\" di Quartz Composer.<\/h4>\n\n\n\n<p><a href=\"http:\/\/boinx.com\/software\/mimolive\/layers\/layer_template.zip\" target=\"_blank\" rel=\"noreferrer noopener\">Scarica Layer Template v1.0<\/a><\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"the-hello-world-example\">L'esempio di Hello-World<\/h4>\n\n\n\n<p>Come primo e semplice esempio, creeremo una composizione Quartz di base e la utilizzeremo come livello in mimoLive.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Avviare l'applicazione Quartz Composer<\/li>\n\n\n\n<li>Scegliere <b>File \u21e2 Nuovo spazio vuoto<\/b> nella barra dei menu. Si otterr\u00e0 un nuovo documento Quartz Composer vuoto.<\/li>\n\n\n\n<li>Aprire la Libreria patch con il pulsante nell'angolo in alto a sinistra. Si aprir\u00e0 una piccola finestra con un elenco di tutte le patch di Quartz Composer.<\/li>\n\n\n\n<li>Nella Libreria patch trovare la patch denominata Billboard. \u00c8 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.<\/li>\n\n\n\n<li>Trascinate la patch dalla libreria alla finestra vuota dell'editor. La patch rimarr\u00e0 l\u00ec dove l'avete lasciata. \u00c8 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.<\/li>\n\n\n\n<li>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 \u00e8 una patch Generatore che genera un'immagine contenente un testo che si pu\u00f2 specificare con il valore di input String.<\/li>\n\n\n\n<li>Collegare l'uscita Image del patch Image with String con l'ingresso Image del patch Billboard.<\/li>\n\n\n\n<li>Se il Quartz Composer Viewer non \u00e8 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.<\/li>\n\n\n\n<li>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.<\/li>\n\n\n\n<li>Selezionare <b>Inserire lo splitter di ingresso \u21e2 Stringa<\/b> del menu contestuale. Sul documento apparir\u00e0 una nuova patch di tipo Input Splitter, collegata in uscita alla stringa di ingresso della patch Image With String.<\/li>\n\n\n\n<li>Fate nuovamente clic con il tasto destro del mouse su questo splitter di ingresso appena creato e selezionate <b>Pubblicare gli ingressi \u21e2 Ingresso<\/b>. Viene visualizzata una casella di testo che chiede il nome di questo input pubblicato. Modificarlo in Testo personale. Si noti che questo input pubblicato \u00e8 visibile a mimoLive e sar\u00e0 presentato nella vista dei parametri a sinistra quando il layer \u00e8 selezionato in mimoLive.<\/li>\n\n\n\n<li>Aprire il Foglio informativo di composizione selezionando <b>Editor \u21e2 Modifica informazioni...<\/b>. Si otterr\u00e0 un foglio con un elenco di coppie chiave-valore.<\/li>\n\n\n\n<li>Aggiungere una nuova chiave facendo clic sul pulsante + in basso a sinistra. Nell'elenco apparir\u00e0 una nuova riga con la richiesta del nome della chiave.<\/li>\n\n\n\n<li>Immettere tv_LayerProtocolVersion come parametro <b>Propriet\u00e0<\/b>, commutare il <b>Classe<\/b> da ''Stringa'' a ''Numero'' e inserire un ''1'' nell'opzione <b>Valore<\/b> colonna.<\/li>\n\n\n\n<li>Fare clic sul pulsante <b>Fatto<\/b> nell'angolo in basso a sinistra per chiudere il foglio.<\/li>\n\n\n\n<li>Salvare questa composizione sul desktop con il nome Hello World.qtz<\/li>\n\n\n\n<li>Avviare mimoLive, non creare ancora un documento.<\/li>\n\n\n\n<li>Selezionare <b>File \u21e2 Importazione di composizioni di livelli...<\/b> dalla barra dei menu. Verr\u00e0 visualizzata una finestra di dialogo per la scelta del file. Selezionate il file Hello World.qtz precedentemente salvato sul Desktop.<\/li>\n\n\n\n<li>Creare ora un nuovo documento mimoLive con <b>File \u21e2 Nuovo...<\/b>. Verr\u00e0 visualizzato il Template Chooser di mimoLive.<\/li>\n\n\n\n<li>Selezionare il modello Blank e premere il pulsante Choose nell'angolo in basso a destra. Verr\u00e0 visualizzata una nuova finestra di mimoLive Document contenente un singolo livello Placer che ritrae l'utente seduto davanti al computer.<\/li>\n\n\n\n<li>Aprire il Repository dei livelli facendo clic sul pulsante \"+\" nell'angolo superiore destro della colonna Livelli.<\/li>\n\n\n\n<li>Individuare il livello Hello World appena importato e trascinarne un'istanza in cima alla pila dei livelli al centro del documento.<\/li>\n\n\n\n<li>Individuare l'input autodefinito chiamato Il mio testo e modificare il testo del campo di input.<\/li>\n\n\n\n<li>Dopo aver fatto clic sul pulsante Live di quel livello, il testo apparir\u00e0 sul video.<\/li>\n<\/ol>\n\n\n\n<p>Congratulazioni! Avete appena creato un nuovo livello mimoLive! Nelle sezioni seguenti vogliamo approfondire ci\u00f2 che \u00e8 necessario per essere un buon cittadino di mimoLive.<\/p>\n\n\n\n<p>Si noti che in questa documentazione non \u00e8 possibile spiegare in dettaglio come utilizzare Quartz Composer Editor. Se volete saperne di pi\u00f9 su Quartz Composer, leggete la Guida dell'utente di Quartz Composer sul sito web degli sviluppatori Apple.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Gestione dei livelli in mimoLive<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"exporting-a-layer-from-mimolive\">Esportazione di un livello da mimoLive<\/h4>\n\n\n\n<p>Se si desidera modificare un livello mimoLive incorporato, \u00e8 possibile esportarlo in mimoLive con i seguenti passaggi:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Aprire l'archivio dei livelli con il pulsante \"+\" nell'angolo superiore destro della colonna Livelli.<\/li>\n\n\n\n<li>Individuare e selezionare il livello che si desidera utilizzare come base per il nuovo livello.<\/li>\n\n\n\n<li>Aprire il menu contestuale facendo clic con il pulsante destro del mouse sul livello.<\/li>\n\n\n\n<li>Selezionare <b>Esportazione della composizione dei livelli...<\/b> in quel menu contestuale.<\/li>\n\n\n\n<li>Verr\u00e0 chiesto di inserire un nome di file e di impostare una posizione in cui salvare il livello.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"importing-a-layer-in-mimolive\">Importare un livello in mimoLive<\/h4>\n\n\n\n<p>Una volta terminata la modifica o la creazione del livello personalizzato, \u00e8 necessario importare il livello in mimoLive. Esistono diversi modi per importare un livello in mimoLive:<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Importare un livello utilizzando il menu File<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Selezionare File \u21e2 Importazione di composizioni di livelli....<\/li>\n\n\n\n<li>Verr\u00e0 visualizzata una finestra di dialogo per la scelta dei file.<\/li>\n\n\n\n<li>Selezionare il file QuartzComposition e premere \"Importa\".<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">Importare un livello utilizzando l'estensione del nome del file \".tvlayer\".<\/h5>\n\n\n\n<p>Questa tecnica \u00e8 utile quando si inviano livelli personalizzati ad altri utenti di mimoLive (ad esempio i clienti) che non hanno familiarit\u00e0 con l'importazione manuale di livelli personalizzati. Tuttavia, non \u00e8 molto utile durante lo sviluppo, perch\u00e9 QuartzComposer non apre il file quando si cambia l'estensione.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Trovate la vostra composizione nel Finder.<\/li>\n\n\n\n<li>Fare clic una volta sul nome del file per modificarlo. Un riquadro attorno al nome del file indica che si sta per modificarlo.<\/li>\n\n\n\n<li>Aggiungete l'estensione .tvlayer alla fine e premete Return. Il Finder vi chieder\u00e0 se volete davvero cambiare l'estensione. Accettate.<\/li>\n\n\n\n<li>Fare doppio clic sul file di composizione. Ora mimoLive aprir\u00e0 e importer\u00e0 automaticamente il file come nuovo livello. Al termine dell'operazione, verr\u00e0 visualizzato un avviso.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"custom-layer-api\">Strato personalizzato <span class=\"caps\">API<\/span><\/h3>\n\n\n\n<p>mimoLive si aspettano che le Composizioni al quarzo adottino il <a href=\"https:\/\/mimolive.com\/it\/manuale-duso\/strato-api-personalizzato\/\">Strato personalizzato <span class=\"caps\">API<\/span><\/a>. In questa sezione si apprender\u00e0 l'implementazione minima.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"minimal-implementation\">Implementazione minima<\/h4>\n\n\n\n<p>L'implementazione minima del Protocollo di livello coinvolge solo le Propriet\u00e0 di composizione di Quartz, che possono essere modificate nell'editor di Quartz Composer selezionando <b>Editor \u21e2 Modifica informazioni (\u2325\u2318I)<\/b>.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><th>Nome<\/th><th>Tipo<\/th><th>Valore del campione<\/th><\/tr><tr><td>tv_LayerProtocolVersion<\/td><td>Numero (reale)<\/td><td>1.2<\/td><\/tr><tr><td>tv_LayerIdentifier<\/td><td>Stringa<\/td><td>com.example.layer.mylayer<\/td><\/tr><tr><td>tv_LayerVersion<\/td><td>Numero (reale)<\/td><td>1.01<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>\u00c8 importante sapere come questi valori vengono usati da mimoLive, in modo che mimoLive possa gestire i conflitti di versione dei livelli.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>tv_LayerProtocolVersion: Quando cambiamo il protocollo del livello, aumentiamo la versione del protocollo del livello. In questo modo le versioni pi\u00f9 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\u00f9 recente e quindi potrebbe non essere trattato correttamente da mimoLive.<\/li>\n\n\n\n<li>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!<\/li>\n\n\n\n<li>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:<br>- Se la versione del livello del documento \u00e8 superiore a quella del repository: mantenere la versione del documento<br>- Se la versione del livello del documento \u00e8 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.<br>Se il numero maggiore della versione del livello \u00e8 diverso, mimoLive tratter\u00e0 il livello come una sostituzione incompatibile e non aggiorner\u00e0 il livello del documento!<\/li>\n<\/ul>\n\n\n\n<p>Aggiunte alla propriet\u00e0 comune<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>copyright:<\/li>\n\n\n\n<li>descrizione:<\/li>\n\n\n\n<li>nome:<\/li>\n\n\n\n<li>tv_Tagline:<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"<p>mimoLive can be customized by adding new layers. The real power of layers lies in the fact that they are actually made with a MacOS X technology called Quartz Composer. Almost anything is possible with Quartz Compositions. You can create interactive TV shows where your audience can send in SMS or twitter messages which are [&hellip;]<\/p>","protected":false},"author":3,"featured_media":0,"parent":0,"menu_order":8,"template":"","meta":{"_acf_changed":false,"_angie_page":false,"_lmt_disableupdate":"no","_lmt_disable":"","footnotes":""},"categories":[258],"tags":[],"class_list":["post-32482","user-manual","type-user-manual","status-publish","hentry","category-manual"],"acf":[],"_links":{"self":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32482","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual"}],"about":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/types\/user-manual"}],"author":[{"embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/users\/3"}],"version-history":[{"count":1,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32482\/revisions"}],"predecessor-version":[{"id":40923,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32482\/revisions\/40923"}],"wp:attachment":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/media?parent=32482"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/categories?post=32482"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/tags?post=32482"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}