查看“将Cue文件导入Player”的源代码

[[ru:Импорт cue в Player]] [[en:Importing Cue Files into Player]] [[zh:将Cue文件导入Player]]
导出合成（Exporting Compositions）会生成一组<code>*.cue</code>文件——这些就是现成的动画。只要它们还存放在电脑的文件夹里，物体就不受它们控制：需要把这些文件上传到'''Light Stream Player'''，之后它才能自行播放这些动画，无需开机的电脑，也无需运行程序。

cue文件不是从Light Stream中上传的，而是通过播放器（Player）的网页界面，在普通浏览器中完成的。程序本身只向播放器发送设置：宇宙（universe）和设备、播放列表以及日历事件。

== 上传前需要做的准备 ==

* 已将合成导出为<code>*.cue</code>文件——参见[[导出合成]]。无需单独准备预览：每个文件内部已经录制了GIF动画。
* 播放器已开机、已连接到网络，并已上传许可证（license）。
* 电脑与播放器处于同一网络中，并且其IP地址已知。程序中新添加的'''Light Stream Player'''默认填入的地址是''192.168.0.205''，但实际地址以播放器本身设置的为准——请与其核对。
* 播放器的用户名和密码已知。出厂访问信息为：''administrator'' / ''administrator''。

== 将动画上传到Player ==

# 打开浏览器，在地址栏中输入播放器的IP地址。将加载登录页面。
# 如果界面打开时不是所需语言，点击地球图标并选择'''中文'''。
# 输入用户名和密码。
# 在左侧菜单中选择'''Animations'''（动画）。播放器打开后可能会直接停留在'''Schedule'''（计划）板块——这种情况下只需切换到'''Animations'''。
# 点击左上角的'''Upload Animations'''（上传动画）。将打开文件选择窗口。
# 点击回形针图标，找到导出合成时所用的文件夹，选择所需的<code>*.cue</code>文件。可以一次选择多个文件——它们的列表会显示在'''Upload Animations'''窗口中。
# 点击'''Upload'''（上传）并等待上传完成。

上传完成后，窗口会自动关闭，动画会出现在'''Animations'''板块中——每个都有各自的名称和一个简短的GIF预览，正是导出时录制的那个。

要确认项目设置是否也已传到播放器，可在'''Settings'''（设置）→'''Universes and Converters'''（宇宙和转换器）板块查看：那里应列出项目中的宇宙和转换器。

== 如果有多台播放器 ==

当项目中有不止一台'''Light Stream Player'''时，导出会将cue文件分别放入以各播放器命名的子文件夹中。上传到每台播放器时，只使用其对应子文件夹中的文件：动画是针对特定播放器的宇宙计算的，放到另一台播放器上固定装置（fixture）会工作不正常。

== 文件名很重要 ==

程序通过名称将项目中的合成与播放器上的动画关联起来：它会在播放器上查找名称与合成名称一致的文件（大小写不影响匹配）。只要名称一致，就可以向播放器发送播放列表和日程安排——程序能识别哪个动画对应哪个合成。

由此得出几条简单规则：

* 导出后不要重命名cue文件——重命名后的文件程序将在播放器上找不到；
* 如果在'''Export'''（导出）窗口中修改了'''File Name'''（文件名）列的值，使其不再与合成名称一致，则无法向播放器发送播放列表和日历事件；
* 如果在项目中重命名了合成，请重新导出并以新名称上传到播放器，同时删除播放器上的旧文件，否则动画列表中会出现两个相似的片段。

== 向播放器传输数据的顺序 ==

上传动画只是三个步骤之一，这里的顺序很重要：

# '''宇宙和设备（Universes and Devices）。'''从程序中发送：打开'''Fixtures'''（固定装置）窗口→选中'''Light Stream Player'''→在'''Properties'''（属性）窗口的'''Authorization'''（授权）组中点击'''Import / Export Settings'''（导入/导出设置）。将打开'''Transfer Data to LS Player'''（向LS Player传输数据）窗口，在其中勾选'''Universes and Devices'''并点击'''Export'''（导出）。
# '''动画（Animations）。'''如上文所述，通过播放器的网页界面上传。
# '''播放列表和日历事件（Playlists and Calendar Events）。'''在同一个'''Transfer Data to LS Player'''窗口中通过'''Playlists'''和'''Calendar Events'''复选框发送。只有在cue文件已经上传到播放器之后才能这样做——否则程序没有可与之匹配的合成。

'''Transfer Data to LS Player'''窗口的结构如下：

{| class="wikitable"
! 窗口区域 !! 设置内容
|-
| '''Select Player to Configure'''（选择要配置的Player） || 项目中播放器的列表（含地址）以及'''Universes and Devices'''、'''Playlists'''、'''Calendar Events'''复选框——决定传输哪些数据
|-
| '''Access Data'''（访问数据） || 播放器的'''Username'''（用户名）和'''Password'''（密码）。眼睛图标按钮可以以明文显示密码
|-
| '''Network Settings'''（网络设置） || 播放器的'''IP'''、'''HTTPS'''复选框、'''HTTP Port'''（默认80）和'''HTTPS Port'''（默认443）
|-
| 底部按钮 || '''Import'''（导入）——将数据从播放器取回项目中，'''Export'''（导出）——将数据从项目发送到播放器，'''Clear Player'''（清空播放器）——清除播放器上的全部内容
|}

按钮下方是进度条和状态栏：显示当前正在发生的操作——'''Authorization'''（授权）、'''Retrieving CUE'''（获取CUE）、'''Creating Playlist 2 of 5'''（正在创建播放列表2/5）等等。完成后会出现'''Settings Successfully Updated'''（设置已成功更新）的提示。

== 更新和删除动画 ==

* 修改了合成——请重新将其导出为cue并再次上传到播放器。
* 如果需要从播放器上移除多余的片段，请在播放器界面的'''Animations'''板块中删除它们。
* '''Transfer Data to LS Player'''窗口中的'''Clear Player'''按钮会立即清除播放器上的所有内容：动画、播放列表、日历事件、场景、设备和宇宙。程序一定会要求再次确认。当需要将播放器从零开始为新项目做准备时可以使用此功能——从程序中无法恢复已删除的内容，动画需要重新上传。

== 反向操作：已有动画但没有项目 ==

如果播放器上已经配置好了动画和日程安排，可以将它们导入到程序中。在'''Transfer Data to LS Player'''窗口中勾选'''Playlists'''和'''Calendar Events'''，然后点击'''Import'''。

请注意以下两点：

* 程序会警告，当前项目中的播放列表和事件将被播放器上的数据覆盖。如果项目中已经编排好了日程，请先将项目另存为其他名称。
* 程序会将播放器上的动画与项目中的合成进行比对。如果项目中缺少某些合成，将出现提示：''“在项目中未找到以下合成，它们将被自动创建，是否继续？”''并附带名称列表。选择'''是'''会将缺失的项目添加进来，播放列表和事件也会被完整导入。这类项目仅仅是来自播放器的动画名称，背后并没有现成的效果和时间线。

== 常见问题排查 ==

* '''浏览器中打不开播放器页面'''——请检查地址、连接线，以及电脑和播放器是否处于同一子网。
* '''“Transfer Data to LS Player”窗口中出现“Login Failed”（登录失败）'''——用户名、密码、地址或端口不匹配。请检查'''Access Data'''和'''Network Settings'''部分，包括'''HTTPS'''复选框。
* '''发送播放列表时出现“These compositions were not found on the player”（在播放器上未找到这些合成）'''——消息中会列出名称。这说明这些动画尚未上传到播放器，或者在播放器上使用了不同的名称存储。请上传缺失的cue文件后重新发送。
* '''播放器列表中有该动画，但固定装置不亮'''——很可能是宇宙和设备尚未发送到播放器，或者固定装置没有分配到转换器的端口上，参见[[固定装置的地址分配]]。
* '''出现许可证超限提示'''，形如''“项目中的宇宙数量（…）超过了播放器许可证允许的宇宙数量（…）”''——项目使用的宇宙数超过了播放器许可证允许的数量。请减少宇宙数量或扩展许可证。
* '''播放器上某个动画的预览是黑色的'''——GIF是从未对准物体的3D摄像机拍摄的。请在'''Export'''窗口中选择其他视图，然后重新导出该合成，参见[[Настройки GIF превью]]。

== 另请参阅 ==

* [[导出合成]]
* [[Настройки GIF превью]]
* [[合成]]
* [[固定装置的地址分配]]
* [[Терминология]]