mimoLive можна налаштовувати, додаючи нові шари. Справжня сила шарів полягає в тому, що вони фактично створені за допомогою технології MacOS X, яка називається Quartz Composer. З Quartz Compositions можливо майже все. Ви можете створювати інтерактивні телепередачі, в яких ваша аудиторія може надсилати SMS або твіттер-повідомлення, які відображаються на екрані. Створюйте біржові графіки на основі онлайн-даних. Ведіть рахунок у спортивному матчі. Грайте в ігри на екрані. Ви можете знайти натхнення в деяких шарах, що входять до складу mimoLive. Щоб працювати з mimoLive, кварцові композиції повинні містити певні елементи, щоб mimoLive і шар могли спілкуватися один з одним і щоб шар міг відображати медіафайли, які надсилає йому mimoLive. Теоретично, будь-хто може створювати власні шари. Ця сторінка описує на технічному рівні, як створювати шари за допомогою Quartz Composer.
Придбання кастомного шару
Якщо ви не хочете самостійно копатися в Quartz Composer, дозвольте нам зробити це за вас. Ми маємо великий досвід створення шарів для mimoLive, включаючи візуалізацію даних, таких як біржові графіки, який ви можете використати для створення саме того шару, який вам потрібен. Будь ласка, зверніться до нас зверніться до відділу продажів за подробицями.
Створення користувацького шару - Початок роботи
Майстер-клас Кодування шарів для mimoLive
Попередні заявки
Перш ніж ви зможете розпочати розробку шарів для mimoLive, необхідно виконати деякі попередні умови:
- Щоб тестувати і запускати шари в mimoLive, вам потрібна дійсна ліцензія mimoLive.
- У вас має бути встановлений додаток Quartz Composer від Apple. Це безкоштовний інструмент розробки, який можна завантажити на сайті Apple для розробників. Однак спершу вам потрібно буде зареєструватися як Mac Developer (http://developer.apple.com). Тут ви можете знайти Посібник користувача Quartz Composer від Apple.
- Lua Patch - Вам знадобиться патч 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. Ви можете зробити це швидко, ввівши кілька перших літер назви патча у поле пошуку внизу вікна бібліотеки патчів. Це - патч-візуалізатор. Він малює пласке зображення на екрані виводу.
- Перетягніть патч з бібліотеки до порожнього вікна редактора. Латка буде закріплена там, де ви її перетягнете. Ви можете переміщати його, перетягуючи клацанням миші. Зверніть увагу: патч має кілька входів, які позначено крапкою з'єднання ліворуч від кожного значення.
- Тепер знайдіть у бібліотеці патчів патч "Зображення з рядком" і перетягніть його у вікно редактора. Розташуйте його праворуч від патча Billboard. Патч "Зображення з рядком" - це патч-генератор, який створить зображення, що містить текст, який ви можете вказати за допомогою вхідного значення String.
- З'єднайте вихід Зображення з патчу Зображення з рядком із входом Зображення з патчу Рекламний щит.
- Якщо вікно Quartz Composer Viewer зараз не відображається, натисніть на кнопку Viewer у верхньому правому куті. Ви побачите вікно з шаховою дошкою на тлі і написом "Hello World!" білими літерами над нею.
- Поверніться у вікно редактора і клацніть правою кнопкою миші на патчі "Зображення з рядком", щоб викликати контекстне меню для нього.
- Виберіть Вставити роздільник вводу ⇢ Рядок цього контекстного меню. У документі з'явиться новий патч типу Input Splitter, який буде підключено своїм виходом до входу String патчу Image With String.
- Знову клацніть правою кнопкою миші на цьому новоствореному роздільнику входів і виберіть Опублікувати вхідні дані ⇢ Вхідні дані. З'явиться текстове вікно із запитом на введення назви для цього опублікованого запису. Введіть "Мій текст". Зверніть увагу, що ці опубліковані дані є видимими для mimoLive і будуть показані на панелі параметрів ліворуч, коли шар буде вибрано у mimoLive.
- Відкрийте Інформаційний лист складу, вибравши Редактор ⇢ Редагувати інформацію.... Ви отримаєте аркуш зі списком пар ключових значень.
- Додайте новий ключ, натиснувши кнопку + внизу ліворуч. У списку з'явиться новий рядок із запитом назви ключа.
- Введіть tv_LayerProtocolVersion як параметр Власністьперемкніть кнопку Клас. з ''Рядок'' на ''Число'' і введіть ''1'' в поле Значення колонку.
- Натисніть на кнопку Зроблено. у лівому нижньому кутку, щоб закрити аркуш.
- Збережіть цю композицію на Робочому столі з назвою Hello World.qtz
- Запустіть mimoLive, не створюйте поки що документ.
- Виберіть Файл ⇢ Імпорт композицій шарів... у рядку меню. На екрані з'явиться діалогове вікно вибору файлу. Виберіть файл Hello World.qtz, попередньо збережений на Робочому столі.
- Тепер створіть новий документ mimoLive за допомогою Файл ⇢ Новий.... З'явиться вікно вибору шаблонів mimoLive.
- Виберіть шаблон "Порожній" і натисніть кнопку "Вибрати" у правому нижньому куті. З'явиться нове вікно mimoLive Document з одним шаром Placer, у якому ви сидите перед комп'ютером.
- Відкрийте Сховище шарів, натиснувши кнопку "+" у верхньому правому куті стовпчика Шари.
- Знайдіть шар Hello World, який ви щойно імпортували, і перетягніть його екземпляр на вершину стека шарів у центрі документа.
- Знайдіть своє власне поле вводу під назвою "Мій текст" і змініть текст поля вводу.
- Після натискання кнопки Live на цьому шарі ваш текст з'явиться поверх відео.
Вітаємо! Ви щойно створили новий шар mimoLive! У наступних розділах ми хочемо заглибитися в деталі того, що необхідно для того, щоб бути хорошим громадянином mimoLive.
Зверніть увагу, що в цій документації ми не можемо пояснити, як користуватися редактором Quartz Composer у всіх деталях. Якщо ви хочете дізнатися більше про Quartz Composer, будь ласка, прочитайте Посібник користувача Quartz Composer на веб-сайті Apple Developer.
Робота з шарами у mimoLive
Експорт шару з mimoLive
Якщо ви хочете змінити вбудований шар mimoLive, ви можете експортувати цей шар у mimoLive, виконавши наступні кроки:
- Відкрийте сховище шарів за допомогою кнопки "+" у верхньому правому куті стовпчика Шари.
- Знайдіть і виберіть шар, який ви хочете використати як основу для нового шару.
- Відкрийте контекстне меню, клацнувши правою кнопкою миші на цьому шарі.
- Виберіть Експортувати склад шарів... у цьому контекстному меню.
- Вам буде запропоновано ввести ім'я файлу і вказати місце збереження шару.
Імпорт шару в mimoLive
Після того, як ви закінчили редагування або створення власного шару, вам потрібно імпортувати його до mimoLive. Існує декілька способів імпортувати шар до mimoLive:
Імпорт шару за допомогою меню Файл
- Виберіть Файл ⇢ Імпортувати композиції шарів....
- Вам буде запропоновано діалогове вікно вибору файлу.
- Виберіть файл QuartzComposition і натисніть кнопку "Імпортувати"
Імпорт шару з розширенням імені файлу ".tvlayer"
Ця техніка корисна для надсилання користувацьких шарів іншим користувачам mimoLive (наприклад, вашим клієнтам), які не знайомі з ручним імпортом користувацьких шарів. Однак це не дуже зручно під час розробки, оскільки QuartzComposer не відкриє файл при зміні його розширення.
- Знайдіть свою композицію у Finder.
- Клацніть на назві файлу один раз, щоб змінити його назву. Рамка навколо назви файлу вказує на те, що ви збираєтеся її змінити.
- Додайте в кінці розширення .tvlayer і натисніть клавішу Return. Finder запитає вас, чи дійсно ви хочете змінити розширення. Будь ласка, погодьтеся.
- Двічі клацніть файл композиції. Тепер mimoLive відкриє та автоматично імпортує файл як новий шар. У разі успіху програма сповістить вас про це сповіщенням.
Користувацький шар API
mimoLive очікує, що Quartz Compositions приймуть Користувацький шар API. У цьому розділі ви дізнаєтеся про мінімальну реалізацію.
Мінімальна реалізація
Мінімальна реалізація Layer Protocol включає лише властивості Quartz Composition Properties, які можна редагувати у редакторі 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 знаходить версію шару, яка відрізняється від версії шару, що зберігається у документі, та шару, встановленого у сховищі шарів, то mimoLive використовує наступні правила, щоб вирішити, що робити:
- Якщо версія шару документа більша за версію сховища: зберегти версію документа
- Якщо версія шару документа менша за версію сховища, але має той самий головний номер (наприклад, 2.4 проти 2.6), то замініть шар документа на новий.
Якщо основний номер версії шару відрізняється, то mimoLive вважатиме шар несумісною заміною і не оновить шар документа!
Доповнення спільного майна
- авторське право:
- опис:
- ім'я:
- tv_Tagline: