自定义层

mimoLive可以通过添加新的层来定制。图层的真正力量在于它们实际上是用MacOS X技术制作的，称为Quartz Composer。用Quartz Compositions几乎什么都可以做。你可以创建互动的电视节目，你的观众可以在节目中发送 短信 或twitter上的信息，这些信息显示在屏幕上。根据在线数据创建股票图表。在体育比赛中保持分数。在屏幕上玩游戏。你可以从mimoLive包含的一些图层中找到灵感。为了和mimoLive一起工作，Quartz Compositions必须包含某些元素，这样mimoLive和图层就可以互相交流，图层可以显示mimoLive发送给它的媒体文件。理论上，任何人都可以制作自己的图层。本页在技术层面上描述了如何使用Quartz Composer创建层。

购买定制层

如果你不想自己钻研Quartz Composer，让我们为你做。我们有丰富的经验为mimoLive创建图层，包括数据可视化，如股票图表，你可以利用它来为你创建合适的图层。请 联系销售部门 详情请见下文。

创建一个自定义图层--开始

大师级的编码层为mimoLive

预审

在你开始为mimoLive开发图层之前有一些先决条件：

• 你需要有一个有效的mimoLive许可证来测试并在mimoLive中运行你的层。
• 你需要安装苹果公司的Quartz Composer应用程序。这是一个免费的开发工具，你可以在苹果的开发者网站上下载。但你需要先注册为Mac开发者（http://developer.apple.com）。在这里你可以找到 石英作曲家的用户指南 由苹果公司提供。
• Lua补丁 - 从mimoLive 1.9开始，你需要Lua补丁来在Quartz Composer中打开mimoLive Layers。它是开源的，可以从GitHub获得。我们用这个补丁来替代QuartzComposer的JavaScript补丁，因为它在mimoLive中运行不稳定。(从这里下载该补丁：[https://github.com/boinx/QCLua/releases )
• JSON 补丁 和 OAuth补丁 - 还有两个自定义补丁，目前只在Twitter层使用。在定制Twitter层时，你需要在开始编辑前下载并安装补丁。

空白层模板
你可以使用我们免费的石英合成文件作为你自定义层的起点。它包含一组基本的输入和输出，以及你需要在Quartz Composer的 "编辑信息 "对话框中改变的必要属性。

下载图层模板 v1.0

你好-世界 "的例子

作为第一个简单的例子，我们将创建一个基本的石英组合，并在mimoLive中使用它作为一个层。

1. 启动Quartz Composer应用程序
2. 选择 文件 ⇢ 新增空白 在菜单栏中。你会得到一个新的空的Quartz Composer文件。
3. 用左上角的按钮打开补丁库。一个小窗口会弹出，里面有所有Quartz Composer补丁的列表。
4. 在补丁库中找到名为Billboard的补丁。你可以通过在补丁库窗口底部的搜索栏中输入补丁名称的一些前导字母来快速找到它。这是一个渲染补丁。它在输出屏幕上绘制一个平面图像。
5. 从库中拖动补丁到你的空白编辑器窗口。补丁会粘在你拖动它的地方。你可以通过点击拖动它来移动它。请注意：该补丁有几个输入，在每个值的左边都有一个连接点标记。
6. 现在在补丁库中找到带字符串的图像补丁，把它拖到你的编辑器窗口。把它放在广告牌补丁的右边。字符串图像补丁是一个生成器补丁，它将生成一个包含你可以用输入值String指定的文本的图像。
7. 将Image with String patch的Image输出与Billboard patch的Image输入相连。
8. 如果Quartz Composer Viewer现在还不可见，点击右上角的Viewer按钮。你应该看到一个背景为棋盘的窗口，上面有白字的 "Hello World!"。
9. 回到 "编辑器 "窗口，右键点击 "带字符串的图像 "补丁，显示其上下文菜单。
10. 选择 插入输入分流器 ⇢字符串 该上下文菜单的。一个新的输入分割器补丁将出现在文档中，它的输出与 "带字符串的图像 "补丁的输入字符串相连。
11. 再次右击这个新创建的输入分流器，并选择 发布输入 ⇢ 输入.弹出一个文本框，要求为这个已发布的输入法命名。把它改成 My Text。请注意，这个发布的输入对mimoLive是可见的，当在mimoLive中选择图层时，将呈现在左边的参数视图中。
12. 通过选择打开 "成分信息表 "来打开 编辑 ⇢ 编辑信息....你将得到一个带有键值对列表的工作表。
13. 点击左下角的 "+"按钮，添加一个新的钥匙。列表中会出现一个新行，要求输入钥匙名称。
14. 输入tv_LayerProtocolVersion作为 财产，切换到 级别 选项从''字符串''改为''数字''，并将''1''放入 价值 列。
15. 点击 已完成 左下角的按钮来关闭工作表。
16. 将此组合保存在你的桌面上，名称为Hello World.qtz
17. 启动mimoLive，先不要创建文档。
18. 选择 文件 ⇢ 导入图层组合... 从菜单栏中选择。你会被一个文件选择器的对话框提示。请选择先前保存在桌面上的Hello World.qtz文件。
19. 现在创建一个新的mimoLive文档 文件 ⇢ 新的....mimoLive 模板选择器会显示出来。
20. 选择空白模板并点击右下角的选择按钮。一个新的mimoLive文档窗口会出现，包含一个单一的Placer图层，呈现出你坐在电脑前的样子。
21. 通过点击图层栏右上角的 "+"按钮打开图层库。
22. 找到你刚刚导入的Hello World图层，拖动一个实例到文档中间的图层堆栈的顶部。
23. 找到你自己定义的名为 "我的文本 "的输入，改变输入字段的文本。
24. 点击该层的实时按钮后，你的文字将出现在视频上。

祝贺你!你刚刚创建了一个新的 mimoLive 图层!在下面的章节中，我们要深入了解成为一个好的mimoLive公民所需的细节。

请注意，我们无法在本文档中解释如何使用Quartz Composer Editor的所有细节。如果你想了解更多关于Quartz Composer的信息，请阅读苹果开发者网站上的《Quartz Composer用户指南》。

在mimoLive处理图层

从mimoLive导出一个图层

如果想改变一个内置的mimoLive层，你可以通过以下步骤在mimoLive中导出该层：

• 用图层栏右上角的 "+"按钮打开图层资源库。
• 找到并选择你想用作新图层基础的图层。
• 通过右键点击该层，打开上下文菜单。
• 选择 出口层构成... 在该上下文菜单中。
• 你会被要求输入一个文件名，并设置一个保存图层的位置。

在mimoLive中导入一个图层

一旦你完成编辑或创建你的自定义图层，你必须将你的图层导入mimoLive。有几种方法可以把图层导入到mimoLive：

使用文件菜单导入一个图层

• 选择文件⇢导入图层组合....
• 你会被一个文件选择器对话框所提示。
• 请选择你的QuartzComposition文件并点击 "导入"。

使用文件名扩展名".tvlayer "导入一个图层

当发送自定义图层给其他不熟悉手动导入自定义图层的mimoLive用户（比如你的客户）时，这种技术很有用。不过在开发的时候不是很方便，因为QuartzComposer在改变文件的扩展名时不会打开文件。

• 在Finder中找到你的构图。
• 点击一次文件名来改变文件的名称。文件名周围有一个方框，表示你要改变它。
• 在最后添加扩展名.tvlayer，然后点击回车。查找器会问你是否真的要改变扩展名。请接受。
• 双击组合文件。现在mimoLive会自动打开并导入文件作为新层。它将在成功后通知你一个警报。

自定义层 API

mimoLive期望Quartz Compositions能采用 自定义层 API.在本节中，你将学习最小的实现。

最低限度的实施

层协议的最小实现只涉及Quartz Composition Properties，可以在Quartz Composer编辑器中通过选择以下内容进行编辑 编辑⇢编辑信息（⌥⌘I）。.

了解这些值如何被mimoLive使用是很重要的，这样mimoLive才能处理层的版本冲突。

• tv_LayerProtocolVersion：当我们改变层协议时，我们要增加层协议版本。有了这个，旧的mimoLive版本能够告诉用户，如果一个层被使用（例如存储在mimoLive文档中），它有一个较新的协议版本，因此可能不会被mimoLive正确对待。
• tv_LayerIdentifier：这个值应该是你每个层的唯一值。我们的图层的前缀是com.boinx.layer.*。请使用你自己的方案，以便在世界各地有唯一的标识符。请注意，mimoLive不使用文件名来比较图层!
• tv_LayerVersion：如果mimoLive发现存储在文档中的图层和安装在图层存储库中的图层的版本不同，它会使用以下规则来决定怎么做：
  - 如果文档层的版本比存储库的版本多：保留文档的版本
  - 如果文档层的版本小于版本库，但主要数字相同（如2.4对2.6），那么就用新的文档层替换。
  如果图层的版本主要数字不同，那么mimoLive会把图层当作不兼容的替代物，不会更新文档图层!

共同财产的增加

• 版权：
• 描述：
• 名称：
• tv_Tagline：