mimoLiveは、新しいレイヤーを追加することでカスタマイズすることができます。レイヤーの本当の力は、実はQuartz Composerと呼ばれるMacOS Xの技術で作られていることにあるのです。Quartz Composerを使えば、ほとんど何でも可能です。視聴者が投稿するインタラクティブなテレビ番組も作れます。 エスエムエス やTwitterのメッセージを画面に表示することができます。オンラインデータから株価チャートを作成する。スポーツの試合で得点を記録する。画面上でゲームをプレイする。mimoLiveに含まれるいくつかのレイヤーからインスピレーションを得ることができるかもしれません。mimoLiveと連携するためには、Quartzコンポジションに特定の要素が含まれている必要があり、mimoLiveとレイヤーが互いに会話し、mimoLiveが送信したメディアファイルをレイヤーが表示できるようにします。理論的には、誰でも自分のレイヤーを作ることができます。このページでは、Quartz Composerを使ってレイヤーを作成する方法を技術的なレベルで説明します。
カスタムレイヤーの購入
自分でQuartz Composerに入りたくない場合は、私たちにお任せください。弊社には、株価チャートなどのデータビジュアライゼーションを含むmimoLive用のレイヤーを作成した豊富な経験があります。詳しくは営業部までお問い合わせください。
カスタムレイヤーの作成 - Getting Started
mimoLiveのためのマスタークラス コーディングレイヤー
プリリクエスト
mimoLiveのレイヤー開発を始める前に、いくつかの前提条件があります：
- mimoLiveでレイヤーをテストし実行するには、有効なmimoLiveライセンスが必要です。
- Apple社のアプリケーション「Quartz Composer」をインストールしておく必要があります。Apple社のデベロッパーサイトでダウンロードできる無料の開発ツールです。ただし、最初にMac Developerとして登録する必要があります（http://developer.apple.com）。ここで、以下のものが見つかります。 Quartz Composerユーザーガイド byアップル
- ルアパッチ - mimoLive 1.9からQuartz ComposerでmimoLive Layersを開くには、Luaパッチが必要です。これはオープンソースで、GitHubから入手できます。QuartzComposerのJavaScriptパッチはmimoLiveで安定して動作しないので、このパッチを代替として使用しています。(パッチはこちらからダウンロードしてください：[https://github.com/boinx/QCLua/releases )
- JSON パッチ と OAuthパッチ - 現在、Twitterレイヤーのみで使用されているカスタムパッチが2つ追加されています。Twitterレイヤーをカスタマイズする場合は、編集を開始する前にパッチをダウンロードし、インストールする必要があります。
ブランクレイヤーテンプレート
カスタムレイヤーの出発点として、無料のQuartz Compositionファイルを使用することができます。このファイルには、入力と出力の基本セットと、Quartz Composerの「情報の編集」ダイアログで変更する必要がある必要なプロパティが含まれています。
Hello-Worldの例
最初の簡単な例として、基本的なQuartz Compositionを作成し、mimoLiveのレイヤーとして使用することにします。
- Quartz Composerアプリケーションを起動する
- 選ぶ ファイル ⇢ 新規ブランク をメニューバーから選択します。新しい空のQuartz Composerドキュメントを取得します。
- 左上隅のボタンでパッチライブラリを開きます。小さなウィンドウがポップアップし、すべてのQuartz Composerパッチのリストが表示されます。
- パッチライブラリで「Billboard」という名前のパッチを探します。パッチライブラリウィンドウの下部にある検索フィールドに、パッチ名の先頭の文字をいくつか入力すると、すぐに見つけることができます。これは、レンダーパッチです。これは、出力されたスクリーンにイメージをフラットに描画するものです。
- パッチをライブラリから空白のエディタウィンドウにドラッグしてください。パッチはドロップした場所に固定されます。クリック・ドラッグで移動させることができます。注意：パッチにはいくつかの入力があり、それぞれの値の左側に接続ドットが表示されています。
- 次に、パッチライブラリからImage with Stringパッチを探し、これをエディタウィンドウにドラッグします。これをビルボードパッチの右側に配置して下さい。Image with Stringパッチは、入力値Stringで指定したテキストを含むイメージを生成するジェネレータパッチです。
- Image with StringパッチのImage出力とBillboardパッチのImage入力を接続してください。
- 今、Quartz Composer Viewerが表示されていない場合は、右上の「Viewer」ボタンをクリックしてください。背景にチェッカーボード、その上に白い文字で「Hello World！」と書かれたウィンドウが表示されるはずです。
- Editorウィンドウに戻り、Image with Stringパッチを右クリックして、コンテキストメニューを表示させます。
- セレクト インサートインプットスプリッター ⇢ 文字列 というコンテキストメニューが表示されます。入力スプリッタタイプの新しいパッチがドキュメント上に表示され、その出力は Image With String パッチの入力 String に接続されています。
- この新しく作成された入力スプリッターを再び右クリックし、選択します。 インプットを公開する ⇢ インプット.テキストボックスが表示され、この公開された入力の名前を尋ねられます。My Textに変更します。この公開された入力はmimoLiveに表示され、mimoLiveでレイヤーを選択すると左側のパラメータビューに表示されることに注意してください。
- を選択して、「作曲情報シート」を開きます。 エディター ⇢ 情報を編集する....キーとバリューのペアのリストを持つシートが表示されます。
- 左下の「＋」ボタンをクリックして、新しいキーを追加します。リストに新しい行が表示され、キー名を入力するよう求められます。
- として、tv_LayerProtocolVersionを入力します。 プロパティを切り替えてください。 クラス オプションを''String''から''Number''に変更し、''1''を入れる。 価値観 の欄があります。
- をクリックします。 完了 ボタンをクリックすると、シートが閉じます。
- このコンポジションをHello World.qtzという名前でデスクトップに保存します。
- mimoLiveを起動し、まだドキュメントを作成しないでください。
- セレクト ファイル ⇢ レイヤーコンポジションのインポート... をメニューバーから選択します。File chooserダイアログが表示されます。デスクトップに保存されているHello World.qtzを選択してください。
- で新しいmimoLiveドキュメントを作成します。 ファイル ⇢ 新規作成....mimoLive Template Chooserが表示されます。
- Blankテンプレートを選択し、右下隅にある「選択」ボタンを押します。新しいmimoLiveドキュメントウィンドウが表示され、コンピュータの前に座っているあなた自身をレンダリングした1枚のPlacerレイヤーが含まれています。
- レイヤー欄の右上にある「＋」ボタンをクリックして、レイヤーリポジトリを開きます。
- インポートしたHello Worldレイヤーを見つけ、インスタンスをドキュメントの真ん中にあるレイヤースタックの一番上にドラッグします。
- My Textという自分で定義した入力項目を探し、入力欄のテキストを変更します。
- そのレイヤーのライブボタンをクリックすると、映像の上にテキストが表示されます。
おめでとうございます！あなたは今、新しいミモライブレイヤーを作成しました！次のセクションでは、良いミモライブ市民になるために必要なことを詳しく説明したいと思います。
このドキュメントでは、Quartz Composer Editorの使用方法をすべて説明することはできませんので、ご了承ください。Quartz Composerについてもっと詳しく知りたい方は、Apple Developer websiteのThe Quartz Composer User Guideをお読みください。
ミモライブでレイヤーを扱う
ミモライブからレイヤーをエクスポートする
内蔵されているミモライブレイヤーを変更したい場合は、以下の手順でミモライブのレイヤーをエクスポートすることができます：
- レイヤー欄の右上にある「＋」ボタンで、レイヤーリポジトリを開く。
- 新しいレイヤーのベースとして使用したいレイヤーを見つけて選択します。
- そのレイヤーを右クリックして、コンテキストメニューを開きます。
- セレクト レイヤーコンポジションをエクスポートする... をクリックすると、そのコンテキストメニューに表示されます。
- ファイル名の入力と、レイヤーを保存する場所の設定が求められます。
ミモライブでレイヤーをインポートする
カスタムレイヤーの編集や作成が終わったら、レイヤーをミモライブにインポートする必要があります。レイヤーをmimoLiveにインポートするには、いくつかの方法があります：
ファイルメニューでレイヤーをインポートする
- ファイル ⇢ レイヤーコンポジションのインポート...を選択します。
- File chooserのダイアログが表示されます。
- QuartzCompositionのファイルを選択し、"Import "を押してください。
ファイル名の拡張子".tvlayer "でレイヤーを読み込む
このテクニックは、カスタムレイヤーを手動でインポートすることに慣れていない他のmimoLiveユーザー（クライアントなど）にカスタムレイヤーを送信するときに便利です。しかし、開発中はあまり便利ではありません。QuartzComposerは、ファイルの拡張子を変更してもファイルを開かないからです。
- Finderでコンポジションを探します。
- ファイル名を1回クリックすると、ファイル名を変更することができます。ファイル名を囲むボックスは、変更しようとしていることを示します。
- 最後に拡張子.tvlayerを追加し、Returnを押します。Finderが、本当に拡張子を変更するかどうか聞いてきます。受けてください。
- コンポジションファイルをダブルクリックします。これで、mimoLiveは自動的にファイルを開き、新しいレイヤーとしてインポートします。成功するとアラートで通知されます。
カスタムレイヤー エーピーアイ
を採用したクォーツコンポジションにmimoLiveは期待する。 カスタムレイヤー エーピーアイ.このセクションでは、最小限の実装を学びます。
最小限の実装
レイヤープロトコルの最小限の実装では、Editor ⇢ Edit information (↪So_23⌘I) を選択して Quartz Composer エディターで編集できる Quartz Composition Properties だけを使用します。
| 名称 | タイプ | サンプル値 |
|---|---|---|
| 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 vs 2.6）、ドキュメントレイヤーを新しいものに置き換えます。
レイヤーのバージョンメジャー番号が異なる場合、mimoLiveはそのレイヤーを互換性のない代替品として扱い、ドキュメントレイヤーを更新しない！
コモン・プロパティーの追加
- のコピーライトを使用しています：
- を記述します：
- という名前を付けます：
- tv_Taglineです：
