mimoLive puede personalizarse añadiendo nuevas capas. El verdadero poder de las capas reside en el hecho de que están hechas con una tecnología de MacOS X llamada Quartz Composer. Casi todo es posible con Quartz Compositions. Puedes crear programas de TV interactivos en los que tu audiencia puede enviar SMS o mensajes de twitter que se muestran en pantalla. Crear gráficos bursátiles a partir de datos en línea. Llevar la puntuación de un partido deportivo. Juega en pantalla. Puedes encontrar inspiración en algunas de las capas incluidas con mimoLive. Para trabajar con mimoLive, las Composiciones de cuarzo deben contener ciertos elementos para que mimoLive y la capa puedan hablar entre sí y para que la capa pueda mostrar los archivos multimedia que mimoLive le envía. En teoría, cualquiera puede crear sus propias capas. Esta página describe a nivel técnico cómo crear capas utilizando Quartz Composer.
Comprar una capa personalizada
Si no desea profundizar en Quartz Composer por sí mismo, déjenos hacerlo por usted. Tenemos una amplia experiencia en la creación de capas para mimoLive, incluida la visualización de datos como gráficos de acciones, que puede aprovechar para crear la capa adecuada para usted. Por favor, póngase en contacto con el departamento comercial para más detalles.
Creación de una capa personalizada - Primeros pasos
Masterclass Capas de codificación para mimoLive
Pre-Requisiciones
Hay algunos requisitos previos antes de que puedas empezar a desarrollar capas para mimoLive:
- Necesitas tener una licencia válida de mimoLive para probar y ejecutar tus capas en mimoLive.
- Necesitas tener instalada la aplicación Quartz Composer de Apple. Es una herramienta de desarrollo gratuita que puedes descargar en la web de desarrolladores de Apple. Sin embargo, primero tendrás que registrarte como desarrollador Mac (http://developer.apple.com). Aquí puedes encontrar Guía del usuario de Quartz Composer por Apple.
- Parche Lua - Necesitará el parche Lua para abrir capas mimoLive en Quartz Composer a partir de mimoLive 1.9. Es de código abierto y está disponible en GitHub. Utilizamos este parche como sustituto del parche JavaScript de QuartzComposer porque no funciona de forma estable en mimoLive. (Descargue el parche desde aquí:[https://github.com/boinx/QCLua/releases )
- JSON Parche y Parche OAuth - Hay dos parches personalizados más que actualmente sólo se utilizan en la capa de Twitter. Al personalizar la capa de Twitter, deberá descargar e instalar los parches antes de empezar a editar.
Plantilla de capas en blanco
Puede utilizar nuestro archivo gratuito Quartz Composition como punto de partida para sus capas personalizadas. Contiene un conjunto básico de entradas y salidas y las propiedades necesarias que debe cambiar en el cuadro de diálogo "Editar información" de Quartz Composer.
Descargar Plantilla de capas v1.0
El ejemplo de Hola-Mundo
Como primer y sencillo ejemplo vamos a crear una Composición de Cuarzo básica y utilizarla como capa en mimoLive.
- Iniciar la aplicación Quartz Composer
- Elija Archivo ⇢ Nuevo espacio en blanco en la barra de menú. Obtendrá un nuevo documento vacío de Quartz Composer.
- Abra la Biblioteca de Parches con el botón de la esquina superior izquierda. Aparecerá una pequeña ventana con una lista de todos los patches de Quartz Composer.
- En la Biblioteca de Parches, busque el parche llamado Cartelera. Puede hacerlo rápidamente tecleando algunas letras iniciales del nombre del patch en el campo de búsqueda de la parte inferior de la ventana de la Biblioteca de Patches. Este es un parche de renderizado. Dibuja una imagen plana en la pantalla de salida.
- Arrastra el parche desde la biblioteca a la ventana en blanco de tu editor. El patch se pegará allí donde lo dejes. Puedes moverlo haciendo clic y arrastrándolo. Nota: El patch tiene varias entradas que están marcadas con un punto de conexión a la izquierda de cada valor.
- Ahora busque el parche Imagen con cadena en la biblioteca de parches y arrástrelo a la ventana del editor. Colócalo a la derecha del parche Billboard. El parche Imagen con Cadena es un parche Generador que generará una imagen que contiene un texto que puedes especificar con el valor de entrada Cadena.
- Conecte la salida Imagen del parche Imagen con cadena con la entrada Imagen del parche Cartelera.
- Si el Visor de Quartz Composer no está visible en este momento, haga clic en el botón Visor en la esquina superior derecha. Debería ver una ventana con un tablero de ajedrez en el fondo y "¡Hola Mundo!" en letras blancas encima.
- Vuelva a la ventana del Editor y haga clic con el botón derecho del ratón en el parche Imagen con cadena para que aparezca un menú contextual.
- Seleccione Insertar divisor de entrada ⇢ Cadena de ese menú contextual. Aparecerá en el documento un nuevo parche de tipo Splitter de entrada que está conectado por su salida a la Cadena de entrada del parche Imagen con cadena.
- De nuevo, haz clic con el botón derecho del ratón en este divisor de entrada recién creado y selecciona Publicar entradas ⇢ Entrada. Aparecerá un cuadro de texto preguntando por el nombre de esta entrada publicada. Cámbielo a Mi texto. Tenga en cuenta que esta entrada publicada es visible para mimoLive y se presentará en la vista de parámetros de la izquierda cuando se seleccione la capa en mimoLive.
- Abra la hoja de información sobre la composición seleccionando Editor ⇢ Editar información.... Obtendrá una hoja con una lista de pares clave-valor.
- Añada una nueva clave haciendo clic en el botón + de la parte inferior izquierda. Aparecerá una nueva línea en la lista solicitando un nombre para la clave.
- Introduzca tv_LayerProtocolVersion como valor Propiedadcambie el Clase de ''Cadena'' a ''Número'' y poner un ''1'' en la opción Valor columna.
- Haga clic en el botón Hecho en la esquina inferior izquierda para cerrar la hoja.
- Guarde esta composición en su Escritorio con el nombre Hola Mundo.qtz
- Inicia mimoLive, aún no crees ningún documento.
- Seleccione Archivo ⇢ Importar composiciones de capas... de la barra de menús. Aparecerá un cuadro de diálogo de selección de archivos. Seleccione el archivo Hello World.qtz previamente guardado en el Escritorio.
- Ahora cree un nuevo documento mimoLive con Archivo ⇢ Nuevo.... Aparecerá el selector de plantillas de mimoLive.
- Selecciona la plantilla Blank y pulsa el botón Choose en la esquina inferior derecha. Aparecerá una nueva ventana de Documento mimoLive que contendrá una única capa Placer que te representará sentado delante de tu ordenador.
- Abra el Depósito de capas haciendo clic en el botón "+" situado en la esquina superior derecha de la columna Capas.
- Busque la capa Hola Mundo que acaba de importar y arrastre una instancia a la parte superior de la pila de capas en el centro del documento.
- Encuentre su entrada autodefinida llamada Mi Texto y cambie el texto del campo de entrada.
- Tras hacer clic en el botón Live de esa capa, tu texto aparecerá sobre el vídeo.
¡Enhorabuena! ¡Acabas de crear una nueva capa mimoLive! En las siguientes secciones entraremos en los detalles necesarios para ser un buen ciudadano de mimoLive.
Por favor, tenga en cuenta que no podemos explicar cómo utilizar Quartz Composer Editor con todo detalle en esta documentación. Si desea obtener más información sobre Quartz Composer, lea la Guía del usuario de Quartz Composer en el sitio web para desarrolladores de Apple.
Manejo de capas en mimoLive
Exportar una capa desde mimoLive
Si quieres cambiar una capa incorporada en mimoLive, puedes exportar esa capa en mimoLive siguiendo los siguientes pasos:
- Abra el repositorio de capas con el botón "+" situado en la esquina superior derecha de la columna Capas.
- Busque y seleccione la capa que desea utilizar como base para su nueva capa.
- Abra el menú contextual haciendo clic con el botón derecho en esa capa.
- Seleccione Exportar composición de capas... en ese menú contextual.
- Se le pedirá que introduzca un nombre de archivo y que establezca una ubicación donde guardar la capa.
Importar una capa en mimoLive
Una vez que haya terminado de editar o crear su capa personalizada, tiene que importar su capa a mimoLive. Hay varias formas de importar una capa a mimoLive:
Importar una capa con el menú Archivo
- Seleccione Archivo ⇢ Importar composiciones de capas....
- Aparecerá un cuadro de diálogo de selección de archivos.
- Seleccione su archivo QuartzComposition y pulse "Importar".
Importar una capa utilizando la extensión de nombre de archivo ".tvlayer"
Esta técnica es útil cuando se envían capas personalizadas a otros usuarios de mimoLive (por ejemplo, sus clientes) que no están familiarizados con la importación manual de capas personalizadas. Sin embargo, no es muy útil durante el desarrollo, porque QuartzComposer no abrirá el archivo al cambiar la extensión del mismo.
- Busca tu composición en Finder.
- Pulse una vez sobre el nombre del archivo para cambiarlo. Un recuadro alrededor del nombre del fichero indica que está a punto de cambiarlo.
- Añade la extensión .tvlayer al final y pulsa Retorno. El Finder te preguntará si realmente quieres cambiar la extensión. Acepte.
- Haga doble clic en el archivo de composición. Ahora mimoLive abrirá e importará el archivo como nueva capa automáticamente. Se le notificará con una alerta en caso de éxito.
Capa personalizada API
mimoLive esperan que las Composiciones de cuarzo adopten el Capa personalizada API. En esta sección aprenderás la implementación mínima.
Aplicación mínima
La implementación mínima del protocolo de capas implica únicamente las propiedades de composición de Quartz, que pueden editarse en el editor de Quartz Composer seleccionando Editor ⇢ Editar información (⌥⌘I).
| Nombre | Tipo | Valor de la muestra |
|---|---|---|
| tv_LayerProtocolVersion | Número (real) | 1.2 |
| tv_LayerIdentifier | Cadena | com.example.layer.mylayer |
| tv_LayerVersion | Número (real) | 1.01 |
Es importante saber cómo utiliza mimoLive esos valores para que mimoLive pueda gestionar los conflictos de versión de capa.
- tv_LayerProtocolVersion: Cada vez que cambiemos el protocolo de capa vamos a aumentar la versión del protocolo de capa. Con esto las versiones antiguas de mimoLive son capaces de decirle al usuario si se utiliza una capa (por ejemplo, almacenada en un documento mimoLive) que tiene una versión de protocolo más reciente y por lo tanto puede no ser tratada correctamente por mimoLive.
- tv_LayerIdentifier: Este valor debe ser un valor único para cada una de tus capas. Nuestras capas tienen el prefijo com.boinx.layer.*. Por favor, utilice su propio esquema para tener identificadores únicos en todo el mundo. Tenga en cuenta que mimoLive no utiliza el nombre de archivo para comparar capas.
- tv_LayerVersion: Si mimoLive encuentra la versión de capa diferente para una capa que está almacenada en un documento a la capa que está instalada en el repositorio de capas utiliza las siguientes reglas para decidir qué hacer:
- Si la versión de la capa del documento es superior a la del repositorio: mantenga la versión del documento
- Si la versión de la capa de documentos es menor que la del repositorio, pero con el mismo número mayor (por ejemplo, 2.4 frente a 2.6), sustituya la capa de documentos por la nueva.
Si el número mayor de la versión de la capa es diferente, mimoLive tratará la capa como un reemplazo incompatible y no actualizará la capa del documento.
Ampliaciones de los bienes comunes
- derechos de autor:
- descripción:
- nombre:
- tv_Tagline: