Light Stream Converter 參數

出自Light Stream (CN)
於 2026年9月3日 (四) 16:04 由 LumiBot留言 | 貢獻 所做的修訂 (Перевод с русской вики (задача №1100, LS Dev Hub))
(差異) ←上個修訂 | 最新修訂 (差異) | 下個修訂→ (差異)

Converter(轉換器)是一種設備,它從計算機接收網絡信號,並通過自己的埠(Port)將信號分發給實際燈具,即固定裝置(Fixtures)。在 Light Stream 項目中,Converter 描述的是數據發往何處以及如何發送:發送到網絡中的哪個地址、使用哪種協議、設備有多少個埠,以及每個埠分配了哪些數據宇宙(Universe)。

本文介紹的是 Converter 在 Light Stream 內部的參數。配置物理設備本身(其自身的 IP 地址、埠模式、晶片類型)是在另一個窗口中完成的,詳見文章 Настройка Light Stream Converter

Fixtures 窗口中的 Converter

項目中的所有設備都位於Fixtures(固定裝置)窗口的上半部分。結構始終一致:Light Stream Player → Converter → Converter 的 Port → Port 中的固定裝置。同一窗口的下半部分是尚未分配到任何位置(unpatched)的固定裝置列表。

Converter 一行從左到右依次是:

  • 箭頭(Arrow) 用於展開和摺疊 Port 列表。
  • Converter 圖標 —— 點擊它會向設備發送一條識別(identify)指令:真實的 Converter 會閃爍指示燈幾秒鐘。這樣便於在配電箱裡找到對應的設備。指令會發送到參數中設置的地址。
  • 圖標旁的指示燈(Indicator)顯示發送狀態:數據正在發往 Converter 時閃爍,停止發送時熄滅。
  • Converter 的名稱(Name)。雙擊或通過右鍵 → Rename 修改。
  • 數據發往的IP 地址(IP Address)。點擊它會同時選中該 Converter 的所有固定裝置——需要在映射(mapping)上快速找到它們時很方便。
  • 右側的複選框(Checkbox) —— Converter 的可見性(Visibility)。

右鍵點擊 Converter 可以使用 RenameDeleteDuplicateUnpatch All

如果 Converter 帶有鎖形圖標,說明它是內部 Converter(Internal Converter) —— 即 Player 自帶的內置 Universe。它不能被刪除,參數也更少,見下文相關章節。

Converter 或 Port 的名稱如果顯示為紅色,說明存在地址分配錯誤。原因有三種:該 Port 的固定裝置裝不進分配給它的 Universe;Port 內固定裝置的通道(Channel)彼此重疊;或者該 Port 的 Universe 與同一 Player 上另一個 Converter 的 Universe 重複了。

向項目添加 Converter

  1. 打開 Fixtures 窗口。
  2. 點擊 Add Device 按鈕(窗口下方面板上的加號)。
  3. 選擇 Light Stream 及所需型號 —— Converter 2Converter 6Converter 8 LITE。名稱中的數字即物理設備的埠數量。
  4. 對於其他廠商的設備,選擇 Art-Net Converter 並指定埠數量:1、2、3、4、5、6、8 或 16。如果需要其他數量,之後可以通過 Port Count 參數設置。

新的 Converter 會被添加到窗口中當前選中的 Player(如果沒有選中任何內容,則添加到第一個 Player),並立即獲得一個唯一名稱、比該 Player 上最後一個 Converter 高一位的 IP 地址(如果該 Player 還沒有 Converter,則比 Player 本身的 IP 高一位),以及緊接在上一個 Converter 的 Universe 之後開始的 Universe。因此,依次添加多個 Converter 時不會出現 Universe 重疊,後續通常只需修改一個欄位——IP 地址。

Light Stream 的 Converter 創建時每個 Port 占用兩個 Universe,Art-Net Converter 則占用一個。如有需要,可以通過 Universes per Port 參數修改。

第二種方法是在網絡中查找已經配置好的設備,連同其真實的網絡設置一起添加。這在文章 Настройка Light Stream Converter 中有詳細說明。

Duplicate 命令會連同全部設置以及已分配到該 Converter 中的固定裝置副本一起複製出一個新的 Converter。副本會獲得自己的名稱、下一個 IP 地址以及下一段空閒 Universe。這是在同一場地描述多台相同設備最快的方法。

在哪裡查看參數

Fixtures 窗口中選中一個 Converter —— 它的參數會出現在 Properties(屬性) 窗口中。這裡沒有 OKApply 按鈕:數值會立即生效,數據發送在需要時會自動重啟。Properties 窗口的總體結構見文章 Properties

參數分為兩個部分:General(基本)Universe Settings(宇宙設置)

"General" 部分

參數 作用
Name Converter 在項目中的名稱。同一個 Player 上各 Converter 的名稱必須互不相同——重名會影響向 Player 導出設置。如果輸入的名稱已被占用,程序會自動為其添加編號。名稱中不接受以下字符:/ ? # [ ] @ ! $ & ' ( ) * + , ; " < > % { } ^ `
Protocol ArtNetsACN —— 數據通過哪種協議發送。應根據物理設備所支持的協議來選擇
Controller Type DMXSPI。決定該 Port 中固定裝置在各 Universe 間的排布方式,見下文相關章節
Broadcast(廣播) 數據會同時發送給網絡上的所有設備,此時不使用 IP Address 欄位
Multicast(組播) 名稱不同的同一種發送模式。BroadcastMulticast 兩個複選框控制的是同一項設置,且會同步啟用:使用 ArtNet 協議時表現為廣播發送,使用 sACN 時表現為組播
IP Address 數據發往的設備地址,必須與 Converter 本身設置的地址一致。僅在關閉廣播時使用
Port(埠) 用於發送數據的網絡埠,默認值為 6454 —— 標準的 Art-Net 埠。只有在特殊情況下才需要修改。使用 sACN 協議時該欄位不生效,因為該協議使用自己的標準埠
Use Custom Network Interface 默認情況下,所有 Converter 都通過項目共用的網絡適配器發送數據。勾選此項可讓該 Converter 使用自己獨立的網絡適配器
Network Adapter(網絡適配器) 為該 Converter 單獨選擇網絡適配器。僅在啟用了自定義網絡接口時生效

項目共用的網絡適配器以及共用的 Enable Art-Net 按鈕位於程序設置的 Network(網絡) 部分(見 Settings)。不需要單獨啟用每個 Converter:它們都由同一個按鈕統一啟動和停止。

"Universe Settings" 部分

參數 作用
Start Universe(起始宇宙) 第一個 Port 的 Universe 編號。其餘 Port 的 Universe 從該編號起依次排列
Port Count(埠數量) 該 Converter 在項目中擁有的 Port 數量。請設置為設備實際擁有的數量
Universes per Port(每埠宇宙數) 一個 Port 占用的 Universe 數量。數值越大,一個 Port 能容納的固定裝置就越多。其上限由程序設置中 Network 部分的 Max Universes per Port 決定(默認值為 4)
Send Empty Ports(發送空埠) 即使某個 Port 中沒有任何固定裝置,也會發送數據。未勾選該項時,空 Port 不發送任何數據,也不會占用導出的合成文件的空間

以下兩項設置會改變已經搭建好的項目的地址分配,因此修改時需要格外謹慎:

  • Start Universe 會將該 Converter 所有固定裝置的 Universe 整體平移相同的量。當需要在整體地址方案中移動一整台設備時很有用,但平移之後固定裝置會落入不同的 Universe。
  • 減小 Port Count 會連同相應的地址分配一起刪除多餘的 Port:被刪除 Port 中的固定裝置會退回到 Fixtures 窗口下方的列表中,變為未分配狀態。固定裝置本身及其在映射(mapping)上的位置不會因此丟失。

Port 的 Universe 如何計算

Port 的 Universe 編號不是手動設置的,而是按以下公式計算:

Port 的 Universe = Start Universe + (Port 編號 − 1) × Universes per Port

例如,一個 Start Universe 為 1、每個 Port 占用一個 Universe 的 Converter:Port 1 —— Universe 1,Port 2 —— Universe 2,Port 3 —— Universe 3。如果設置每個 Port 占用兩個 Universe,則 Port 1 占用 Universe 1 和 2,Port 2 占用 3 和 4,Port 3 占用 5 和 6。

已占用的 Universe 會直接標註在 Fixtures 窗口中對應 Port 那一行上:只有一個 Universe 時顯示為 U1,多個時顯示為 U1 U2U3 U4 等——每個 Universe 對應一個標籤。想確認自己實際占用了哪些 Universe,最簡單的方法就是在那裡查看——尤其是剛修改完 Start UniverseUniverses per Port 之後。

項目中的 Universe 數量受加密狗(license dongle)限制。如果 Universe 總數超過了加密狗允許的數量,程序會直接在映射(mapping)區域提示,並且不會發送 DMX 數據。

Controller Type:DMX 還是 SPI

該參數回答的是一個問題:對於裝不進某個 Universe 剩餘空間的固定裝置,該如何處理。

  • DMX —— 通道(Channel)以連續的數據流方式排列。在某個 Universe 末尾開始的固定裝置,會在下一個 Universe 的開頭繼續。普通的 DMX 線路就是這樣工作的。
  • SPI —— 固定裝置整體被移到下一個 Universe,上一個 Universe 剩餘的部分則不再使用。像素線路(pixel line)就是這樣工作的:單個像素不能被拆分到兩個 Universe 之間。

該值應在給固定裝置分配地址(patching)之前設置好:更改類型會重新計算該 Converter 所有固定裝置的地址。如果物理設備的埠已切換為 SPI 模式,那麼項目中對應的 Converter 也必須設置為 SPI —— 否則場地上的畫面會在 Universe 邊界處出現錯位。

可見性與數據發送

Fixtures 窗口中 Converter 右側的複選框就是它的可見性(Visibility)。禁用某個 Converter 後,它所有 Port 輸出的都是零值:場地上的固定裝置會熄滅,但它們不會從項目中消失,地址也會保留。當需要臨時關閉場地的一部分而不想拆掉已有的地址分配時,這非常方便。

可見性是按鏈條依次生效的,鏈條中任意一環被關閉都會導致數據歸零:

  1. 固定裝置本身的可見性;
  2. Port 的可見性(Port 旁邊的複選框);
  3. Converter 的可見性;
  4. 全局的 Enable Art-Net 按鈕。

如果程序中的動畫正在運行,但燈具沒有反應,應該按照這個順序依次排查,然後再檢查網絡參數:IP AddressBroadcast 以及 Network Adapter

Player 的內部 Converter

內部 Converter(Internal Converter)Light Stream Player 自帶的內置 Universe。當 Player 屬性中啟用了 Use Internal Converter 參數時,它就會出現在列表中,並帶有鎖形圖標標記。

它與普通 Converter 的區別在於:

  • 不能被刪除或複製——右鍵菜單中只保留 Rename 一項;
  • 沒有網絡參數:數據通過 Art-Net 發往 Player 自身的 IP 地址,且該地址不可編輯;
  • Properties 窗口中只能配置 NameStart UniversePort Count;它的每個 Port 始終只占用一個 Universe,並以 DMX 模式工作;
  • 它的 Port 數量不能超過四個。對於 Player,內部 Converter 創建時只有一個 Port;對於 Player V2,創建時就直接有四個。

內部 Converter 的 Universe 與其他 Converter 一樣參與統一編號,同樣不能與其他 Converter 的 Universe 重疊。

修改參數之後

Converter 的網絡設置和 Universe 是發送到 Light Stream Player 的那部分設置的一部分。一旦修改了其中任何內容,Fixtures 窗口中 Player 名稱旁就會出現橙色警告圖標。點擊該圖標會提示打開 Player 的屬性並重新發送設置。

在設置被重新發送之前,Player 上保留的仍是舊的 Universe 方案,離線播放(standalone playback)時使用的地址也會是錯誤的。

遇到問題怎麼辦

Port 或 Converter 顯示為紅色。 說明該 Port 分配到的 Universe 不夠用:固定裝置的最後一個地址超出了範圍。可以增大 Universes per Port,或者把部分固定裝置移到相鄰的 Port。Port 內通道相互重疊的固定裝置同樣會顯示為紅色——此時可以使用 Port 右鍵菜單中的 Recalculate Fixture Addresses 命令來解決。

Universe 發生衝突。 同一個 Player 上的兩個 Converter 占用了相同的 Universe 編號,兩者都會顯示為紅色。將其中一個的 Start Universe 平移,使兩者的範圍不再重疊;注意一個 Converter 會連續占用 Port Count × Universes per Port 個 Universe。

名稱自動發生了變化。 說明該名稱已被另一個 Converter 占用——程序自動為其添加了編號,以保證名稱互不相同。

沒有信號。 依次檢查整條可見性鏈條,然後檢查 Converter 的 IP Address(必須與真實設備的地址一致)、Broadcast 的狀態以及所選的網絡適配器。點擊 Converter 圖標可以幫助確認程序確實連接到了正確的設備——設備的指示燈會閃爍。

場地畫面在 Universe 交界處出現錯位。 很可能是 Controller Type 設置不匹配:像素線路(pixel line)需要使用 SPI 模式。

固定裝置從 Port 中消失了。 請檢查是否減小過 Port Count —— 被刪除 Port 中的固定裝置會退回到 Fixtures 窗口下方的列表中。

參見