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。