Lapisan khusus

mimoLive dapat dikustomisasi dengan menambahkan layer baru. Kekuatan sebenarnya dari layer terletak pada kenyataan bahwa layer tersebut sebenarnya dibuat dengan teknologi MacOS X yang disebut Quartz Composer. Hampir semua hal dapat dilakukan dengan Quartz Compositions. Anda dapat membuat acara TV interaktif di mana penonton Anda dapat mengirimkan SMS atau pesan twitter yang ditampilkan di layar. Membuat grafik saham dari data online. Menyimpan skor dalam pertandingan olahraga. Memainkan game di layar. Anda dapat menemukan inspirasi di beberapa lapisan yang disertakan dengan mimoLive. Untuk bekerja dengan mimoLive, Komposisi Kuarsa harus berisi elemen tertentu sehingga mimoLive dan layer dapat berbicara satu sama lain dan layer dapat menampilkan file media yang dikirimkan mimoLive kepadanya. Secara teori, setiap orang dapat membuat layer mereka sendiri. Halaman ini menjelaskan secara teknis cara membuat layer menggunakan Quartz Composer.

Membeli lapisan khusus

Jika Anda tidak ingin mempelajari Quartz Composer sendiri, biarkan kami yang melakukannya untuk Anda. Kami memiliki pengalaman yang luas dalam membuat layer untuk mimoLive, termasuk visualisasi data seperti grafik saham, yang dapat Anda manfaatkan untuk membuat layer yang tepat untuk Anda. Silakan hubungi bagian penjualan untuk detailnya.

Membuat Lapisan Khusus - Memulai

Lapisan Pengkodean Kelas Master untuk mimoLive

Pra-Persyaratan

Ada beberapa prasyarat sebelum Anda dapat mulai mengembangkan layer untuk mimoLive:

• Anda harus memiliki lisensi mimoLive yang valid untuk menguji dan menjalankan layer Anda di mimoLive.
• Anda harus menginstal aplikasi Quartz Composer dari Apple. Ini adalah alat pengembangan gratis yang dapat Anda unduh di situs web pengembang Apple. Namun Anda harus mendaftar sebagai Pengembang Mac terlebih dahulu (http://developer.apple.com). Di sini Anda dapat menemukan Panduan Pengguna Quartz Composer oleh Apple.
• Lua Patch - Anda memerlukan patch Lua untuk membuka mimoLive Layers di Quartz Composer yang dimulai dengan mimoLive 1.9. Patch ini bersifat open source dan tersedia di GitHub. Kami menggunakan patch ini sebagai pengganti patch JavaScript QuartzComposer karena patch ini tidak berjalan stabil di mimoLive. (Unduh tambalan dari sini:[https://github.com/boinx/QCLua/releases )
• JSON Patch dan Patch OAuth - Ada dua tambalan khusus yang saat ini hanya digunakan di layer Twitter. Ketika menyesuaikan layer Twitter, Anda perlu mengunduh dan menginstal tambalan sebelum mulai mengedit.

Templat Lapisan Kosong
Anda dapat menggunakan file Quartz Composition gratis kami sebagai titik awal untuk layer kustom Anda. File ini berisi seperangkat input dan output dasar serta properti yang diperlukan yang perlu Anda ubah dalam Dialog "Edit Informasi" di Quartz Composer.

Unduh Templat Lapisan v1.0

Contoh Hello-World

Sebagai contoh pertama dan mudah, kita akan membuat Komposisi Kuarsa dasar dan menggunakannya sebagai layer di mimoLive.

1. Mulai aplikasi Quartz Composer
2. Pilih File ⇢ Kosong Baru di bilah menu. Anda akan mendapatkan dokumen Quartz Composer kosong yang baru.
3. Buka Patch Library dengan tombol di sudut kiri atas. Sebuah jendela kecil akan muncul dengan daftar semua patch Quartz Composer.
4. Di Perpustakaan Patch, cari Patch bernama Billboard. Anda dapat melakukannya dengan cepat dengan mengetikkan beberapa huruf depan dari nama patch pada bidang pencarian di bagian bawah jendela Patch Library. Ini adalah Patch Render. Patch ini menggambar gambar secara datar pada layar output.
5. Seret patch dari perpustakaan ke jendela editor kosong Anda. Tambalan akan menempel di tempat Anda menjatuhkannya. Anda dapat memindahkannya dengan cara klik-seret. Harap diperhatikan: Patch memiliki beberapa input yang ditandai dengan titik koneksi di sisi kiri setiap nilai.
6. Sekarang cari patch Image with String di Patch Library dan seret patch ini ke jendela editor Anda. Posisikan di sisi kanan patch Billboard. Patch Gambar dengan String adalah patch Generator yang akan menghasilkan gambar yang berisi teks yang dapat Anda tentukan dengan nilai input String.
7. Hubungkan output Gambar dari patch Gambar dengan String dengan input Gambar dari patch Billboard.
8. Jika Quartz Composer Viewer tidak terlihat sekarang, klik tombol Viewer di sudut kanan atas. Anda akan melihat jendela dengan papan catur di latar belakang dan "Hello World!" dalam huruf putih di atasnya.
9. Kembali ke jendela Editor dan klik kanan pada patch Image with String untuk membuka menu konteksnya.
10. Pilih Sisipkan Pembagi Masukan ⇢ String dari menu konteks tersebut. Sebuah patch baru dengan tipe Input Splitter akan muncul pada dokumen yang dihubungkan oleh outputnya ke input String dari patch Image With String.
11. Sekali lagi klik kanan pada pembagi input yang baru dibuat ini dan pilih Menerbitkan Masukan ⇢ Masukan. Kotak teks akan muncul dan meminta nama untuk input yang dipublikasikan ini. Ubah menjadi Teks Saya. Harap dicatat bahwa input yang dipublikasikan ini dapat dilihat oleh mimoLive dan akan ditampilkan pada tampilan parameter di sebelah kiri ketika layer dipilih di mimoLive.
12. Buka Lembar Informasi Komposisi dengan memilih Editor ⇢ Edit Informasi.... Anda akan mendapatkan lembar dengan daftar pasangan nilai kunci.
13. Tambahkan kunci baru dengan mengklik tombol + di kiri bawah. Baris baru akan muncul dalam daftar yang menanyakan nama kunci.
14. Masukkan tv_LayerProtocolVersion sebagai Properti, alihkan tombol Kelas dari ''String'' menjadi ''Angka'' dan masukkan ''1'' ke dalam Nilai kolom.
15. Klik tombol Selesai. di sudut kiri bawah untuk menutup lembar kerja.
16. Simpan komposisi ini ke Desktop Anda dengan nama Hello World.qtz
17. Mulai mimoLive, jangan membuat dokumen dulu.
18. Pilih File ⇢ Impor Komposisi Lapisan... dari bilah menu. Anda akan diminta untuk memilih file pada dialog File chooser. Pilih file Hello World.qtz yang sebelumnya disimpan di Desktop.
19. Sekarang buat dokumen mimoLive baru dengan Mengajukan ⇢ Baru.... Pemilih Template mimoLive akan muncul.
20. Pilih template Blank dan tekan tombol Pilih di sudut kanan bawah. Jendela Dokumen mimoLive baru akan muncul berisi satu layer Placer yang menampilkan diri Anda sedang duduk di depan komputer.
21. Buka Repositori Layer dengan mengklik tombol "+" di sudut kanan atas kolom Layers.
22. Temukan layer Hello World yang baru saja Anda impor dan seret contoh ke bagian atas tumpukan layer di tengah dokumen.
23. Temukan input yang Anda tentukan sendiri yang disebut Teks Saya dan ubah teks bidang input.
24. Setelah mengklik tombol Live pada layer tersebut, teks Anda akan muncul di atas video.

Selamat! Anda baru saja membuat layer mimoLive baru! Pada bagian berikut ini kami akan menjelaskan secara detail apa saja yang diperlukan untuk menjadi warga mimoLive yang baik.

Harap diperhatikan, bahwa kami tidak dapat menjelaskan cara menggunakan Quartz Composer Editor secara detail dalam dokumentasi ini. Jika Anda ingin mempelajari lebih lanjut tentang Quartz Composer, silakan baca Panduan Pengguna Quartz Composer di situs web Pengembang Apple.

Menangani lapisan di mimoLive

Mengekspor layer dari mimoLive

Jika Anda ingin mengubah layer mimoLive bawaan, Anda dapat mengekspor layer tersebut di mimoLive dengan langkah-langkah berikut:

• Buka repositori layer dengan tombol "+" di sudut kanan atas kolom Layers.
• Temukan dan pilih layer yang ingin Anda gunakan sebagai dasar untuk layer baru Anda.
• Buka menu konteks dengan mengklik kanan pada layer tersebut.
• Pilih Komposisi Lapisan Ekspor... dalam menu konteks tersebut.
• Anda akan diminta untuk memasukkan nama file dan menetapkan lokasi untuk menyimpan layer.

Mengimpor layer di mimoLive

Setelah Anda selesai mengedit atau membuat layer kustom, Anda harus mengimpor layer Anda ke mimoLive. Ada beberapa cara untuk mengimpor layer ke mimoLive:

Mengimpor layer menggunakan menu File

• Pilih File ⇢ Impor Komposisi Lapisan....
• Anda akan diminta oleh dialog pemilih File.
• Pilih file QuartzComposition Anda dan tekan "Impor"

Mengimpor layer menggunakan ekstensi nama file ".tvlayer"

Teknik ini berguna ketika mengirimkan layer kustom ke pengguna mimoLive lainnya (misalnya klien Anda) yang tidak terbiasa mengimpor layer kustom secara manual. Namun, hal ini tidak terlalu berguna ketika dalam tahap pengembangan, karena QuartzComposer tidak akan membuka file tersebut ketika mengubah ekstensinya.

• Temukan komposisi Anda di Finder.
• Klik pada nama file sekali untuk mengubah nama file. Kotak di sekitar nama file menunjukkan bahwa Anda akan mengubahnya.
• Tambahkan ekstensi .tvlayer di bagian akhir dan tekan Return. Finder akan menanyakan apakah Anda benar-benar ingin mengubah ekstensi. Silakan terima.
• Klik dua kali file komposisi. Sekarang mimoLive akan membuka dan mengimpor file tersebut sebagai layer baru secara otomatis. Ini akan memberi tahu Anda dengan peringatan setelah berhasil.

Lapisan Khusus API

mimoLive mengharapkan Komposisi Kuarsa untuk mengadopsi Lapisan Khusus API. Di bagian ini Anda akan mempelajari implementasi minimal.

Implementasi Minimal

Implementasi minimal dari Layer Protocol hanya melibatkan Properti Komposisi Kuarsa yang dapat diedit di editor Quartz Composer dengan memilih Editor ⇢ Edit informasi (⌥⌘I).

Penting untuk mengetahui bagaimana nilai-nilai tersebut digunakan oleh mimoLive sehingga mimoLive dapat menangani konflik versi layer.

• tv_LayerProtocolVersion: Setiap kali kita mengubah Protokol Layer, kita akan meningkatkan versi protokol layer. Dengan versi mimoLive yang lebih lama ini, mimoLive dapat memberi tahu pengguna jika sebuah layer digunakan (misalnya disimpan dalam dokumen mimoLive) yang memiliki versi protokol yang lebih baru dan oleh karena itu tidak dapat diperlakukan dengan benar oleh mimoLive.
• tv_LayerIdentifier: Nilai ini harus merupakan nilai unik untuk setiap layer Anda. Layer kami memiliki awalan com.boinx.layer.*. Silakan gunakan skema Anda sendiri untuk mendapatkan pengenal unik di seluruh dunia. Harap dicatat bahwa mimoLive tidak menggunakan nama file untuk membandingkan layer!
• tv_LayerVersion: Jika mimoLive menemukan versi layer yang berbeda untuk layer yang disimpan di dokumen dengan layer yang diinstal di repositori layer, mimoLive menggunakan aturan berikut untuk memutuskan apa yang harus dilakukan:
  - Jika versi lapisan dokumen lebih dari repositori: pertahankan versi dokumen
  - Jika versi layer dokumen lebih kecil dari repositori, tetapi nomor mayornya sama (misalnya 2.4 vs 2.6), maka ganti layer dokumen dengan yang baru.
  Jika nomor utama versi layer berbeda, maka mimoLive akan memperlakukan layer tersebut sebagai pengganti yang tidak kompatibel dan tidak akan memperbarui layer dokumen!

Penambahan Properti Umum

• hak cipta:
• deskripsi:
• nama:
• tv_Tagline: