O mimoLive pode ser personalizado através da adição de novas camadas. O verdadeiro poder das camadas reside no facto de serem realmente feitas com uma tecnologia MacOS X chamada Quartz Composer. Quase tudo é possível com as Composições Quartz. É possível criar programas de TV interactivos em que o público pode enviar SMS ou mensagens do Twitter que são apresentadas no ecrã. Criar gráficos de acções a partir de dados online. Acompanhar os resultados de um jogo desportivo. Jogar jogos no ecrã. Pode encontrar inspiração em algumas das camadas incluídas no mimoLive. Para trabalhar com o mimoLive, as Composições de Quartzo devem conter certos elementos para que o mimoLive e a camada possam falar entre si e para que a camada possa apresentar os ficheiros multimédia que o mimoLive lhe envia. Em teoria, qualquer pessoa pode criar as suas próprias camadas. Esta página descreve a um nível técnico como criar camadas usando o Quartz Composer.
Comprar uma camada personalizada
Se não quiser entrar no Quartz Composer por si próprio, deixe-nos fazê-lo por si. Temos uma vasta experiência na criação de camadas para o mimoLive, incluindo a visualização de dados, como gráficos de acções, que pode aproveitar para criar a camada certa para si. Por favor contactar o departamento comercial para mais pormenores.
Criar uma camada personalizada - Primeiros passos
Masterclass Camadas de codificação para mimoLive
Pré-Requisições
Existem alguns pré-requisitos antes de poder começar a desenvolver camadas para o mimoLive:
- É necessário ter uma licença mimoLive válida para testar e executar as suas camadas no mimoLive.
- É necessário ter instalada a aplicação Quartz Composer da Apple. Trata-se de uma ferramenta de desenvolvimento gratuita que pode ser descarregada no sítio Web para programadores da Apple. No entanto, terá de se registar primeiro como Mac Developer (http://developer.apple.com). Aqui pode encontrar O Guia do Utilizador do Quartz Composer da Apple.
- Patch Lua - Você precisará do patch Lua para abrir as camadas do mimoLive no Quartz Composer a partir do mimoLive 1.9. Ele é de código aberto e está disponível no GitHub. Nós usamos esse patch como um substituto para o patch JavaScript do QuartzComposer porque ele não funciona de forma estável no mimoLive. (Faça o download do patch aqui:[https://github.com/boinx/QCLua/releases )
- JSON Remendo e Patch OAuth - Existem mais dois patches personalizados que actualmente só são utilizados na camada Twitter. Quando personalizar a camada Twitter, terá de descarregar e instalar os patches antes de começar a editar.
Modelo de camada em branco
Pode utilizar o nosso ficheiro gratuito Quartz Composition como ponto de partida para as suas camadas personalizadas. Contém um conjunto básico de entradas e saídas e as propriedades necessárias que tem de alterar na caixa de diálogo "Editar informações" do Quartz Composer.
Descarregar o modelo Layer v1.0
O exemplo Hello-World
Como primeiro e fácil exemplo, vamos criar uma Composição de Quartzo básica e utilizá-la como uma camada no mimoLive.
- Iniciar a aplicação Quartz Composer
- Escolher Ficheiro ⇢ Novo espaço em branco na barra de menu. Irá obter um novo documento vazio do Quartz Composer.
- Abra a Patch Library com o botão no canto superior esquerdo. Aparecerá uma pequena janela com uma lista de todos os patches do Quartz Composer.
- Na Biblioteca de Patches, encontre o Patch chamado Billboard. Pode fazê-lo rapidamente, digitando algumas letras iniciais do nome do patch no campo de pesquisa na parte inferior da janela da Biblioteca de Patches. Este é um Patch de Renderização. Ele desenha uma imagem plana no ecrã de saída.
- Arraste o patch da biblioteca para a janela em branco do seu editor. O patch ficará colado no local onde o largar. Pode deslocá-lo clicando e arrastando-o. Atenção: O patch tem várias entradas que estão marcadas com um ponto de ligação no lado esquerdo de cada valor.
- Agora, encontre o patch Imagem com String na Biblioteca de Patches e arraste-o para a janela do editor. Posicione-o no lado direito do patch Billboard. O patch Image with String é um patch Generator que gera uma imagem contendo um texto que pode especificar com o valor de entrada String.
- Ligue a saída Image do patch Image with String à entrada Image do patch Billboard.
- Se o Visualizador do Quartz Composer não estiver visível neste momento, clique no botão Visualizador no canto superior direito. Deverá ver uma janela com um tabuleiro de xadrez no fundo e "Hello World!" em letras brancas por cima.
- Regresse à janela do Editor e clique com o botão direito do rato no patch Imagem com cadeia de caracteres para revelar um menu de contexto para o mesmo.
- Seleccionar Inserir divisor de entrada ⇢ Cadeia de caracteres desse menu de contexto. Um novo patch do tipo Input Splitter aparecerá no documento, que é conectado por sua saída à String de entrada do patch Image With String.
- Mais uma vez, clique com o botão direito do rato neste divisor de entrada recém-criado e seleccione Publicar entradas ⇢ Entrada. Aparece uma caixa de texto que pede um nome para esta entrada publicada. Altere-o para My Text (O meu texto). Tenha em atenção que esta entrada publicada é visível no mimoLive e será apresentada na vista de parâmetros à esquerda quando a camada for seleccionada no mimoLive.
- Abrir a Folha de Informação de Composição seleccionando Editor ⇢ Editar informações.... Obterá uma folha com uma lista de pares de valores chave.
- Adicione uma nova chave clicando no botão + no canto inferior esquerdo. Aparecerá uma nova linha na lista a pedir um nome para a chave.
- Introduzir tv_LayerProtocolVersion como o Imóveis, mudar o Classe de ''String'' para ''Number'' e colocar um ''1'' na opção Valor coluna.
- Clique no botão Feito no canto inferior esquerdo para fechar a folha.
- Guarde esta composição no seu ambiente de trabalho com o nome Hello World.qtz
- Inicie o mimoLive, não crie ainda um documento.
- Seleccionar Ficheiro ⇢ Importar composições de camadas... na barra de menus. Ser-lhe-á apresentada uma caixa de diálogo de escolha de ficheiros. Seleccione o ficheiro Hello World.qtz previamente guardado no Ambiente de Trabalho.
- Agora crie um novo documento mimoLive com Ficheiro ⇢ Novo.... Aparecerá o selector de modelos mimoLive.
- Seleccione o modelo Em branco e prima o botão Escolher no canto inferior direito. Aparecerá uma nova janela do mimoLive Document que contém uma única camada do Placer que o representa sentado em frente ao seu computador.
- Abra o Repositório de camadas clicando no botão "+" no canto superior direito da coluna Camadas.
- Localize a camada Hello World que acabou de importar e arraste uma instância para o topo da pilha de camadas no meio do documento.
- Localize a entrada definida pelo utilizador chamada O meu texto e altere o texto do campo de entrada.
- Depois de clicar no botão Em directo dessa camada, o seu texto aparecerá sobre o vídeo.
Parabéns! Acabaste de criar uma nova camada mimoLive! Nas secções seguintes, queremos entrar em detalhes sobre o que é necessário para ser um bom cidadão mimoLive.
Tenha em atenção que não é possível explicar como utilizar o Quartz Composer Editor em todos os pormenores nesta documentação. Se pretender saber mais sobre o Quartz Composer, leia o Guia do utilizador do Quartz Composer no site Apple Developer.
Manuseamento de camadas no mimoLive
Exportar uma camada do mimoLive
Se pretender alterar uma camada incorporada no mimoLive, pode exportar essa camada no mimoLive através dos seguintes passos:
- Abra o repositório de camadas com o botão "+" no canto superior direito da coluna Camadas.
- Localize e seleccione a camada que pretende utilizar como base para a sua nova camada.
- Abra o menu de contexto clicando com o botão direito do rato nessa camada.
- Seleccionar Exportar composição de camadas... nesse menu de contexto.
- Ser-lhe-á pedido que introduza um nome de ficheiro e que defina um local para guardar a camada.
Importar uma camada no mimoLive
Quando terminar de editar ou criar a sua camada personalizada, tem de a importar para o mimoLive. Existem várias formas de importar uma camada para o mimoLive:
Importar uma camada utilizando o menu Ficheiro
- Seleccione Ficheiro ⇢ Importar composições de camadas....
- Ser-lhe-á apresentada uma caixa de diálogo de selecção de ficheiros.
- Seleccione o seu ficheiro QuartzComposition e prima "Import" (Importar)
Importar uma camada com a extensão de nome de ficheiro ".tvlayer"
Esta técnica é útil quando envia camadas personalizadas para outros utilizadores do mimoLive (por exemplo, os seus clientes) que não estão familiarizados com a importação manual de camadas personalizadas. No entanto, não é muito útil durante o desenvolvimento, porque o QuartzComposer não abre o ficheiro quando se altera a extensão do mesmo.
- Localize a sua composição no Finder.
- Clique no nome do ficheiro uma vez para alterar o nome do ficheiro. Uma caixa à volta do nome do ficheiro indica que está prestes a alterá-lo.
- Adicione a extensão .tvlayer no final e prima Return. O Finder perguntar-lhe-á se pretende mesmo alterar a extensão. Por favor, aceite.
- Faça duplo clique no ficheiro de composição. Agora o mimoLive abrirá e importará o ficheiro como uma nova camada automaticamente. Notificá-lo-á com um alerta após o sucesso.
Camada personalizada API
mimoLive espera que as composições Quartz adoptem a Camada personalizada API. Nesta secção, aprenderá a implementação mínima.
Implementação mínima
A implementação mínima do protocolo de camadas envolve apenas as propriedades de composição do Quartz, que podem ser editadas no editor do Quartz Composer seleccionando Editor ⇢ Editar informações (⌥⌘I).
| Nome | Tipo | Valor da amostra |
|---|---|---|
| tv_LayerProtocolVersion | Número (real) | 1.2 |
| tv_LayerIdentifier | Cordas | com.example.layer.mylayer |
| tv_LayerVersion | Número (real) | 1.01 |
É importante saber como esses valores são usados pelo mimoLive para que o mimoLive possa lidar com conflitos de versões de camadas.
- tv_LayerProtocolVersion: Quando alteramos o protocolo da camada, vamos aumentar a versão do protocolo da camada. Com isto, as versões mais antigas do mimoLive são capazes de informar o utilizador se uma camada é utilizada (por exemplo, armazenada num documento mimoLive) que tem uma versão de protocolo mais recente e, portanto, pode não ser tratada correctamente pelo mimoLive.
- tv_LayerIdentifier: Este valor deve ser um valor único para cada uma de suas camadas. As nossas camadas têm o prefixo com.boinx.layer.*. Por favor, use o seu próprio esquema de modo a ter identificadores únicos em todo o mundo. Tenha em atenção que o mimoLive não utiliza o nome do ficheiro para comparar camadas!
- tv_LayerVersion: Se o mimoLive estiver a encontrar a versão da camada de forma diferente para uma camada que está armazenada num documento para a camada que está instalada no repositório de camadas, utiliza as seguintes regras para decidir o que fazer:
- Se a versão da camada de documento for superior à do repositório: manter a versão do documento
- Se a versão da camada de documento for inferior à do repositório, mas tiver o mesmo número principal (por exemplo, 2.4 vs. 2.6), substitua a camada de documento pela nova.
Se o número principal da versão da camada for diferente, o mimoLive tratará a camada como uma substituição incompatível e não actualizará a camada do documento!
Adições ao património comum
- direitos de autor:
- descrição:
- nome:
- tv_Tagline: