{"id":32488,"date":"2023-03-08T16:32:47","date_gmt":"2023-03-08T15:32:47","guid":{"rendered":"https:\/\/mimolive.com\/?post_type=user-manual&#038;p=32488"},"modified":"2026-03-17T14:28:58","modified_gmt":"2026-03-17T13:28:58","slug":"punti-finali","status":"publish","type":"user-manual","link":"https:\/\/mimolive.com\/it\/user-manual\/remote-control-automation\/http-api\/endpoints\/","title":{"rendered":"Punti finali"},"content":{"rendered":"<section class=\"boinx_exclamation\">\n    <div class=\"main_div_exclamation\">\n        <div class=\"left_div_icon_exclamation\">\n                <i class=\"icon_exclamation\">\u2757<\/i>\n        <\/div>\n\n        <div class=\"right_div_text_exclamation\">\n                <div><p class=\"text_exclamation_headline\">Utilizza Claude, Codex, Github Copilot o altre AI di codifica?<\/p><\/div>\n                <div><p class=\"text_exclamation\">Controlli il <a href=\"https:\/\/github.com\/boinx\/mimoLive-API-Reference\" target=\"_blank\" rel=\"noopener\">Riferimento API mimoLive<\/a>. Lo inserisca nel suo agente di codifica AI preferito e utilizzi immediatamente l'API mimoLive in modo corretto.<\/p><\/div>\n        <\/div>    \n    <\/div>\n<\/section>\n\n\t\t<style>.boinx_exclamation {\n    margin:30px 0;\n    padding:10px;\n    background-color:rgb(242,222,222);\n    border-radius: 8px;\n}\n.icon_exclamation {\n    display:block;\n    padding:5px;\n    font-size:80px;\n    color:rgb(184,74,72);\n    line-height:60px;\n}\n.text_exclamation {\n    color:rgb(184,74,72);\n}\n\n.text_exclamation_headline{\n    font-weight:bold;\n    color:rgb(184,74,72);\n}\n\n\n.main_div_exclamation\n{\n    display:flex !IMPORTANT;\n    flex-wrap: wrap;\n    flex-direction: row;\n    justify-content : flex-start;\n    align-items : flex-start\n    align-content : flex-start;\n    \n}\n\n.left_div_icon_exclamation{\n    display:flex !IMPORTANT;\n    width:80px;\n    padding:10px;\n    margin:20px 20px 20px 0;\n    height:40px;\n}\n.right_div_text_exclamation{\n    display:flex !IMPORTANT;\n    flex-direction: column;\n    flex-grow: 1;\n    width:200px;\n    padding:10px;\n    margin:0;\n}<\/style>\n\t\t\n\n\n<h2 class=\"wp-block-heading\">Generale<\/h2>\n\n\n\n<p>Il <span class=\"caps\">API<\/span>, se abilitata, \u00e8 disponibile all'indirizzo \"http:\/\/localhost:8989\/api\/v1\". Questa \u00e8 la base <span class=\"caps\">URL<\/span> che deve essere anteposto ad ogni metodo <span class=\"caps\">URL<\/span> elencati di seguito.<\/p>\n\n\n\n<p>Se una risorsa \u00e8 stata introdotta dopo il lancio iniziale dell'applicazione <span class=\"caps\">HTTP<\/span> <span class=\"caps\">API<\/span>, il metodo \u00e8 contrassegnato da un simbolo <strong>Disponibile da<\/strong> informazioni.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Reindirizza all'elenco dei documenti aperti in \"\/documents\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/dispositivi<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d<br>Restituisce un elenco di prodotti attualmente disponibili <strong>dispositivi video<\/strong> sul sistema host. Ogni voce contiene un identificatore e un nome leggibile dall'uomo. Utile per mappare i dispositivi di acquisizione alle Sorgenti.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/dispositivi\/(DeviceID)<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d<br>Restituisce i dettagli del dispositivo specificato da \u201c(DeviceID)\u201d, compreso il nome e le propriet\u00e0.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Documenti<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Interrogazione dei documenti<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Visualizza un elenco di documenti aperti. Vedere il tipo di dati documents per sapere quali informazioni contengono gli oggetti restituiti.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\u201d, <strong>\"<span class=\"caps\">INSERIRE<\/span>\"<\/strong><\/strong><br>Restituisce un singolo documento specificato da \"(DocumentID)\". Nella sezione inclusa della risposta verranno restituiti anche tutti gli oggetti \"layer\" utilizzati da questo documento e tutti gli oggetti \"source\" contenuti in questo documento (sideloading). Per ulteriori informazioni sui dati restituiti, vedere il tipo di dati documents.<\/p>\n\n\n\n<p>PUT aggiorna le propriet\u00e0 a livello di documento, come il volume master di uscita del programma e i metadati dello spettacolo (titolo, autore, risoluzione, frame rate, sample rate e altro). Invii solo i campi che desidera modificare.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/programmaOut<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>L'output del programma attualmente prodotto dal documento specificato da \"(DocumentID)\".<br>Assume gli stessi parametri delle anteprime della sorgente.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Azioni del documento<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/setLive<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Avvia uno spettacolo\/documento e attiva tutti gli eventi associati. Il richiamo di questo comando su un documento gi\u00e0 in esecuzione non produrr\u00e0 un errore. Verr\u00e0 restituito l'oggetto documento aggiornato.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/setOff<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Arresta uno spettacolo\/documento. Se si chiama questo comando su uno spettacolo gi\u00e0 arrestato, non si verificher\u00e0 alcun errore. Verr\u00e0 restituito l'oggetto documento aggiornato.<\/p>\n\n\n\n<p><i>*<\/i>Poich\u00e9 un documento pu\u00f2 decidere di continuare a funzionare anche dopo aver chiamato questo metodo, l'oggetto layer restituito potrebbe essere nello stato \"shutdown\" anzich\u00e9 \"off\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/toggleLive<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Alterna uno spettacolo\/documento tra live e off.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Strati<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Creazione di livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>POST \/documenti\/(ID documento)\/layers<\/strong><\/h4>\n\n\n\n<p>Crea un nuovo livello da un modello di livello e lo inserisce nella pila di livelli del documento. Specifica il modello tramite il suo identificatore di livello e, facoltativamente, imposta la posizione nella pila, un nome e i valori di input iniziali. Restituisce l'oggetto livello appena creato.<br><br><\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -X POST \"http:\/\/localhost:8989\/api\/v1\/documents\/(DocumentID)\/layers\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"layer-identifier\": \"com.boinx.mimoLive.layer.lowerthird\",\n    \"index\": 4,\n    \"name\": \"My Lower Third\"\n  }'\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Interrogazione dei livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">GET \/documenti\/(ID documento)\/layers<\/h4>\n\n\n\n<p>Restituisce un elenco di livelli per il documento specificato da \"(DocumentID)\". Per informazioni sugli oggetti restituiti, vedere il tipo di dati layers.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(DocumentID)\/layers\/(LayerID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\", \"<span class=\"caps\">INSERIRE<\/span>\"<\/strong><br>Restituisce un singolo livello specificato da \"(LayerID)\" nel documento specificato da \"(DocumentID)\". Nella sezione \"incluso\" della risposta verranno restituiti anche tutti gli oggetti \"variant\" relativi a questo livello (sideloading). Per ulteriori informazioni sui dati restituiti, consultare il tipo di dati dei livelli. Si tenga presente che i \"valori di input\" dell'endpoint del layer riflettono i \"valori di input\" della variante \"liveVariant\" associata.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Modifica di un livello<\/h3>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\", \"<span class=\"caps\">INSERIRE<\/span>\"<\/strong><br>Per impostare il nome del livello, il volume audio o i valori di ingresso, eseguire un'operazione di \"<span class=\"caps\">INSERIRE<\/span>\" con una richiesta <span class=\"caps\">JSON<\/span> all'endpoint del livello. In alternativa, si pu\u00f2 usare un oggetto \"<span class=\"caps\">GET<\/span>\" aggiungendo l'opzione <span class=\"caps\">JSON<\/span> dati al sistema <span class=\"caps\">URL<\/span> con la chiave \"?update=\". In questo caso l'elemento <span class=\"caps\">JSON<\/span> i dati devono essere <span class=\"caps\">URL<\/span> codificato.<\/p>\n\n\n\n<p>I valori che non si vogliono modificare devono essere semplicemente esclusi dal file <span class=\"caps\">JSON<\/span> dati. Esempio:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>{\n    \"name\": \"New name of the Layer\",\n    \"volume\": 0.5,\n    \"input-values\": { \n        \"tvGroup_Content__Subtitle\": \"This is a Test\"\n    }\n}<\/code><\/pre>\n\n\n\n<p>Dopo aver aggiornato i valori, mimoLive risponder\u00e0 con un oggetto layer aggiornato. Tenere presente che non tutti i valori possono essere applicati istantaneamente o possono avere effetto solo dopo un altro ciclo di rendering.<\/p>\n\n\n\n<p>Nota: l'attributo \"volume\" \u00e8 stato aggiunto in mimoLive 5.6 e viene ignorato nelle versioni precedenti o se il livello non ha un controllo del volume. Il valore sar\u00e0 ritagliato su (0, 1), dove 0 \u00e8 silenzioso e 1 \u00e8 il volume massimo.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Eliminazione di un livello<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">DELETE \/documents\/(DocumentID)\/layers\/(LayerID)<\/h4>\n\n\n\n<p>Rimuove il livello specificato dal documento. Restituisce 204 No Content in caso di successo. L'eliminazione sar\u00e0 rifiutata se il livello \u00e8 un livello demo richiesto.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Azioni sui livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/setLive<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Attiva un livello; quando viene richiamato direttamente sul livello, verr\u00e0 utilizzata l'ultima variante di livello selezionata. Se viene richiamato su un livello gi\u00e0 attivo, non si verificher\u00e0 alcun errore. Verr\u00e0 restituito l'oggetto layer aggiornato.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/setOff<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Disattiva un livello. La chiamata di questo metodo su un livello gi\u00e0 disattivato non produrr\u00e0 un errore. Verr\u00e0 restituito l'oggetto layer aggiornato.<\/p>\n\n\n\n<p><i>*<\/i>Poich\u00e9 un livello pu\u00f2 decidere di eseguire alcune animazioni dopo aver chiamato questo metodo, l'oggetto livello restituito potrebbe essere nello stato \"shutdown\" (spento) anzich\u00e9 \"off\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/layers\/(ID livello)\/toggleLive<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Alterna un livello tra \"live\" e \"off\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/signals\/(SignalID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Attiva il segnale specificato da \"(SignalID)\" nella \"live-variant\" corrente o se il livello non \u00e8 live nella \"active-variant\". \u00c8 possibile ottenere il \"(SignalID)\" dal campo \"input-values\" del layer (identificato dal suffisso chiave \"_TypeSignal\").<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/layers\/(ID livello)\/cicloVarianti<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br><strong>Disponibile da: mimoLive 5.6<\/strong><br>Seleziona la variante successiva alla variante attualmente attiva del livello \"(LayerID)\" come nuova variante attiva del livello. Questo pu\u00f2 essere usato per selezionare la variante (ad esempio di un livello Lower Third) che deve essere attivata. <b>prossimo<\/b>.<br>La chiamata di questo endpoint non disturba lo spettacolo se il livello \u00e8 attualmente in diretta. L'effetto viene visualizzato solo quando il livello viene successivamente impostato come live.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/cycleThroughVariantsBackwards<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Seleziona la voce <strong>precedente<\/strong> (l'inverso di <code>\/cicloVarianti<\/code>) senza influenzare l'attuale stato live. L'effetto diventa visibile quando il livello o la variante selezionata viene impostata come live.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/setLiveFirstVariant<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Attiva il <strong>prima<\/strong> del livello e imposta il livello in diretta.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/setLiveLastVariant<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Attiva il <strong>ultimo<\/strong> del livello e imposta il livello in diretta.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/inputs\/(SourceInputKey)\/mediacontrol\/(MediaControlCommand)<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Invia un comando di controllo dei media al media legato all'ingresso \u201c(SourceInputKey)\u201d del livello specificato. Tenga presente che la fonte dell'ingresso segnala quali comandi supporta; veda \/documents\/(DocumentID)\/sources\/(SourceID).<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Comando di controllo dei media<\/strong><\/td><td><strong>Descrizione<\/strong><\/td><\/tr><tr><td>giocare<\/td><td>Avvia la riproduzione multimediale.<\/td><\/tr><tr><td>pausa<\/td><td>Mette in pausa la riproduzione corrente senza azzerare la posizione.<\/td><\/tr><tr><td>fermarsi<\/td><td>Interrompe la riproduzione e ripristina la posizione del media all'inizio.<\/td><\/tr><tr><td>inverso<\/td><td>Riproduce i media in senso inverso.<\/td><\/tr><tr><td>riavvolgimento<\/td><td>Sposta la riproduzione all'indietro, in genere a una velocit\u00e0 superiore al normale.<\/td><\/tr><tr><td>fastforward<\/td><td>Fa avanzare rapidamente la riproduzione.<\/td><\/tr><tr><td>saltare l'inizio<\/td><td>Salta all'inizio del media.<\/td><\/tr><tr><td>saltare alla fine<\/td><td>Salta alla fine dei media.<\/td><\/tr><tr><td>skipback<\/td><td>Salta all'indietro di un intervallo di 10 secondi.<\/td><\/tr><tr><td>saltafila<\/td><td>Salta in avanti di un intervallo di 10 secondi.<\/td><\/tr><tr><td>record<\/td><td>Avvia la registrazione dell'input multimediale.<\/td><\/tr><tr><td>mischiare<\/td><td>Alterna l'ordine di riproduzione casuale degli elementi multimediali.<\/td><\/tr><tr><td>ripetere<\/td><td>Ripetere i media attuali.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Varianti<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Interrogare le varianti<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(DocumentID)\/layers\/(LayerID)\/varianti<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Restituisce un elenco di varianti per il livello specificato da \"(LayerID)\" e il documento specificato da \"(DocumentID)\". Per informazioni sugli oggetti restituiti, vedere il tipo di dati \"variants\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(DocumentID)\/layers\/(LayerID)\/varianti\/(VariantID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\", \"<span class=\"caps\">INSERIRE<\/span>\"<\/strong><br>Restituisce una singola variante specificata da \"(VariantID)\" e \"(LayerID)\" nel documento specificato da \"(DocumentID)\". Per ulteriori informazioni sui dati restituiti, vedere il tipo di dati \"variants\".<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Modifica di una variante<\/h3>\n\n\n\n<p>Per impostare il nome della variante o dei valori di input, eseguire un'operazione di \"<span class=\"caps\">INSERIRE<\/span>\" con una richiesta <span class=\"caps\">JSON<\/span> codificato all'endpoint della variante. I valori che non si vogliono modificare devono essere semplicemente esclusi dall'oggetto <span class=\"caps\">JSON<\/span> voi \"<span class=\"caps\">INSERIRE<\/span>\". Esempio:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>{\n    \"name\": \"New name of the Variant\",\n    \"input-values\": { \n        \"tvGroup_Content__Subtitle\": \"This is a Test\"\n    }\n}<\/code><\/pre>\n\n\n\n<p>Dopo aver aggiornato i valori, mimoLive risponder\u00e0 con un oggetto variante aggiornato. Si tenga presente che non tutti i valori possono essere applicati istantaneamente o possono avere effetto solo dopo un altro ciclo di rendering.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Azioni varianti<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/variants\/(VariantID)\/setLive<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Attiva una variante; se il livello proprietario non \u00e8 in tensione, anche questo verr\u00e0 commutato in tensione. Il richiamo di questa funzione su una variante gi\u00e0 attiva non produce errori. Verr\u00e0 restituito l'oggetto variante aggiornato.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layers\/(LayerID)\/variants\/(VariantID)\/setOff<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Disattiva una variante. In questo modo si disattiva anche il livello proprietario.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(DocumentID)\/layers\/(LayerID)\/varianti\/(VariantID)\/toggleLive<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Alterna una variante tra live e off.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(DocumentID)\/layers\/(LayerID)\/varianti\/(VariantID)\/segnali\/(SignalID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Attiva il segnale specificato da \"(SignalID)\" sulla variante. \u00c8 possibile ottenere il \"(SignalID)\" dal campo \"input-values\" del livello (identificato dal suffisso chiave \"_TypeSignal\").<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Fonti<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Creazione di fonti<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">POST \/documenti\/(ID documento)\/fonti<\/h4>\n\n\n\n<p>Crea una nuova sorgente nel documento da un determinato tipo di sorgente. Specifica il tipo tramite source-type (ad esempio com.boinx.mimoLive.sources.deviceVideoSource), fornisce facoltativamente un nome di visualizzazione e tutti i parametri che possono essere aggiornati tramite l'API HTTP. Restituisce l'oggetto sorgente appena creato.<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -X POST \"http:\/\/localhost:8989\/api\/v1\/documents\/(DocumentID)\/sources\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"source-type\": \"com.boinx.mimoLive.sources.deviceVideoSource\",\n    \"name\": \"Main Camera\"\n  }'\n\nValid source type identifiers:<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Identificatori del tipo di sorgente<\/strong><\/td><td><strong>Fonte<\/strong><\/td><\/tr><tr><td>com.boinx.mimoLive.sources.webBrowserSource<\/td><td>Browser web<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.screenCaptureSource<\/td><td>Cattura dello schermo<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.ffmpegSource<\/td><td>NDI \/ Acquisizione video<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.webRTCSource<\/td><td>mimoCall<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.windowCaptureSource<\/td><td>Cattura della finestra<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.deviceAudioSource<\/td><td>Dispositivo audio<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.deviceVideoSource<\/td><td>Combinazione di dispositivo video e audio (telecamera)<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.lastRecordingSource<\/td><td>Ultima registrazione<\/td><\/tr><tr><td>com.boinx.mimoLive.sources.zoomparticipant<\/td><td>Partecipante Zoom<\/td><\/tr><tr><td>e molti altri...<\/td><td><\/td><\/tr><tr><td><\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Interrogazione delle fonti<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/fonti<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Restituisce un elenco di fonti per il documento specificato da \"(DocumentID)\". Per informazioni sugli oggetti restituiti, vedere il tipo di dati \"livello fonti\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/fonti\/(ID fonte)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\", \"<span class=\"caps\">INSERIRE<\/span>\"<\/strong><br>Restituisce una singola sorgente specificata da \"(SourceID)\" nel documento specificato da \"(DocumentID)\". Nella sezione inclusa della risposta verranno restituiti anche tutti gli oggetti \"filtro\" relativi a questa sorgente (sideloading). Per ulteriori informazioni sui dati restituiti, vedere il tipo di dati \"sources\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/fonti\/(ID fonte)\/anteprima<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Restituisce un'anteprima grafica della sorgente specificata da \"(SourceID)\" nel documento specificato da \"(DocumentID)\". L'endpoint supporta i seguenti parametri:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><th>Parametro<\/th><th>Predefinito<\/th><th>Descrizione<\/th><\/tr><tr><td>formato<\/td><td>png<\/td><td>Il formato in cui viene restituita l'anteprima. Valori ammessi: png, jpeg, mjpeg, mpng<\/td><\/tr><tr><td>fps<\/td><td>10<\/td><td>Il framerate per le anteprime delle immagini in movimento. Si applica solo ai formati mjpeg e mpng. Si noti che 1 fps equivale all'incirca a 1% di <span class=\"caps\">CPU<\/span> utilizzo.<\/td><\/tr><tr><td>larghezza<\/td><td>(larghezza del documento)<\/td><td>La larghezza massima dell'anteprima. L'immagine verr\u00e0 ridimensionata per adattarsi alla larghezza indicata.<\/td><\/tr><tr><td>altezza<\/td><td>(larghezza del documento)<\/td><td>L'altezza massima dell'anteprima. L'immagine verr\u00e0 ridimensionata per adattarsi all'altezza indicata.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/sources\/(SourceID)\/mediacontrol\/(MediaControlCommand)<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Controlla la riproduzione per le sorgenti con capacit\u00e0 multimediale (ad esempio, File multimediale\/Lista di riproduzione). I comandi supportati dipendono dal tipo di sorgente. Vedere \/documents\/(DocumentID)\/layers\/(LayerID)\/inputs\/(SourceInputKey)\/mediacontrol\/(MediaControlCommand) .<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/fonti\/(ID fonte)\/openwebbrowser<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d<br>Se la sorgente \u00e8 una sorgente Cattura con browser web, questa azione aprir\u00e0 la finestra del browser web corrispondente. <\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Modifica di una sorgente<\/h3>\n\n\n\n<p>Per impostare il nome della sorgente o i valori di ingresso (solo se la sorgente ne ha, ad esempio se \u00e8 una sorgente di composizione), eseguire un'operazione di \"<span class=\"caps\">INSERIRE<\/span>\" con una richiesta <span class=\"caps\">JSON<\/span> codificato all'endpoint di origine. I valori che non si vogliono modificare devono essere semplicemente esclusi dall'oggetto <span class=\"caps\">JSON<\/span> voi \"<span class=\"caps\">INSERIRE<\/span>\". Esempio:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>{\n    \"name\": \"New name of the Source\",\n    \"gain\": 1.25,\n    \"input-values\": { \n        \"tvGroup_Content__Subtitle\": \"This is a Test\"\n    }\n}<\/code><\/pre>\n\n\n\n<p><i>*<\/i>L'attributo \"gain\" \u00e8 stato aggiunto in mimoLive 5.6 e viene ignorato nelle versioni precedenti o se la sorgente non ha un controllo del gain. Il valore sar\u00e0 ritagliato su (0, 2), dove 0 \u00e8 silenzioso, 1 \u00e8 predefinito e 2 raddoppia approssimativamente il volume.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Eliminazione di una sorgente<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">DELETE \/documenti\/(ID documento)\/fonti\/(ID fonte)<\/h4>\n\n\n\n<p>Rimuove la fonte specificata dal documento. Restituisce 204 No Content in caso di successo.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Fonte Azioni<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/fonti\/(ID fonte)\/segnali\/(ID segnale)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Attiva il segnale specificato da \"(SignalID)\" sulla sorgente (solo se la sorgente ha \"valori di ingresso\", ad esempio se \u00e8 una sorgente di composizione). Il \"(SignalID)\" si ottiene dal campo \"input-values\" della sorgente (identificato dal suffisso \"_TypeSignal\").<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Filtri<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Interrogazione dei filtri<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/fonti\/(ID fonte)\/filtri<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Restituisce un elenco di filtri per la fonte specificata da \"(SourceID)\" e il documento specificato da \"(DocumentID)\". Per informazioni sugli oggetti restituiti, vedere il tipo di dati \"filters\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/fonti\/(ID fonte)\/filtri\/(ID filtro)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\", \"<span class=\"caps\">INSERIRE<\/span>\"<\/strong><br>Restituisce un singolo filtro specificato da \"(FilterID)\" e \"(SourceID)\" nel documento specificato da \"(DocumentID)\". Per ulteriori informazioni sui dati restituiti, vedere il tipo di dati \"filters\".<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Modifica di un filtro<\/h3>\n\n\n\n<p>Per impostare i valori di ingresso, eseguire un comando \"<span class=\"caps\">INSERIRE<\/span>\" con una richiesta <span class=\"caps\">JSON<\/span> codificato all'endpoint del filtro. I valori che non si vogliono modificare devono essere semplicemente esclusi dal filtro <span class=\"caps\">JSON<\/span> voi \"<span class=\"caps\">INSERIRE<\/span>\". Esempio:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>{\n    \"input-values\": { \n        \"tvGroup_Content__Subtitle\": \"This is a Test\"\n    }\n}<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/sources\/(SourceID)\/filters\/(FilterID)\/signals\/(SignalID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Attiva il segnale specificato da \"(SignalID)\" sul filtro. \u00c8 possibile ottenere il \"(SignalID)\" dal campo \"input-values\" del filtro (identificato dal suffisso chiave \"_TypeSignal\").<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Destinazioni di uscita<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Creare destinazioni di output<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">POST \/documenti\/(ID documento)\/uscite-destinazioni<\/h4>\n\n\n\n<p>Crea una nuova destinazione di output nel documento. Specifica il tipo tramite output-destination-type e opzionalmente imposta la posizione con l'indice e il parametro che pu\u00f2 essere aggiornato tramite l'API HTTP. Restituisce l'oggetto destinazione di output appena creato.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\"><code>Identificatore della destinazione di uscita<\/code><\/th><th class=\"has-text-align-left\" data-align=\"left\">Destinazione di uscita<\/th><\/tr><\/thead><tbody><tr><td><code>com.boinx.mimoLive.outputDestination.liveStreaming<\/code><\/td><td>Streaming in diretta (RTMP, ecc.)<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.fileRecording<\/code><\/td><td>Registrazione di file<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.blackmagicDesign<\/code><\/td><td>Playout (Blackmagic SDI\/HDMI)<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.ndi<\/code><\/td><td>Uscita NDI<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.fullscreen<\/code><\/td><td>Uscita a schermo intero<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.virtualCamera<\/code><\/td><td>Telecamera virtuale<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.mimoCall<\/code><\/td><td>mimoCall<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.audioMonitor<\/code><\/td><td>Monitor audio<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.imageSequence<\/code><\/td><td>Scrittore di immagini<\/td><\/tr><tr><td><code>com.boinx.mimoLive.outputDestination.fileUploader<\/code><\/td><td>Caricatore di file<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -X POST \"http:\/\/localhost:8989\/api\/v1\/documents\/(DocumentID)\/output-destinations\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"output-destination-type\": \"com.boinx.mimoLive.outputDestination.fileRecording\",\n    \"index\": 0\n  }'<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Interrogazione delle destinazioni di uscita<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/destinazioni di uscita<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Elenca tutte le destinazioni di output per il documento specificato.<br>Per informazioni sugli oggetti restituiti, vedere il tipo di dati \"\"output-destinazioni\":{TOPIC-<span class=\"caps\">LINK<\/span>+dati-tipoh1(}. sezione-uscita-destinazioni).<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/output-destinations\/(OutputDestinationID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"GET\"<\/strong><br>Restituisce la destinazione di uscita specificata da \"(OutputDestinationID)\".<br>Per informazioni sugli oggetti restituiti, vedere il tipo di dati \"\"output-destinazioni\":{TOPIC-<span class=\"caps\">LINK<\/span>+dati-tipoh1(}. sezione-uscita-destinazioni).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Modifica di una destinazione di uscita<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/output-destinations\/(OutputDestinationID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"PUT\", \"<span class=\"caps\">PATCH<\/span>\"<\/strong><br>Aggiorna le propriet\u00e0 selezionate della destinazione di output specificata da \"(OutputDestinationID)\".<br>Restituisce la destinazione di uscita aggiornata.<\/p>\n\n\n\n<p>Le seguenti propriet\u00e0 sono modificabili:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\"titolo\"<\/li>\n\n\n\n<li>\"inizia con lo spettacolo\"<\/li>\n\n\n\n<li>\"si ferma con lo spettacolo\"<\/li>\n\n\n\n<li>Contenuto dell'oggetto \"impostazioni\" (si veda il file <a href=\"\/it\/%7BTOPIC-LINK+data-typesh1%28%7D\/\" target=\"_blank\" rel=\"noreferrer noopener\">descrizione delle impostazioni<\/a>. sezione-impostazioni-individuali) per maggiori informazioni)<\/li>\n<\/ul>\n\n\n\n<p>La descrizione dell'aggiornamento deve essere fornita in <a href=\"http:\/\/jsonapi.org\/format\/h1%28\" target=\"_blank\" rel=\"noreferrer noopener\"><span class=\"caps\">JSON<\/span>:Formato di aggiornamento API<\/a> . crud-updating). Esempio:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>{\n  \"data\": {\n    \"type\": \"output-destinations\",\n    \"id\": \"4FF003EA-D071-43FD-845F-DCD4A25DFA00\",\n    \"attributes\": {\n      \"title\": \"Our Recording\",\n      \"starts-with-show\": true,\n      \"settings\": {\n        \"location\": \"~\/Movies\"\n      }\n    }\n  }\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Azioni della destinazione di uscita<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/output-destinations\/(OutputDestinationID)\/setLive<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Fa s\u00ec che la destinazione di uscita specificata da \"(OutputDestinationID)\" diventi attiva, se \u00e8 configurata correttamente e se \u00e8 autorizzata a diventarlo (ad esempio in base allo stato della licenza mimoLive).<br>Se la destinazione di uscita pu\u00f2 essere attivata, viene restituita la destinazione di uscita con il suo nuovo \"live-state\", altrimenti viene restituito un errore \"409 Conflict\".<\/p>\n\n\n\n<p><i>*<\/i>Poich\u00e9 una destinazione di output potrebbe dover eseguire alcune operazioni prima di essere live (ad esempio, contattare un servizio esterno per creare un flusso live), l'oggetto di destinazione di output restituito potrebbe essere in stato \"startup\" anzich\u00e9 \"live\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/output-destinations\/(OutputDestinationID)\/setOff<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Arresta la destinazione di uscita specificata da \"(OutputDestinationID)\".<br>Se la destinazione di uscita \u00e8 autorizzata a fermarsi, viene restituita la destinazione di uscita, altrimenti viene restituito un errore \"409 Conflict\".<\/p>\n\n\n\n<p><i>*<\/i>Poich\u00e9 una destinazione di uscita pu\u00f2 avere bisogno di eseguire alcune operazioni prima di interrompere le operazioni, la destinazione di uscita restituita pu\u00f2 trovarsi nello stato \"shutdown\" (arresto) anzich\u00e9 \"preview\" (anteprima) (che sarebbe il valore predefinito per una destinazione di uscita ben configurata).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Set di livelli<\/h2>\n\n\n\n<p>I set di livelli sono stati introdotti in mimoLive 5.0 e permettono di impostare lo stato live di pi\u00f9 livelli contemporaneamente, consentendo la creazione di <strong>scene<\/strong> per le diverse situazioni di uno spettacolo.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Creazione di set di livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">POST \/documenti\/(ID documento)\/insiemi di livelli<\/h4>\n\n\n\n<p>Crea un nuovo set di livelli nel documento. Un set di livelli \u00e8 una raccolta salvata di azioni che vengono applicate a uno o pi\u00f9 livelli quando il set di livelli viene richiamato. Per ogni livello si specifica un'azione: \u201clive\u201d (attiva, opzionalmente con una variante specifica), \u201coff\u201d (spegnimento graduale) o \u201cforce-off\u201d (spegnimento immediato). Pu\u00f2 anche impostare recall-on-show-start e recall-on-show-end per richiamare automaticamente il set di livelli all'inizio o alla fine dello show. Restituisce l'oggetto set di livelli appena creato.<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -X POST \"http:\/\/localhost:8989\/api\/v1\/documents\/(DocumentID)\/layer-sets\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"data\": {\n      \"attributes\": {\n        \"name\": \"Interview Scene\",\n        \"recall-on-show-start\": false,\n        \"recall-on-show-end\": false,\n        \"layers\": &#91;\n          {\n            \"layer-id\": \"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\",\n            \"action\": \"live\",\n            \"variant\": \"edit-variant\"\n          },\n          {\n            \"layer-id\": \"YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY\",\n            \"action\": \"off\"\n          },\n          {\n            \"layer-id\": \"ZZZZZZZZ-ZZZZ-ZZZZ-ZZZZ-ZZZZZZZZZZZZ\",\n            \"action\": \"force-off\"\n          }\n        ]\n      }\n    }\n  }'\n\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Interrogazione degli insiemi di livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(ID documento)\/insiemi di strati<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\"<\/strong><br>Elenca tutti i set di livelli per il documento specificato.<br>Per informazioni sugli oggetti restituiti, veda il tipo di dati \u201cset di livelli\u201d.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layer-sets\/(LayerSetID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"GET\"<\/strong><br>Restituisce il set di livelli specificato da \"(LayerSetID)\".<br>Per informazioni sugli oggetti restituiti, vedere il tipo di dati \"\"set di livelli\":{TOPIC-<span class=\"caps\">LINK<\/span>+data-typesh1(}. sezione-layer-sets).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Modificare gli insiemi di livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documents\/(DocumentID)\/layer-sets\/(LayerSetID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"PUT\", \"<span class=\"caps\">PATCH<\/span>\"<\/strong><\/p>\n\n\n\n<p>Aggiorna un set di livelli esistente. Pu\u00f2 rinominarlo, modificarne il comportamento di richiamo automatico o sostituire le voci dell'azione di livello. Includa solo gli attributi che desidera modificare. Restituisce l'oggetto set di livelli aggiornato.<br><br><\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -X PUT \"http:\/\/localhost:8989\/api\/v1\/documents\/(DocumentID)\/layer-sets\/(LayerSetID)\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"data\": {\n      \"attributes\": {\n        \"name\": \"Wide Shot Scene\",\n        \"layers\": &#91;\n          {\n            \"layer-id\": \"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\",\n            \"action\": \"live\",\n            \"variant\": \"VVVVVVVV-VVVV-VVVV-VVVV-VVVVVVVVVVVV\"\n          },\n          {\n            \"layer-id\": \"YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY\",\n            \"action\": \"force-off\"\n          }\n        ]\n      }\n    }\n  }'\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Eliminazione di un set di livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">DELETE \/documents\/(DocumentID)\/layer-sets\/(LayerSetID)<\/h4>\n\n\n\n<p>Rimuove definitivamente il set di livelli specificato dal documento. Restituisce 204 No Content in caso di successo.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Azioni di set di livelli<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(DocumentID)\/layer-set\/(LayerSetID)\/recall<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\" \"<span class=\"caps\">POSTA<\/span>\"<\/strong><br>Richiama (attiva) il set di layer specificato da \"(LayerSetID)\", facendo s\u00ec che tutti i layer assumano lo stato live registrato nel set di layer.<br>Restituisce il livello impostato dopo il richiamo, cio\u00e8 con \"active == true\".<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Archivi di dati<\/h2>\n\n\n\n<h4 class=\"wp-block-heading\">\/documenti\/(DocumentID)\/datastores\/(StoreID)<\/h4>\n\n\n\n<p><strong>Metodi supportati: \"<span class=\"caps\">GET<\/span>\", \"<span class=\"caps\">INSERIRE<\/span>\", \"<span class=\"caps\">CANCELLARE<\/span>\"<\/strong><br>mimoLive offre la possibilit\u00e0 di memorizzare i dati forniti dall'utente all'interno del file del documento, ad esempio per ripristinare uno stato in un momento successivo. L'utente \u00e8 libero di scegliere uno \"StoreID\", ma \u00e8 bene tenere presente che non c'\u00e8 modo di elencare tutti i negozi di dati associati a un documento (tuttavia, \u00e8 possibile creare una sorta di <strong>indice<\/strong> che tiene traccia degli altri negozi con nomi dinamici).<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Creare\/aggiornare un archivio dati<\/h4>\n\n\n\n<p>Per creare o aggiornare un archivio dati, inviare un messaggio \"<span class=\"caps\">INSERIRE<\/span>\" a uno \"StoreID\" di propria scelta con i dati associati nel corpo della richiesta. Se l'operazione ha avuto successo, mimoLive risponder\u00e0 con lo stato \"200 OK\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Leggere il contenuto di un archivio dati<\/h4>\n\n\n\n<p>Per leggere un archivio di dati precedentemente memorizzato, \u00e8 sufficiente richiederlo tramite \"<span class=\"caps\">GET<\/span>\". I dati saranno restituiti esattamente come sono stati forniti nel campo \"<span class=\"caps\">INSERIRE<\/span>\" per memorizzarlo. Se non \u00e8 stato trovato un archivio dati con quell'ID per questo documento, mimoLive restituir\u00e0 un errore \"404 Not Found\".<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Cancellare un archivio dati esistente<\/h4>\n\n\n\n<p>Per eliminare un archivio di dati quando non se ne ha pi\u00f9 bisogno, \u00e8 sufficiente inviare un messaggio \"<span class=\"caps\">CANCELLARE<\/span>\" per lo \"StoreID\" che si vuole cancellare. Nel caso in cui l'archivio dati non fosse presente, mimoLive risponder\u00e0 con un errore \"404 Not Found\".<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Riunioni Zoom<\/h2>\n\n\n\n<p>Questi endpoint controllano l'integrazione del client Zoom integrato di mimoLive.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/zoom\/unione<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Si unisce a una riunione Zoom. Parametri tipici (inviare come corpo JSON per POST o <code>Param=valore<\/code> per GET):<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Parametro<\/strong><\/td><td><strong>Tipo di valore<\/strong><\/td><td><strong>Descrizione<\/strong><\/td><\/tr><tr><td><code>meetingid<\/code><\/td><td><em>Stringa<\/em><\/td><td>Numero di riunione Zoom (utilizzi \u201cDemo-Meeting-ID\u201d se vuole partecipare alla riunione dimostrativa mimoLive)<\/td><\/tr><tr><td><code>codice di accesso<\/code><\/td><td><em>Stringa, opzionale<\/em><\/td><td>Codice di accesso alla riunione<\/td><\/tr><tr><td><code>webinartoken<\/code><\/td><td><em>Stringa, opzionale<\/em><\/td><td>Se vuole partecipare a un webinar, deve fornire il token del webinar.<\/td><\/tr><tr><td><code>nome visualizzato<\/code><\/td><td><em><em>Stringa<\/em>, opzionale<\/em><\/td><td>Nome da inserire nella riunione<\/td><\/tr><tr><td><code>zoomaccountname<\/code><\/td><td><em><em><em>Stringa<\/em><\/em><\/em><\/td><td>Nome dell'account Zoom, come visualizzato nelle impostazioni dell'account Zoom di mimoLive.<\/td><\/tr><tr><td>telecamera virtuale<\/td><td>Stringa, opzionale<\/td><td>Se impostato su \u201ctrue\u201d, mimoLive invier\u00e0 il programma come feed video a Zoom.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Restituisce un oggetto di stato che indica il progresso o il successo della connessione.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/zoom\/lasciare<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Lascia la riunione attualmente unita. Restituisce un oggetto di stato.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/zoom\/fine<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Tenta di terminare la riunione Zoom corrente (azione solo per l'host). Restituisce un successo se la riunione \u00e8 terminata o un conflitto se il cliente non ha l'autorizzazione.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">\/zoom\/partecipanti<\/h4>\n\n\n\n<p><strong>Metodi supportati:<\/strong> \u201cGET\u201d \u201cPOST\u201d<br>Restituisce l'elenco attuale dei partecipanti alla riunione unita (nomi, ID e stati di base).<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Chiave del valore<\/strong><\/td><td><strong>Tipo di valore<\/strong><\/td><td><strong>Descrizione<\/strong><\/td><\/tr><tr><td>nome<\/td><td><em>Stringa<\/em><\/td><td>Nome del partecipante a Zoom<\/td><\/tr><tr><td>id<\/td><td><em>Integro<\/em><\/td><td>ID utente del partecipante a Zoom<\/td><\/tr><tr><td>ruolo-utente<\/td><td><em>Stringa<\/em><\/td><td><\/td><\/tr><tr><td>isHost<\/td><td><em>Bool<\/em><\/td><td>vero se l'utente \u00e8 ospite della riunione<\/td><\/tr><tr><td>isCoHost<\/td><td><em>Bool<\/em><\/td><td>vero se l'utente \u00e8 co-conduttore della riunione<\/td><\/tr><tr><td>isVideoOn<\/td><td><em>Bool<\/em><\/td><td>vero se l'utente ha abilitato il video<\/td><\/tr><tr><td>isAudioOn<\/td><td><em>Bool<\/em><\/td><td>vero se l'utente ha l'audio abilitato<\/td><\/tr><tr><td>isTalking<\/td><td><em>Bool<\/em><\/td><td>vero se l'utente sta parlando<\/td><\/tr><tr><td>isRaisingHand<\/td><td><em>Bool<\/em><\/td><td>vero se l'utente sta alzando la mano<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">\/zoom\/meetingaction<\/h4>\n\n\n\n<p>Esegue un'azione pianificata per la riunione. Fornisce <code>azione<\/code> e gli argomenti opzionali tramite il corpo JSON o la stringa di query.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Parametro<\/strong><\/td><td><strong>Tipo di valore<\/strong><\/td><td><strong>Descrizione<\/strong><\/td><\/tr><tr><td>comando<\/td><td><em>Stringa<\/em><\/td><td>Un comando dall'elenco sottostante<\/td><\/tr><tr><td>userid<\/td><td><em>Stringa, opzionale<\/em><\/td><td>Alcuni comandi richiedono un ID utente<\/td><\/tr><tr><td>tipo di schermo<\/td><td><em>Stringa, opzionale<\/em><\/td><td>Alcuni comandi richiedono un tipo di schermo<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Comando<\/strong><\/td><td><strong>Descrizione<\/strong><\/td><\/tr><tr><td>richiestaPermesso di registrazione<\/td><td>Inviare una richiesta di autorizzazione alla registrazione locale.<\/td><\/tr><tr><td>muteVideo<\/td><td>Disattiva il video di un utente. (richiede il parametro userid)<\/td><\/tr><tr><td>unmuteVideo<\/td><td>Disattiva il video di un utente. (richiede il parametro userid)<\/td><\/tr><tr><td>muteAudio<\/td><td>Disattiva l'audio di un utente. (richiede il parametro userid)<\/td><\/tr><tr><td>UnmuteAudio<\/td><td>Disattiva l'audio di un utente. (richiede il parametro userid)<\/td><\/tr><tr><td>abilitaUnmuteBySelf<\/td><td>Abilita la funzione che consente agli utenti di riattivarsi quando sono silenziati, disponibile solo per l'host\/co-host.<\/td><\/tr><tr><td>disabilitaUnmuteBySelf<\/td><td>Disattiva la funzione per cui gli utenti non possono riattivarsi quando sono in mute, disponibile solo per l'host\/co-host.<\/td><\/tr><tr><td>muteAll<\/td><td>Silenzia tutti i partecipanti alla riunione, disponibile solo per l'host\/co-host.<\/td><\/tr><tr><td>unmuteAll<\/td><td>Disattiva l'audio di tutti i partecipanti alla riunione, disponibile solo per l'host\/co-host.<\/td><\/tr><tr><td>bloccaRiunione<\/td><td>Blocca la riunione, disponibile solo per l'host\/co-host. Una volta bloccata, i nuovi partecipanti non possono pi\u00f9 iscriversi.<\/td><\/tr><tr><td>sbloccaRiunione<\/td><td>Sblocca la riunione, disponibile solo per l'ospitante\/co-ospite.<\/td><\/tr><tr><td>lowerAllHands<\/td><td>Abbassi le mani di tutti i partecipanti, disponibili solo per l'ospite\/co-ospite.<\/td><\/tr><tr><td>shareFitWindowMode<\/td><td>Regoli le dimensioni del display per adattarlo alla finestra.<\/td><\/tr><tr><td>pausaCondividi<\/td><td>Pausa di condivisione.<\/td><\/tr><tr><td>curriculumCondividi<\/td><td>Condivisione del curriculum.<\/td><\/tr><tr><td>joinVoip<\/td><td>Partecipi alle riunioni via VoIP.<\/td><\/tr><tr><td>lasciareVoip<\/td><td>Disconnetta il VoIP dalla riunione.<\/td><\/tr><tr><td>consentire ai partecipanti di chattare<\/td><td>Abilita la funzione che consente agli utenti di chattare tra loro.<\/td><\/tr><tr><td>non consentire i partecipanti alla chat<\/td><td>Disattiva la funzione che consente agli utenti di chattare tra loro.<\/td><\/tr><tr><td>consentire ai partecipanti di condividere<\/td><td>Abiliti la funzione che consente agli utenti di condividere il proprio schermo.<\/td><\/tr><tr><td>disconoscere i partecipanti alla condivisione<\/td><td>Disabilita la funzione che consente agli utenti di condividere lo schermo.<\/td><\/tr><tr><td>consentire ai partecipanti di avviare il video<\/td><td>Abiliti la funzione che consente agli utenti di avviare il loro video.<\/td><\/tr><tr><td>disallowParticipantsToStartVideo<\/td><td>Disabilita la funzione che consente agli utenti di avviare il video.<\/td><\/tr><tr><td>consentire ai partecipanti di condividere la lavagna bianca<\/td><td>Abilita la funzione che consente agli utenti di condividere una lavagna bianca.<\/td><\/tr><tr><td>non consentire ai partecipanti di condividere la lavagna bianca<\/td><td>Disattiva la funzione che consente agli utenti di condividere una lavagna bianca.<\/td><\/tr><tr><td>enableAllowLocalRecordingRequest<\/td><td>Abilita la funzione per cui la richiesta di registrazione da parte degli utenti sar\u00e0 accettata automaticamente.<\/td><\/tr><tr><td>disabilitaAllowLocalRecordingRequest<\/td><td>Disattiva la funzione per cui la richiesta di registrazione da parte degli utenti viene accettata automaticamente.<\/td><\/tr><tr><td>consentire ai partecipanti di rinominare<\/td><td>Abilita la funzione che consente agli utenti di rinominarsi.<\/td><\/tr><tr><td>disconoscere i partecipanti da rinominare<\/td><td>Disabilita la funzione che consente agli utenti di rinominarsi.<\/td><\/tr><tr><td>mostraImmagini del profilo del partecipante<\/td><td>Attiva l'opzione per mostrare le foto del profilo dei partecipanti.<\/td><\/tr><tr><td>nascondiImmaginiProfiloPartecipante<\/td><td>Disattiva l'opzione di mostrare le immagini del profilo dei partecipanti.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Esempio di utilizzo<\/h2>\n\n\n\n<p>Questi endpoint dell'API HTTP di mimoLive possono essere utilizzati in molti modi. Faccia riferimento alla sezione <a href=\"https:\/\/mimolive.com\/it\/manuale-duso\/personalizzazione\/http-api\/esempi-di-utilizzo-dellapi\/\" data-type=\"user-manual\" data-id=\"32490\">Esempi di utilizzo dell'API<\/a> per saperne di pi\u00f9.<\/p>\n\n\n\n<p><\/p>","protected":false},"excerpt":{"rendered":"<p>General The API, when enabled, is available at \u201chttp:\/\/localhost:8989\/api\/v1\u201d. This is the base URL that must be prepended to every method URL listed below. If a resource was introduced after the initial launch of the HTTP API, the method is marked with an Available since information. \/ Supported methods: \u201cGET\u201dRedirects to the list of open [&hellip;]<\/p>","protected":false},"author":3,"featured_media":0,"parent":32486,"menu_order":0,"template":"","meta":{"_acf_changed":false,"_angie_page":false,"_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[258],"tags":[],"class_list":["post-32488","user-manual","type-user-manual","status-publish","hentry","category-manual"],"acf":[],"_links":{"self":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32488","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":9,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32488\/revisions"}],"predecessor-version":[{"id":43700,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32488\/revisions\/43700"}],"up":[{"embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32486"}],"wp:attachment":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/media?parent=32488"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/categories?post=32488"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/tags?post=32488"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}