mimoLive можно настраивать, добавляя новые слои. Настоящая сила слоев заключается в том, что они создаются с помощью технологии MacOS X под названием Quartz Composer. С помощью композиций Quartz можно сделать практически все. Вы можете создавать интерактивные телешоу, в которых ваши зрители могут присылать SMS или сообщения twitter, которые отображаются на экране. Создавайте биржевые графики на основе онлайн-данных. Вести счет в спортивном матче. Играйте в игры на экране. Вы можете найти вдохновение в некоторых слоях, входящих в состав mimoLive. Для работы с mimoLive кварцевые композиции должны содержать определенные элементы, чтобы mimoLive и слой могли общаться друг с другом и чтобы слой мог отображать медиафайлы, которые mimoLive отправляет ему. Теоретически, каждый может создавать свои собственные слои. Эта страница описывает на техническом уровне, как создавать слои с помощью Quartz Composer.
Приобретение пользовательского слоя
Если вы не хотите самостоятельно копаться в Quartz Composer, позвольте нам сделать это за вас. У нас большой опыт создания слоев для mimoLive, включая визуализацию данных, таких как биржевые графики, который вы можете использовать для создания именно того слоя, который вам нужен. Пожалуйста, свяжитесь с отделом продаж для деталей.
Создание пользовательского слоя - начало работы
Мастер-класс по кодированию слоев для mimoLive
Предварительная подготовка
Прежде чем приступить к разработке слоев для mimoLive, необходимо выполнить некоторые предварительные условия:
- Чтобы тестировать и запускать слои в mimoLive, необходимо иметь действующую лицензию mimoLive.
- У вас должно быть установлено приложение Quartz Composer от Apple. Это бесплатное средство разработки, которое можно скачать на сайте разработчиков Apple. Однако сначала вам нужно зарегистрироваться в качестве разработчика Mac (http://developer.apple.com). Здесь вы можете найти Руководство пользователя Quartz Composer от Apple.
- Патч Lua - Вам понадобится патч Lua для открытия слоев mimoLive в Quartz Composer, начиная с версии mimoLive 1.9. Он имеет открытый исходный код и доступен на GitHub. Мы используем этот патч в качестве замены JavaScript-патча QuartzComposer, поскольку он не работает стабильно в mimoLive. (Скачать патч можно отсюда:[https://github.com/boinx/QCLua/releases )
- JSON Патч и Патч для OAuth - Есть еще два пользовательских патча, которые в настоящее время используются только в слое Twitter. При настройке слоя Twitter вам нужно будет загрузить и установить патчи перед началом редактирования.
Шаблон пустого слоя
Вы можете использовать наш бесплатный файл Quartz Composition в качестве отправной точки для создания пользовательских слоев. Он содержит базовый набор входов и выходов и необходимые свойства, которые нужно изменить в диалоге "Редактировать информацию" Quartz Composer.
Пример Hello-World
В качестве первого и простого примера мы создадим базовую кварцевую композицию и используем ее в качестве слоя в mimoLive.
- Запустите приложение Quartz Composer
- Выберите Файл ⇢ Новый пустой в строке меню. Вы получите новый пустой документ Quartz Composer.
- Откройте Библиотеку патчей с помощью кнопки в левом верхнем углу. Появится небольшое окно со списком всех патчей Quartz Composer.
- В библиотеке патчей найдите патч с названием Billboard. Вы можете сделать это быстро, введя несколько ведущих букв названия патча в поле поиска в нижней части окна библиотеки патчей. Это патч рендеринга. Он рисует плоское изображение на экране вывода.
- Перетащите патч из библиотеки в пустое окно редактора. Патч прикрепится там, куда вы его перетащите. Вы можете перемещать его, нажимая и перетаскивая. Обратите внимание: патч имеет несколько входов, которые отмечены точкой соединения слева от каждого значения.
- Теперь найдите патч Image with String в библиотеке патчей и перетащите его в окно редактора. Расположите его справа от патча Billboard. Патч Image with String - это патч-генератор, который будет генерировать изображение, содержащее текст, который вы можете указать с помощью входного значения String.
- Соедините выход Image патча Image with String со входом Image патча Billboard.
- Если окно Quartz Composer Viewer сейчас не видно, нажмите на кнопку Viewer в правом верхнем углу. Вы должны увидеть окно с шашечной доской на заднем плане и надписью "Hello World!" белыми буквами.
- Вернитесь в окно редактора и щелкните правой кнопкой мыши на патче Image with String, чтобы открыть для него контекстное меню.
- Выберите Вставка входного разделителя ⇢ Строка этого контекстного меню. В документе появится новый патч типа Input Splitter, который своим выходом соединен с входом String патча Image With String.
- Снова щелкните правой кнопкой мыши на только что созданном входном разветвителе и выберите Публикация входов ⇢ Вход. Появится текстовое поле с запросом на имя для этого опубликованного ввода. Измените его на "Мой текст". Обратите внимание, что этот опубликованный вход виден в mimoLive и будет представлен в представлении параметров слева, когда слой выбран в mimoLive.
- Откройте Информационный лист композиции, выбрав Редактор ⇢ Редактирование информации.... Вы получите лист со списком пар ключ-значение.
- Добавьте новый ключ, нажав кнопку + в левом нижнем углу. В списке появится новая строка с запросом имени ключа.
- Введите tv_LayerProtocolVersion в качестве Недвижимость, переключите Класс опцию из ''String'' в ''Number'' и поместите ''1'' в Значение колонна.
- Нажмите на кнопку Готово Кнопка в левом нижнем углу, чтобы закрыть лист.
- Сохраните эту композицию на рабочем столе с именем Hello World.qtz
- Запустите mimoLive, но пока не создавайте документ.
- Выберите Файл ⇢ Импорт композиций слоев... из строки меню. Появится диалоговое окно выбора файла. Выберите файл Hello World.qtz, ранее сохраненный на Рабочем столе.
- Теперь создайте новый документ mimoLive с Файл ⇢ Новый.... Появится окно выбора шаблонов mimoLive.
- Выберите шаблон Blank и нажмите кнопку Choose в правом нижнем углу. Появится новое окно документа mimoLive Document, содержащее один слой Placer, на котором изображен вы, сидящий перед компьютером.
- Откройте хранилище слоев, нажав на кнопку "+" в правом верхнем углу колонки "Слои".
- Найдите слой Hello World, который вы только что импортировали, и перетащите его экземпляр в верхнюю часть стека слоев в центре документа.
- Найдите самоопределяющийся вход под названием My Text и измените текст поля ввода.
- После нажатия кнопки Live на этом слое ваш текст появится поверх видео.
Поздравляем! Вы только что создали новый слой mimoLive! В следующих разделах мы подробно расскажем о том, что необходимо для того, чтобы стать хорошим жителем mimoLive.
Обратите внимание, что в этой документации мы не можем подробно рассказать о том, как использовать Quartz Composer Editor. Если вы хотите узнать больше о Quartz Composer, пожалуйста, прочитайте Руководство пользователя Quartz Composer на сайте разработчиков Apple.
Работа со слоями в mimoLive
Экспорт слоя из mimoLive
Если вы хотите изменить встроенный слой mimoLive, вы можете экспортировать этот слой в mimoLive, выполнив следующие действия:
- Откройте хранилище слоев с помощью кнопки "+" в правом верхнем углу колонки "Слои".
- Найдите и выберите слой, который вы хотите использовать в качестве основы для нового слоя.
- Откройте контекстное меню, щелкнув правой кнопкой мыши на этом слое.
- Выберите Экспорт состава слоев... в этом контекстном меню.
- Вам будет предложено ввести имя файла и указать место сохранения слоя.
Импорт слоя в mimoLive
После того, как вы закончили редактирование или создание пользовательского слоя, вам необходимо импортировать его в mimoLive. Существует несколько способов импортировать слой в mimoLive:
Импорт слоя с помощью меню Файл
- Выберите Файл ⇢ Импорт композиций слоев.....
- Появится диалоговое окно выбора файлов.
- Выберите файл QuartzComposition и нажмите кнопку "Импорт".
Импорт слоя с расширением имени файла ".tvlayer"
Эта техника полезна при отправке пользовательских слоев другим пользователям mimoLive (например, вашим клиентам), которые не знакомы с ручным импортом пользовательских слоев. Однако она не очень удобна в процессе разработки, поскольку QuartzComposer не откроет файл при изменении его расширения.
- Найдите свою композицию в Finder.
- Щелкните по имени файла один раз, чтобы изменить его название. Поле вокруг имени файла указывает на то, что вы собираетесь его изменить.
- Добавьте в конце расширение .tvlayer и нажмите Return. Finder спросит вас, действительно ли вы хотите изменить расширение. Пожалуйста, согласитесь.
- Дважды щелкните по файлу композиции. Теперь mimoLive откроет и автоматически импортирует файл как новый слой. При успешном завершении процесса он оповестит вас об этом.
Пользовательский слой API
mimoLive ожидают, что композиции Quartz примут Пользовательский слой API. В этом разделе вы познакомитесь с минимальной реализацией.
Минимальная реализация
Минимальная реализация протокола Layer Protocol включает только свойства композиции Quartz, которые можно редактировать в редакторе Quartz Composer, выбрав Редактор ⇢ Редактирование информации (⌥⌘I).
| Имя | Тип | Образец значения |
|---|---|---|
| tv_LayerProtocolVersion | Число (реальное) | 1.2 |
| tv_LayerIdentifier | Строка | com.example.layer.mylayer |
| tv_LayerVersion | Число (реальное) | 1.01 |
Важно знать, как эти значения используются mimoLive, чтобы mimoLive мог справиться с конфликтами версий слоев.
- tv_LayerProtocolVersion: Когда мы изменяем протокол слоя, мы увеличиваем версию протокола слоя. Благодаря этому старые версии mimoLive могут сообщить пользователю, если используется слой (например, сохраненный в документе mimoLive), который имеет более новую версию протокола и поэтому может быть неправильно обработан mimoLive.
- tv_LayerIdentifier: Это значение должно быть уникальным для каждого из ваших слоев. Наши слои имеют префикс com.boinx.layer.*. Пожалуйста, используйте свою собственную схему, чтобы иметь уникальные идентификаторы по всему миру. Обратите внимание, что mimoLive не использует имя файла для сравнения слоев!
- tv_LayerVersion: Если mimoLive обнаруживает, что версия слоя отличается для слоя, хранящегося в документе, от версии слоя, установленного в хранилище слоев, он использует следующие правила, чтобы решить, что делать:
- Если версия слоя документа больше, чем версия хранилища: сохраните версию документа.
- Если версия слоя документа меньше версии хранилища, но имеет одинаковый основной номер (например, 2.4 против 2.6), замените слой документа на новый.
Если основной номер версии слоя отличается, то mimoLive будет рассматривать этот слой как несовместимую замену и не будет обновлять слой документа!
Дополнения к общему имуществу
- Авторское право:
- описание:
- имя:
- tv_Tagline: