{"id":32490,"date":"2023-03-08T16:33:24","date_gmt":"2023-03-08T15:33:24","guid":{"rendered":"https:\/\/mimolive.com\/?post_type=user-manual&#038;p=32490"},"modified":"2024-10-08T11:01:10","modified_gmt":"2024-10-08T09:01:10","slug":"ejemplos-de-uso-de-la-api","status":"publish","type":"user-manual","link":"https:\/\/mimolive.com\/es\/user-manual\/remote-control-automation\/http-api\/examples-of-api-usage\/","title":{"rendered":"Ejemplos de uso de la API"},"content":{"rendered":"<h2 class=\"wp-block-heading\">Requisitos previos<\/h2>\n\n\n\n<p>- Abra el documento que desea manipular en mimoLive.<br>- Aseg\u00farese de que el documento est\u00e1 en un estado finalizado para que los puntos finales de la API como Capas no cambien m\u00e1s. Tenga en cuenta que si elimina una capa y la a\u00f1ade de nuevo, esta capa tendr\u00e1 un ID de capa diferente cuando hable con ella a trav\u00e9s de la API. Sin embargo, reordenar capas o a\u00f1adir variantes de capas no cambiar\u00e1 el ID de capa.<br>- Habilitar el <span class=\"caps\">HTTP<\/span>-Servidor en las Preferencias de Control Remoto de mimoLive. Marque la opci\u00f3n \"Permitir acceso de control remoto\":<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1000\" height=\"542\" src=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/9e0a2b0b-6a64-4093-b15b-24aa12dead32.png\" alt=\"\" class=\"wp-image-32491\" style=\"width:570px;height:auto\" srcset=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/9e0a2b0b-6a64-4093-b15b-24aa12dead32.png 1000w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/9e0a2b0b-6a64-4093-b15b-24aa12dead32-300x163.png 300w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/9e0a2b0b-6a64-4093-b15b-24aa12dead32-768x416.png 768w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/9e0a2b0b-6a64-4093-b15b-24aa12dead32-18x10.png 18w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><\/figure>\n\n\n\n<p>Anote el n\u00famero IP o la direcci\u00f3n IP con el n\u00famero de puerto de mimoLive para su uso posterior cuando trabaje con el <span class=\"caps\">HTTP<\/span> <span class=\"caps\">API<\/span>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Formas de controlar mimoLive a distancia<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Control de mimoLive con superficies de control remoto<\/h3>\n\n\n\n<p>La forma m\u00e1s eficaz es crear un <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/uso-de-mimolive\/superficies-de-control-remoto\/\" data-type=\"user-manual\" data-id=\"31791\">Superficie de control remoto<\/a> para su documento mimoLive, que puede ejecutarse en un iPad, iPhone o cualquier otro dispositivo con un navegador de Internet.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Control de mimoLive con php<\/h3>\n\n\n\n<p>Disponemos de un script PHP de ejemplo bien documentado en GitHub: <br><a href=\"https:\/\/github.com\/boinx\/mimoLive-HTTP-Demo\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/github.com\/boinx\/mimoLive-<span class=\"caps\">HTTP<\/span>-Demo<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Control de mimoLive con <span class=\"caps\">CURL<\/span><\/h3>\n\n\n\n<p>Para controlar mimoLive a trav\u00e9s de <span class=\"caps\">HTTP<\/span> puede utilizar el comando bash \"curl\". Para que los comandos curl funcionen necesitas encontrar el ID del documento mimoLive que quieres manipular.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Control de mimoLive con la capa de automatizaci\u00f3n<\/h3>\n\n\n\n<p>En <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/automatizacion\/\">Capa de automatizaci\u00f3n<\/a> puede ejecutar algunos comandos sencillos para desencadenar acciones en mimLive mediante su <span class=\"caps\">API<\/span> Endpoints. Tambi\u00e9n dispone de un comando httpRequest() para realizar cualquier tipo de <span class=\"caps\">GET<\/span> solicitar acciones la <span class=\"caps\">HTTP<\/span> <span class=\"caps\">API<\/span> es capaz de hacer.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Control de mimoLive con Apple Script<\/h3>\n\n\n\n<p>Actualmente mimoLive no soporta Apple Script de forma nativa. Sin embargo, puede utilizar una soluci\u00f3n alternativa para llegar a mimoLive: Hay un comando \"do shell script\" en apple script que te permite ejecutar comandos bash como \"curl\". La secci\u00f3n anterior explica c\u00f3mo crear un comando curl para manipular una determinada capa o valor de capa.<\/p>\n\n\n<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\">Errores en Apple Script<\/p><\/div>\n                <div><p class=\"text_exclamation\">En Apple Script hay dos escollos cuando se lleva un comando de terminal como \"curl\" al comando do shell script: 1. Todos los \" deben ir precedidos de un \\ para que el analizador sint\u00e1ctico de Apple-Script sepa que esos no son los marcadores finales del comando do shell script. El \\ es un car\u00e1cter de escape para indicar al analizador sint\u00e1ctico que ignore el car\u00e1cter siguiente. 2. Si concatena varias partes de texto con &amp; entonces esto es una \"lista de texto\" para Apple Script en lugar de un \u00fanico texto. El comando do shell no funcionar\u00e1 con \"lista de texto\" y por lo tanto su necesidad de convertirlo de nuevo a un solo texto con el \"como texto\" al final de su comando curl texto<\/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<p>Una vez que est\u00e9 satisfecho con su comando curl necesita envolverlo en un comando \"do shell script\" en Apple Script:<\/p>\n\n\n<section class=\"boinx_section\">\n    <div class=\"main_div\">\n        <div class=\"left_div_icon\">\n                <i class=\"icon_highlight\">*<\/i>\n        <\/div>\n\n        <div class=\"right_div_text\">\n                <div><p class=\"text_highlight_headline\">Aseg\u00farese de sustituir xxxxxxxxx por el punto final de la API de su capa espec\u00edfica.<\/p><\/div>\n                <div><p class=\"text_highlight\"><\/p><\/div>\n        <\/div>    \n    <\/div>\n<\/section>\n\n\t\t<style>.boinx_section {\n    margin:30px 0;\n    padding:10px;\n    background-color:rgb(217,237,248);\n    border-radius: 8px;\n  \n}\n\n.icon_highlight {\n    display:block;\n    padding:5px;\n    font-size:80px;\n    color:rgb(58,134,172);\n    line-height:60px;\n}\n\n.text_highlight {\n    color:rgb(58,134,172);\n}\n\n.text_highlight_headline{\n    font-weight:bold;\n    color:rgb(58,134,172);\n}\n\n.main_div\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.left_div_icon{\n    display:flex !IMPORTANT;\n    width:40px;\n    padding:0;\n    margin:10px 20px 10px 10px;\n    \n}\n.right_div_text{\n    display:flex !IMPORTANT;\n    flex-direction: column;\n    flex-grow: 1;\n    padding:10px;\n    margin:0;\n    width:200px;\n    }<\/style>\n\t\t\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>set layerAPIEndpoint to \"xxxxxxxxx\" -- in our example this would be \"http:\/\/172.28.30.202:8989\/api\/v1\/documents\/458706932\/layers\/BA868701-8131-49CB-8EDD-8C7E6E7CD60B\"\n\nset lowerThirdTitle to \"Hello World!\"\ndo shell script \"curl -d '{\\\"input-values\\\":{\\\"tvGroup_Content__Title\\\":\\\"\" &amp;amp; lowerThirdTitle &amp;amp; \"\\\"}}' -H \\\"Content-Type: application\/json\\\" -X PUT \\\"\" &amp;amp; layerAPIEndpoint &amp;amp; \"\\\"\" as text\n\n<\/code><\/pre>\n\n\n\n<p>El siguiente ejemplo de script de Apple muestra c\u00f3mo activar una capa cada media hora: Esto puede ser \u00fatil para superposiciones comerciales. Aseg\u00farese de utilizar una capa que se apague sola despu\u00e9s de un cierto tiempo (por ejemplo, una capa de colocaci\u00f3n con una fuente de pel\u00edcula no en bucle lo har\u00e1).<\/p>\n\n\n<section class=\"boinx_section\">\n    <div class=\"main_div\">\n        <div class=\"left_div_icon\">\n                <i class=\"icon_highlight\">*<\/i>\n        <\/div>\n\n        <div class=\"right_div_text\">\n                <div><p class=\"text_highlight_headline\">Aseg\u00farese de sustituir xxxxxxxxx por el punto final de la API de su capa espec\u00edfica.<\/p><\/div>\n                <div><p class=\"text_highlight\"><\/p><\/div>\n        <\/div>    \n    <\/div>\n<\/section>\n\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>-- configure your Layer API Endpoint:\nset layerAPIEndpoint to \"xxxxxxxxx\" -- in our example this would be \"http:\/\/172.28.30.202:8989\/api\/v1\/documents\/458706932\/layers\/BA868701-8131-49CB-8EDD-8C7E6E7CD60B\"\n-- repeat endlessly:\nrepeat\n\t-- get the seconds last in this hour\n\tset currentDate to current date\n\tset secondsToNextHour to 3600 - ((minutes of currentDate) * 60 + (seconds of currentDate))\n\t-- --------------------------------------------\n\t-- The following code snippet is useful only if you want to\n\t-- switch the layer live on half hours also.\n\t-- if you don't want this behaviour you can delete this part.\n\t-- --------------------------------------------\n\t-- check if we are currently in the first half of the hour\n\tif secondsToNextHour &amp;gt; 1800 then\n\t\t-- yes, we are in the first half of the hour, so only wait half the time\n\t\tset secondsToNextHour to secondsToNextHour - 1800\n\tend if\n\t-- --------------------------------------------\n\t-- wait until the time to trigger the layer\n\tdelay secondsToNextHour\n\t-- set the specified layer to live:\n\tdo shell script \"curl \\\"\" &amp;amp; layerAPIEndpoint &amp;amp; \"\/setLive\\\"\" as text\n\t-- wait a couple of seconds to make sure we don't glitch in time\n\tdelay 5\nend repeat\n\n<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Control de los elementos de la interfaz de usuario en mimoLive<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Obtener un <span class=\"caps\">API<\/span> Punto final<\/h3>\n\n\n\n<p><\/p>\n\n\n\n<p>Los puntos finales de la API son esenciales para abordar elementos espec\u00edficos en su documento mimoLive. Para obtener una lista de los puntos finales de API disponibles, consulte <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/personalizacion\/http-api\/puntos-finales\/\" data-type=\"user-manual\" data-id=\"32488\">Puntos finales de la API<\/a>.<br><br>Antes de mimoLive 5.5 era dif\u00edcil obtener el ID de documento y, por ejemplo, un ID de capa con comandos de Terminal buscando a trav\u00e9s de largas <span class=\"caps\">JSON<\/span> datos. Desde mimoLive 5.5 es mucho m\u00e1s f\u00e1cil:<\/p>\n\n\n\n<p>En primer lugar, copie el archivo mimoLive <span class=\"caps\">HTTP<\/span> base del servidor <span class=\"caps\">URL<\/span> de la secci\u00f3n Control Remoto de la ventana de Preferencias de mimoLive (ver captura de pantalla anterior). Abre un editor de texto (por ejemplo, TextEdit de Apple) y pega el contenido del Portapapeles en un documento de texto reci\u00e9n creado. Aseg\u00farate de que hay <strong>no<\/strong> barra invertida al final del <span class=\"caps\">URL<\/span>\u00a1! El resultado deber\u00eda ser el siguiente:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>http:&#47;&#47;172.28.30.202:8989<\/code><\/pre>\n\n\n\n<p>En la ventana del documento mimoLive, con el rat\u00f3n, puedes hacer clic con el bot\u00f3n derecho (o control-clic, o dos dedos-clic) en el objeto de inter\u00e9s (por ejemplo, una Capa, una Fuente, un bot\u00f3n de un control de Capa) para obtener un men\u00fa contextual. Hay un elemento de men\u00fa que le permite copiar el archivo <span class=\"caps\">API<\/span> Punto final al portapapeles de macOS para utilizarlo en tu mimoLive <span class=\"caps\">API<\/span> proyecto.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img decoding=\"async\" width=\"1000\" height=\"740\" src=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/bc6c7e19-e991-48a0-a9b8-b56d690f19b4.png\" alt=\"\" class=\"wp-image-32492\" style=\"width:501px;height:auto\" srcset=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/bc6c7e19-e991-48a0-a9b8-b56d690f19b4.png 1000w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/bc6c7e19-e991-48a0-a9b8-b56d690f19b4-300x222.png 300w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/bc6c7e19-e991-48a0-a9b8-b56d690f19b4-768x568.png 768w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/bc6c7e19-e991-48a0-a9b8-b56d690f19b4-16x12.png 16w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><\/figure>\n\n\n\n<p>A veces es importante tratar una variante espec\u00edfica de la capa en lugar de la capa en general. Si hace clic con el bot\u00f3n derecho en el par\u00e1metro de una capa, ver\u00e1 que hay diferentes <span class=\"caps\">API<\/span> para la capa activa actual o la variante de capa espec\u00edfica:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"1000\" height=\"356\" src=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/6120370f-a575-43db-891b-ef3a91d5aec5.png\" alt=\"\" class=\"wp-image-32493\" srcset=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/6120370f-a575-43db-891b-ef3a91d5aec5.png 1000w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/6120370f-a575-43db-891b-ef3a91d5aec5-300x107.png 300w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/6120370f-a575-43db-891b-ef3a91d5aec5-768x273.png 768w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/6120370f-a575-43db-891b-ef3a91d5aec5-18x6.png 18w\" sizes=\"(max-width: 1000px) 100vw, 1000px\" \/><\/figure>\n\n\n\n<p>Vuelve a tu editor de texto y pega lo que acabas de copiar <span class=\"caps\">API<\/span> Punto final despu\u00e9s del <span class=\"caps\">HTTP<\/span> Base del servidor <span class=\"caps\">URL<\/span>. Ahora el <span class=\"caps\">URL<\/span> en su navegador de texto deber\u00eda tener este aspecto:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>http:&#47;&#47;172.28.30.202:8989\/api\/v1\/documents\/458706932\/layers\/BA868701-8131-49CB-8EDD-8C7E6E7CD60B<\/code><\/pre>\n\n\n\n<p>Esta es la \u00faltima <span class=\"caps\">API<\/span> Endpoint para dirigirse a una capa de su documento. En este ejemplo <strong>458706932<\/strong> es el ID del documento y <strong>BA868701-8131-49CB-8EDD-8C7E6E7CD60B<\/strong> es el ID de capa espec\u00edfico de una capa determinada en este documento.<\/p>\n\n\n\n<p>Hacer clic con el bot\u00f3n derecho del rat\u00f3n sobre determinados elementos de la interfaz de usuario para revelar un men\u00fa contextual que permita obtener el punto final de API espec\u00edfico funciona para lo siguiente:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Fuentes<\/li>\n\n\n\n<li>Capas<\/li>\n\n\n\n<li>Variantes de capa<\/li>\n\n\n\n<li>Par\u00e1metro de capa<\/li>\n\n\n\n<li>Destinos de salida<\/li>\n\n\n\n<li>Conjuntos de capas<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"266\" src=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.19.00-1024x266.png\" alt=\"\" class=\"wp-image-39712\" style=\"width:575px;height:auto\" srcset=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.19.00-1024x266.png 1024w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.19.00-300x78.png 300w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.19.00-768x199.png 768w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.19.00-18x5.png 18w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.19.00.png 1132w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplo: Conectar y <span class=\"caps\">OFF<\/span> a Capa<\/h3>\n\n\n\n<p>Con los datos recuperados <span class=\"caps\">API<\/span> Endpoint para una determinada capa puede activarlo y desactivarlo con los siguientes comandos de terminal.<\/p>\n\n\n<section class=\"boinx_section\">\n    <div class=\"main_div\">\n        <div class=\"left_div_icon\">\n                <i class=\"icon_highlight\">*<\/i>\n        <\/div>\n\n        <div class=\"right_div_text\">\n                <div><p class=\"text_highlight_headline\"><\/p><\/div>\n                <div><p class=\"text_highlight\">Aseg\u00farese de sustituir xxxxxxxxx por el punto final de la API del paso anterior.<\/p><\/div>\n        <\/div>    \n    <\/div>\n<\/section>\n\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl xxxxxxxxx\/setLive\ncurl xxxxxxxxx\/setOff\ncurl xxxxxxxxx\/toggleLive\n# our example will look like this:\ncurl http:\/\/172.28.30.202:8989\/api\/v1\/documents\/458706932\/layers\/BA868701-8131-49CB-8EDD-8C7E6E7CD60B\/setLive<\/code><\/pre>\n\n\n<section class=\"boinx_section\">\n    <div class=\"main_div\">\n        <div class=\"left_div_icon\">\n                <i class=\"icon_highlight\">*<\/i>\n        <\/div>\n\n        <div class=\"right_div_text\">\n                <div><p class=\"text_highlight_headline\">Las URL tambi\u00e9n funcionan en un navegador de Internet<\/p><\/div>\n                <div><p class=\"text_highlight\">Estas URL (sin el comando \"curl\") tambi\u00e9n se pueden poner en la barra de direcciones de un navegador de Internet. Al pulsar \"return\", el navegador llamar\u00e1 al servidor HTTP de mimoLive y ejecutar\u00e1 el comando especificado. Si tiene datos JSON que necesita enviar al punto final de la API, tambi\u00e9n puede a\u00f1adirlos a la URL, consulte \"Convertir un comando CURL con datos JSON en una URL HTTP para solicitudes HTTP simples\" m\u00e1s abajo.<\/p><\/div>\n        <\/div>    \n    <\/div>\n<\/section>\n\n\n\n\n<p>Una forma sencilla de obtener la URL HTTP completa para activar o desactivar el estado activo de una capa es hacer clic con el bot\u00f3n derecho del rat\u00f3n en el bot\u00f3n activo de la capa para que aparezca un men\u00fa contextual y seleccionar \"Copiar URL para establecer capa activa\". Esto copiar\u00e1 la URL al portapapeles para su uso. En la captura de pantalla, puede ver el men\u00fa contextual del bot\u00f3n En vivo de una capa Lower Third.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"249\" src=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.13.16-1024x249.png\" alt=\"\" class=\"wp-image-39711\" style=\"width:643px;height:auto\" srcset=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.13.16-1024x249.png 1024w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.13.16-300x73.png 300w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.13.16-768x187.png 768w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.13.16-18x4.png 18w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.13.16.png 1174w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplo: Cambiar el valor de una capa<\/h3>\n\n\n\n<p>- Todos los par\u00e1metros de una capa pueden establecerse a trav\u00e9s de la funci\u00f3n <span class=\"caps\">HTTP<\/span> <span class=\"caps\">API<\/span>. Debe encontrar la clave correcta para establecer un nuevo valor. En nuestro ejemplo, estableceremos el T\u00edtulo de un archivo <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/tercio-inferior\/\">Lower Third Capa<\/a> con la clave tvGroup_Content__Title. Como tenemos que enviar el nuevo valor en un <span class=\"caps\">JSON<\/span> al archivo <span class=\"caps\">HTTP<\/span> servidor con un <span class=\"caps\">PUT<\/span> solicitar el comando curl se llena un poco.<\/p>\n\n\n\n<p><i>*<\/i>Aseg\u00farese de sustituir xxxxxxxxx por su capa espec\u00edfica <span class=\"caps\">API<\/span> \u00a1Punto final!<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -d '{\"input-values\":{\"tvGroup_Content__Title\":\"My new title\"}}' -H \"Content-Type: application\/json\" -X PUT \"xxxxxxxxx\"\n<\/code><\/pre>\n\n\n\n<p>Una forma r\u00e1pida de obtener una URL HTTP completa para activar la actualizaci\u00f3n de una propiedad de capa es hacer clic con el bot\u00f3n derecho del rat\u00f3n sobre el nombre de la propiedad, revelando un men\u00fa contextual, y seleccionar \"Copiar URL para cambiar '.....'\". \" Este comando de men\u00fa copia en el portapapeles una URL HTTP que, al ser invocada (por ejemplo, en un navegador de Internet), fijar\u00e1 la propiedad en su valor actual. Examinando la URL, puede determinar qu\u00e9 parte de ella debe modificarse para enviar sus propios datos a esta propiedad. En la captura de pantalla, puede ver el men\u00fa contextual para copiar la URL para cambiar el subt\u00edtulo de una capa Lower Third.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"752\" height=\"334\" src=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.05.39.png\" alt=\"\" class=\"wp-image-39708\" style=\"width:349px;height:auto\" srcset=\"https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.05.39.png 752w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.05.39-300x133.png 300w,  https:\/\/mimolive.com\/wp-content\/uploads\/2023\/03\/Screenshot-2024-10-08-at-10.05.39-18x8.png 18w\" sizes=\"(max-width: 752px) 100vw, 752px\" \/><\/figure>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>http:\/\/127.0.0.1:8989\/api\/v1\/documents\/xxxxxxxxxxxx\/layers\/yyyyyyyyyyyy\/variants\/zzzzzzzzzzzz?include=data.attributes.input-values&amp;fields&#91;input-values]=tvGroup_Content__Subtitle&amp;update=%7B%22input-values%22:%7B%22tvGroup_Content__Subtitle%22:%22<strong>mimoLive%20User<\/strong>%22%7D%7D<\/code><\/pre>\n\n\n<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\">\u00a1El nuevo valor de la URL debe estar codificado en la URL!<\/p><\/div>\n                <div><p class=\"text_exclamation\">En este ejemplo el espacio entre \"mimoLive\" y \"Usuario\" se codifica como<\/p><\/div>\n        <\/div>    \n    <\/div>\n<\/section>\n\n\n\n\n<h2 class=\"wp-block-heading\">Buenas pr\u00e1cticas<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Colecci\u00f3n de \u00fatiles <span class=\"caps\">API<\/span> Comandos para explorar<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Ajuste del <span class=\"caps\">RTMP<\/span> <span class=\"caps\">URL<\/span> y Clave de Streaming de un Destino de Salida de Streaming en Directo:<\/h4>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl --data '{\"data\": { \"attributes\": {\"settings\": {\"rtmpurl\":\"rtmp:\/\/mystreaminghost.com\", \"streamingkey\":\"<strong>MYTOTALLYSECRETSTREAMKEY<\/strong>\"} } } }' --request PATCH http:\/\/192.168.0.100:8989\/api\/v1\/documents\/xxxxxxxxx\/output-destinations\/yyyyyyyyyyyyy<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Configuraci\u00f3n del nombre de archivo y la ruta de un destino de salida de la grabadora de archivos<\/h4>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl --data '{\"data\": { \"attributes\": {\"settings\": { \"location\": \"<strong>~\/Destktop\/Recordings<\/strong>\", \"filename\": \"<strong>MyGreatShow %year-%month-%day-%hour-%minute.%extension<\/strong>\" } } } }' --request PATCH http:\/\/192.168.0.100:8989\/api\/v1\/documents\/xxxxxxxxxxxx\/output-destinations\/yyyyyyyyyyyy<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Configuraci\u00f3n de la fuente de v\u00eddeo de una capa de colocaci\u00f3n<\/h4>\n\n\n\n<p>yyyyyyyyyyy ser\u00e1 el <span class=\"caps\">UUID<\/span> de la fuente de v\u00eddeo. (e.g CCAF4418-367A-415F-AD25-6536C3EF3512)<\/p>\n\n\n\n<p>xxxxxxxxxxxxx ser\u00e1 el <span class=\"caps\">API<\/span> punto final de la variante de capa determinada. (e.g. http:\/\/172.28.30.202:8989\/api\/v1\/documents\/2014814935\/layers\/BA868701-8131-49CB-8EDD-8C7E6E7CD60B\/variants\/AA868701-8131-49CB-8EDD-8C7E6E7CD60A)<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -d '{\"input-values\":{\"tvIn_VideoSourceAImage\":\"yyyyyyyyyyyyy\"}}' -H \"Content-Type: application\/json\" -X PUT \"xxxxxxxxxxxxxxxx\"<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Ajustar el volumen de una capa que tiene un bot\u00f3n de volumen de audio<\/h4>\n\n\n\n<p>Con este comando curl, puede cambiar el volumen de audio de una capa que tenga un mando de ajuste de audio (como la capa <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/placer\/\">Capa de placer<\/a>). El valor \"volumen\" puede tomar valores de 0,0 a 1,0.<\/p>\n\n\n\n<p>xxxxxxxxxxxxx ser\u00e1 el <span class=\"caps\">API<\/span> punto final de la capa (por ejemplo, http:\/\/10.101.2.2:8989\/api\/v1\/documents\/13195157\/layers\/BA868701-8131-49CB-8EDD-8C7E6E7CD60B)<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -d '{\"volume\": 0.5}' -H \"Content-Type: application\/json\" -X PUT \"xxxxxxxxxxxxxxxx\"<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Definir el color de una capa de fondo<\/h4>\n\n\n\n<p>xxxxxxxxxxxxx ser\u00e1 el <span class=\"caps\">API<\/span> punto final de la variante de capa determinada. (e.g. http:\/\/172.28.30.202:8989\/api\/v1\/documents\/2014814935\/layers\/BA868701-8131-49CB-8EDD-8C7E6E7CD60B\/variants\/AA868701-8131-49CB-8EDD-8C7E6E7CD60A)<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -d '{\"input-values\":{\"tvGroup_Appearance__Color_1\":{\"red\": 1.0, \"blue\": 0.5, \"green\": 0, \"alpha\": 0.5}}}' -H \"Content-Type: application\/json\" -X PUT \"xxxxxxxxxxxxxxxx\"<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Borrar la ruta de archivo de una fuente de v\u00eddeo \u00daltima grabaci\u00f3n<\/h4>\n\n\n\n<p>En su <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/fuentes-y-el-repositorio-de-fuentes\/\">Repositorio de fuentes<\/a>puede tener un <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/ultima-fuente-de-grabacion\/\">\u00daltima fuente de grabaci\u00f3n<\/a> que proporcionar\u00e1 acceso a la \u00faltima grabaci\u00f3n que anuncie cualquier Destino de Salida de Grabaci\u00f3n de Archivos. En una aplicaci\u00f3n de quiosco, ser\u00e1 necesario borrar la \u00faltima ruta de grabaci\u00f3n para que el siguiente usuario de la estaci\u00f3n no pueda revisar la grabaci\u00f3n del usuario anterior. Con lo siguiente <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/automatizacion\/\">Comando Capa de automatizaci\u00f3n<\/a> puede borrar esta informaci\u00f3n de la \u00daltima fuente de grabaci\u00f3n:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>httpRequest(http:\/\/127.0.0.1:8989\/api\/v1\/documents\/2014814935\/sources\/2014814935-413AC0A3-AC43-4A7D-A228-6D0181BF1476?update=%7B%22filepath%22%3A%22%22%7D)<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Almacenamiento <span class=\"caps\">JSON<\/span> Datos del documento mimoLive<\/h4>\n\n\n\n<p>Con el endpoint \"datastores\" puedes almacenar cualquier tipo de datos en el documento mimoLive para que persistan durante una recarga del documento. Es necesario utilizar un \"<span class=\"caps\">PUT<\/span>\" para guardar los datos y una solicitud \"<span class=\"caps\">GET<\/span>\"para volver a leerlo. Usted puede almacenar cualquier tipo de datos, sin embargo en este ejemplo estamos almacenando <span class=\"caps\">JSON<\/span> Data porque este parece ser un caso de uso muy com\u00fan. Si desea almacenar datos diferentes, deber\u00e1 ajustar el par\u00e1metro -H en consecuencia.<\/p>\n\n\n\n<p>Comando Curl para almacenar datos:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl \u2014data '{\"myData1\": 1.5, \"myData2\":\"Some text\"}' -H \"Content-Type: application\/json\" -X PUT http:\/\/127.0.0.1:8989\/api\/v1\/documents\/1643911183\/datastores\/myDataStore1<\/code><\/pre>\n\n\n\n<p>Comando Curl para volver a leer los datos:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -X <span class=\"caps\">GET<\/span> http:\/\/127.0.0.1:8989\/api\/v1\/documents\/1643911183\/datastores\/myDataStore1<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Actualizar la ruta del archivo fuente de un archivo multimedia<\/h4>\n\n\n\n<p>Es posible que desee cambiar la pel\u00edcula que se reproduce o sustituir un anuncio mostrado por un <a href=\"https:\/\/mimolive.com\/es\/manual-del-usuario\/archivo-multimedia\/\">Fuente del archivo multimedia<\/a>. Esto puede hacerse con un comando de actualizaci\u00f3n ejecutado en la fuente <span class=\"caps\">API<\/span> punto final.<\/p>\n\n\n\n<p>Aseg\u00farese de que el modo de referencia de archivos de la fuente de medios est\u00e1 configurado como \"Ruta absoluta\". Obtenga la <span class=\"caps\">API<\/span> de esta fuente haciendo clic con el bot\u00f3n derecho del rat\u00f3n sobre ella en la columna de la izquierda y seleccionando \"Copiar el punto final de la fuente\". <span class=\"caps\">API<\/span> Endpoint to Clipboard\" en el men\u00fa contextual. Cree un <span class=\"caps\">URL<\/span> de la siguiente forma:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>http:\/\/127.0.0.1:8989\/api\/v1\/documents\/&lt;YOUR DOCUMENT ID&gt;\/sources\/&lt;SOURCE API ENDPOINT&gt;?update={\"filepath\":\"&lt;LOCAL FILE PATH&gt;\"}<\/code><\/pre>\n\n\n\n<p>Aseg\u00farese de codificar el <span class=\"caps\">JSON<\/span> datos en el <span class=\"caps\">URL<\/span> para obtener un <span class=\"caps\">URL<\/span> que se puede utilizar en un comando curl como este:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl -X GET http:\/\/127.0.0.1:8989\/api\/v1\/documents\/1748069974\/sources\/1748069974-334DA2E4-DFF3-4225-8F4A-D09D40A6BD5D?update=%7B%22filepath%22:%22~\/Desktop\/Screen%20Recording%202022-07-27%20at%2012.18.23.mov%22%7D<\/code><\/pre>\n\n\n\n<p><i>*<\/i>Tenga en cuenta que puede utilizar \"~\" al principio de la ruta del archivo para hacer referencia al directorio personal del usuario actual.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Conversi\u00f3n de un <span class=\"caps\">CURL<\/span> con <span class=\"caps\">JSON<\/span> Datos A un <span class=\"caps\">HTTP<\/span> <span class=\"caps\">URL<\/span> por simple <span class=\"caps\">HTTP<\/span> Solicitudes<\/h3>\n\n\n\n<p>A veces s\u00f3lo es posible enviar un simple <span class=\"caps\">HTTP<\/span> a mimoLive en lugar de utilizar un comando curl, por ejemplo, en el caso de aplicaciones de automatizaci\u00f3n de terceros o de la propia capa de automatizaci\u00f3n mimoLive. Para ello, es necesario convertir el bloque de datos del comando curl para que forme parte del archivo <span class=\"caps\">URL<\/span>. Puede hacerlo de la siguiente manera:<\/p>\n\n\n\n<p>Supongamos que tenemos el siguiente comando curl:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>curl --data '{\"data\": { \"attributes\": {\"settings\": {\"rtmpurl\":\"rtmp:\/\/mystreaminghost.com\", \"streamingkey\":\"MYTOTALLYSECRETSTREAMKEY\"} } } }' --request PATCH http:\/\/192.168.0.100:8989\/api\/v1\/documents\/458706932\/output-destinations\/4D072496-1CE3-418E-B73E-59A2927A2110<\/code><\/pre>\n\n\n\n<p>Usted tomar\u00eda el <strong><span class=\"caps\">HTTP<\/span> pieza<\/strong> primero:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>http:&#47;&#47;192.168.0.100:8989\/api\/v1\/documents\/458706932\/output-destinations\/4D072496-1CE3-418E-B73E-59A2927A2110<\/code><\/pre>\n\n\n\n<p>A\u00f1adir <strong>?update=<\/strong> a ella:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>http:&#47;&#47;192.168.0.100:8989\/api\/v1\/documents\/458706932\/output-destinations\/4D072496-1CE3-418E-B73E-59A2927A2110?update=<\/code><\/pre>\n\n\n\n<p>Obtenga toda la <strong>-cadena de datos<\/strong> y elimine todos los espacios innecesarios:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>{\"data\":{\"attributes\":{\"settings\":{\"rtmpurl\":\"rtmp:\/\/mystreaminghost.com\",\"streamingkey\":\"MYTOTALLYSECRETSTREAMKEY\"}}}}<\/code><\/pre>\n\n\n\n<p>Codifica esto en su <span class=\"caps\">URL<\/span> forma por <strong>escape de los caracteres no conformes con URL<\/strong> (por ejemplo, utilizando https:\/\/www.urlencoder.org\/)<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>%7B%22data%22%3A%7B%22attributes%22%3A%7B%22settings%22%3A%7B%22rtmpurl%22%3A%22rtmp%3A%2F%2Fmystreaminghost.com%22%2C%22streamingkey%22%3A%22MYTOTALLYSECRETSTREAMKEY%22%7D%7D%7D%7D<\/code><\/pre>\n\n\n\n<p>Por \u00faltimo, ponga todo esto <strong>despu\u00e9s de la actualizaci\u00f3n<\/strong> as\u00ed:<\/p>\n\n\n\n<pre class=\"wp-block-code\" data-no-translation=\"\"><code>http:&#47;&#47;192.168.0.100:8989\/api\/v1\/documents\/458706932\/output-destinations\/4D072496-1CE3-418E-B73E-59A2927A2110?update=%7B%22data%22%3A%7B%22attributes%22%3A%7B%22settings%22%3A%7B%22rtmpurl%22%3A%22rtmp%3A%2F%2Fmystreaminghost.com%22%2C%22streamingkey%22%3A%22MYTOTALLYSECRETSTREAMKEY%22%7D%7D%7D%7D<\/code><\/pre>\n\n\n\n<p>Ahora puede utilizar este <span class=\"caps\">URL<\/span> en un simple <span class=\"caps\">HTTP<\/span> solicitud.<\/p>\n\n\n\n<p><\/p>","protected":false},"excerpt":{"rendered":"<p>Prerequisites &#8211; Open the document you want to manipulate in mimoLive.&#8211; Make sure the document is in a finished state so that the API endpoints like Layers do not change anymore. Please be aware that if you remove a layer and add it again this layer will have a different Layer ID when talking to [&hellip;]<\/p>","protected":false},"author":3,"featured_media":0,"parent":32486,"menu_order":2,"template":"","meta":{"_acf_changed":false,"_angie_page":false,"_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[258],"tags":[],"class_list":["post-32490","user-manual","type-user-manual","status-publish","hentry","category-manual"],"acf":[],"_links":{"self":[{"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/user-manual\/32490","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/user-manual"}],"about":[{"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/types\/user-manual"}],"author":[{"embeddable":true,"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/users\/3"}],"version-history":[{"count":8,"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/user-manual\/32490\/revisions"}],"predecessor-version":[{"id":39724,"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/user-manual\/32490\/revisions\/39724"}],"up":[{"embeddable":true,"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/user-manual\/32486"}],"wp:attachment":[{"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/media?parent=32490"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/categories?post=32490"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mimolive.com\/es\/wp-json\/wp\/v2\/tags?post=32490"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}