查看“Light Stream Player 设置”的源代码

[[ru:Параметры Light Stream Player]] [[en:Light Stream Player Settings]] [[zh:Light Stream Player 设置]]
'''Light Stream Player'''是一种能够独立在物体上播放已制作好的动画的设备:不需要电脑,也不需要运行程序。为了让程序知道应把项目设置发送到哪里、哪些转换器(Converter)归属哪个设备,需要把播放器作为设备添加到项目中——添加到'''固定装置(Fixtures)'''窗口。

本文介绍的是程序本身中播放器的设置。如何将动画加载到播放器,以及数据传输窗口的作用,请参见文章[[将Cue文件导入Player]]。

== 播放器在项目结构中的位置 ==

'''固定装置(Fixtures)'''窗口按层级组织:'''播放器(Player)''' → '''转换器(Converter)''' → '''端口(Port)''' → '''固定装置(Fixture)'''。播放器是最顶层,其余的一切都位于其内部。新建项目中已自带一个播放器——'''Light Stream Player V2''',无需另行添加。

播放器的设置决定了:

* '''程序把设置发送到哪里'''——宇宙(universe)、设备、播放列表和日历事件都会发送到播放器设置中指定的地址,并使用其中指定的访问数据;
* '''cue文件如何分布'''——合成会按照播放器的宇宙进行计算,如果项目中有多个播放器,导出时文件会按播放器名称分放到相应的子文件夹中;
* '''占用多少个宇宙'''——播放器所有转换器(包括内置转换器,如果已启用)的宇宙数都会计入程序许可证的宇宙数。

== 添加、重命名和删除 ==

# 在'''固定装置(Fixtures)'''窗口中,点击'''添加设备(Add Device)'''按钮——它是窗口底部面板上的第一个按钮。
# 在打开的菜单中选择'''Light Stream''',然后在其子菜单中选择'''Player'''或'''Player V2''',具体取决于物体上安装的是哪种设备。

播放器会以展开状态出现在列表中并处于选中状态,其设置会显示在'''属性(Properties)'''窗口中。程序会自动为新播放器命名——''Light Stream Player''或''Light Stream Player V2'';如果已存在同名播放器,程序会在名称后添加编号,以避免重名。

'''Player'''和'''Player V2'''的设置项相同。唯一的区别在于内置转换器:'''Player V2'''默认设置了四个端口,'''Player'''则只有一个。两者的内置转换器都不支持超过四个端口。

重命名播放器有两种方式:右键点击它→'''重命名(Rename)''',或在'''属性(Properties)'''窗口中修改'''名称(Name)'''字段。删除播放器则通过右键点击→'''删除(Delete)'''——播放器被删除的同时,其转换器也会一并从项目中移除,而这些转换器端口中的固定装置会返回到下方未分配的固定装置列表中。误删可以用''Ctrl+Z''撤销。

== 在哪里查找设置 ==

在'''固定装置(Fixtures)'''窗口中点击播放器——'''属性(Properties)'''窗口中会出现三个部分:'''常规(General)'''、'''授权(Authorization)'''和'''内置转换器(Internal Converter)'''。设置值会立即生效,窗口中没有'''确定(OK)'''按钮。

== 常规 ==

{| class="wikitable"
! 参数 !! 作用
|-
| '''名称(Name)''' || 播放器在项目中的名称。它会显示在'''固定装置(Fixtures)'''窗口和数据传输窗口的播放器列表中;如果有多个播放器,导出时该名称会成为存放cue文件的子文件夹名称。播放器名称不能重复
|-
| '''IP地址(IP Address)''' || 播放器的网络地址。默认值为''192.168.0.205''。程序在交换设置时通过该地址访问播放器;地址本身是在播放器上设置的,程序不会更改它。该地址也会显示在'''固定装置(Fixtures)'''窗口播放器所在行、名称的右侧
|-
| '''启用HTTPS(Enable HTTPS)''' || 通过加密协议与播放器通信。启用后,程序会从'''HTTP端口(HTTP Port)'''切换到'''HTTPS端口(HTTPS Port)'''
|-
| '''HTTP端口(HTTP Port)''' || '''HTTPS'''关闭时,程序用于与播放器通信的端口。默认值为80
|-
| '''HTTPS端口(HTTPS Port)''' || 启用'''HTTPS'''时,程序用于与播放器通信的端口。默认值为443
|}

端口通常很少需要更改:只有在播放器被特意改用非标准端口,或需要通过路由器端口转发访问播放器时才需要修改。

== 授权 ==

{| class="wikitable"
! 参数 !! 作用
|-
| '''用户名(Username)''' || 登录播放器所用的用户名。出厂值为''administrator''
|-
| '''密码(Password)''' || 登录播放器所用的密码。出厂值为''administrator''。字段右侧的按钮可以显示或再次隐藏已输入的字符
|-
| '''导入/导出设置(Import / Export Settings)''' || 该按钮会打开'''向LS Player传输数据(Data Transfer to LS Player)'''窗口——通过它可以将项目设置发送到播放器,也可以将已运行的播放器上的设置读取到项目中
|}

访问数据与地址、端口一起保存在项目中,因此在'''向LS Player传输数据'''窗口中它们已经自动填好。这些是同一份数据:如果直接在数据传输窗口中修改用户名、密码、地址或端口,该修改也会同步到播放器的设置中。

== 内置转换器 ==

播放器自带用于固定装置的输出接口,在项目中它们以播放器内部一个名为'''内置转换器(Internal Converter)'''的独立转换器形式显示。

{| class="wikitable"
! 参数 !! 作用
|-
| '''使用内置转换器(Use Internal Converter)''' || 启用播放器的内置输出。勾选此复选框时,'''内置转换器'''会显示在'''固定装置(Fixtures)'''窗口中,可以将固定装置分配到它的端口,其宇宙也会与其他转换器同等计入——无论是重复宇宙编号的检查,还是程序许可证的宇宙数统计,都会被计算在内。如果不使用内置输出,请取消勾选:转换器会从列表中消失,不再占用宇宙
|}

内置转换器有几个特点:

* 无法删除它——只能通过'''使用内置转换器'''复选框将其隐藏;
* 它没有独立的IP地址:始终与播放器地址一致,并随播放器地址一同变化;
* 其余设置在'''属性(Properties)'''窗口中配置:选中该转换器,设置'''名称(Name)'''、'''起始宇宙(Start Universe)'''和'''端口数量(Number of Ports)'''。端口数不能超过四个——这是播放器内置输出的数量上限;
* 内置转换器的每个端口对应且仅对应一个宇宙。普通转换器所具有的'''每端口宇宙数(Universes per Port)'''参数,内置转换器没有。

== “固定装置”窗口中的播放器行 ==

播放器行无需打开属性即可显示关键信息:

* 左侧的箭头用于折叠和展开播放器的内容;
* 接下来是图标和加粗显示的播放器'''名称(Name)''';
* 右侧是'''IP地址(IP Address)''';
* 名称和地址之间可能会出现橙色警告图标。

== 橙色图标:设置已更改 ==

程序会自动跟踪一切影响播放器的操作。一旦你添加或删除转换器、重命名它、更改它的网络设置、起始宇宙、端口数量或每端口宇宙数,播放器名称旁边就会亮起一个橙色图标,并显示提示''“注意!点击查看详情”''。它只表示一件事:项目中的设置与播放器上当前的设置已经不一致。

点击该图标会打开'''注意!(Attention!)'''窗口,提出问题''“部分设置已更改。是否打开播放器属性以发送这些设置?”'',并提供三个按钮:

* '''是(Yes)'''——程序会选中该播放器并打开其设置,随后可通过'''导入/导出设置(Import / Export Settings)'''按钮将设置发送到播放器;
* '''否(No)'''——窗口关闭,图标继续亮着;
* '''清除(Clear)'''——图标被清除。此操作不会将设置发送到播放器,因此只有在你确实不打算发送设置时才使用此按钮。

该图标只是一个提醒,不是错误:它不会影响程序的运行或映射(mapping)。

== 播放器内部的转换器 ==

项目中的每个转换器都归属于某个播放器,这决定了它的设置会发送到哪个播放器。

* 新转换器会添加到当前选中的播放器中;如果没有选中任何播放器,则添加到列表中的第一个播放器。
* 可以用鼠标将转换器拖动到目标播放器所在行,从而把它转移到另一个播放器。
* 同一播放器内的宇宙编号不能重复——重复的宇宙会被标记为错误。不同播放器之间的宇宙可以相同:它们是物理上独立的设备。

转换器自身的网络设置见文章[[Light Stream Converter 参数]],物理设备的配置见文章[[Настройка Light Stream Converter]]。

== 项目中有多个播放器 ==

项目中播放器的数量可以与物体上实际安装的数量相同。这种情况下:

* 注意命名:cue文件子文件夹的分布方式和数据传输窗口中区分播放器都是依据名称;
* 为每个播放器设置各自独立的'''IP地址(IP Address)'''和访问数据;
* 按照播放器在物体上的实际连接方式分配转换器;
* 分别向每个播放器发送设置和动画。

== 出现问题时 ==

'''程序无法连接到播放器。''' 检查设置中的'''IP地址(IP Address)''',以及电脑和播放器是否处于同一子网。最简单的检测方法是在浏览器中打开播放器的地址:如果无法打开网页界面,说明问题出在网络上,而不是设置上。

'''数据传输窗口中出现“登录失败”。''' '''用户名(Username)'''、'''密码(Password)'''、地址或端口不匹配。请检查'''授权(Authorization)'''部分,同时留意'''启用HTTPS(Enable HTTPS)'''复选框——启用后程序会使用另一个端口。

'''动画已加载,但固定装置不亮。''' 宇宙和设备设置尚未发送到播放器,或者发送后又发生了更改——橙色图标通常就是在提示这种情况。请通过'''导入/导出设置(Import / Export Settings)'''按钮重新发送设置。

'''宇宙数超过了播放器许可证的限制。''' 在向播放器发送宇宙和设备时,可能会出现类似''“项目中的宇宙数量(…)超过了播放器许可证中的宇宙数量(…)”''的提示。此处计算的是该播放器普通转换器的宇宙数;内置转换器不参与此项检查,因此取消勾选'''使用内置转换器(Use Internal Converter)'''在这里没有作用。请移除多余的转换器或宇宙,或者升级播放器的许可证。

'''映射(mapping)上出现了程序许可证超限的提示。''' 这是另一项检查:它会计算该播放器所有转换器的宇宙数,包括内置转换器(如果'''使用内置转换器(Use Internal Converter)'''复选框已勾选)。如果未使用播放器的内置输出,请取消勾选该复选框——占用的宇宙数就会减少。

'''转换器出现重复宇宙。''' 该检查是在同一播放器范围内进行的,内置转换器也参与检查。请检查该播放器所有转换器(包括'''内置转换器(Internal Converter)''')的'''起始宇宙(Start Universe)'''。

== 另请参阅 ==

* [[将Cue文件导入Player]]
* [[导出合成]]
* [[属性]]
* [[固定装置的地址分配]]
* [[Light Stream Converter 参数]]
* [[Настройка Light Stream Converter]]
* [[术语]]