LibArtNet

自由藝術網

LibArtNet 是 Art-Net 4 協議的 Java 實現，由 Artistic License Ltd 維護。

請記住，LibArtNet 仍處於測試階段。

不過，請參閱功能清單、路線圖以及如何貢獻以獲取更多資訊。如果您覺得其中缺少未列出的內容，請隨時提出問題。

特徵

• 基本 Art-Net 接收器
• 基本 Art-Net 發送器

支援的 Art-Net 資料包

• 藝術DMX
  • 序號
  • 15位元全局尋址
• 藝術民意調查
  • 單播
  • 發送ArtPollReply狀態更改
  • 診斷數據的優先級
• 藝術投票回复
  • 宏
  • 遙控器
  • OEM 代碼（所有內建 OEM 代碼）
  • 短/長名稱
  • 裝備款式
  • 更多
• 藝術時間代碼
  • 24/25/29.97/30 幀/秒

路線圖

計劃的功能是

• Art-Net 控制器，一個抽象層，使用現有的接收器和發送器充當控制台
• Art-Net節點，一個抽象層，使用現有的接收器和發送器作為節點
• RDM 支持

用法

所有類別均使用 Javadoc 進行記錄。但是，如果有遺漏或不清楚的地方，請隨時提出問題。

要求

• Java 1.8 或更高版本
• Gradle 如果你想從原始碼編譯

安裝

LibArtNet 可在 Maven Central 和發布頁面上找到。

梅文

將此依賴項新增至pom.xml ：

< dependency >
  < groupId >de.deltaeight</ groupId >
  < artifactId >LibArtNet</ artifactId >
  < version >1.1.2-beta</ version >
</ dependency >

搖籃

將其新增至build.gradle ：

dependencies {
    implementation ' de.deltaeight:LibArtNet:1.1.2-beta '
}

從原始碼編譯

若要建置在 IDE 中使用的.jar文件，請執行

./gradlew :lib:jar 

使用範例

使用接收器

接收方需要接收處理程序，這些處理程序在收到適當的資料包時被呼叫：

 ArtNetReceiver receiver = new ArtNetReceiver ()
    . withArtDmxReceiveHandler ( packet -> System . out . println ( "Channel 63 value: " + packet . getData ()[ 62 ]));

receiver . start ();

// Do other stuff

receiver . stop ();

使用發送器

發送方需要發送 Art-Net 封包，因此我們首先需要一個用於所需資料包的建構器實例：

 ArtPollReplyBuilder builder = new ArtPollReplyBuilder ()
        // report as Robert Juliat Dalis Reference : 860
        . withProduct ( OemCode . getProductByOemCode ( "OemRobertJulDalis1" ))
        . withBindIp ( new byte []{ 127 , 0 , 0 , 1 });

ArtNetSender sender = new ArtNetSender ();
sender . start ();

sender . send ( InetAddress . getByName ( "127.0.0.1" ), builder . build ());

// Do other stuff

sender . stop ();

貢獻

我們非常歡迎您的貢獻！

如果您願意做出貢獻，我們非常感謝您的每一次幫助。請隨意分叉、建立拉取請求並針對錯誤或功能請求提出問題。

對於錯誤報告、功能請求和拉取請求，您只需填寫一些範本即可向我們提供所需的資訊。

貢獻前請先閱讀貢獻指引和行為準則。

執照

LibArtNet 根據 MIT 許可證獲得許可。有關詳細信息，請參閱 LICENSE.md。