项目简介
本项目是基于Android平台的开发包与示例应用,用于和仰邦五代/六代单双色控制器进行交互。开发者借助该项目,可轻松实现控制器的连接、状态获取、文本和时间区域的节目发送等功能,项目还提供详细SDK与使用示例,助力开发者快速上手。
项目的主要特性和功能
- SDK集成:提供仰邦五代和六代控制器的SDK,支持单双色控制器操作。
- 状态获取:能获取控制器状态信息,如屏幕宽度和高度等。
- 文本发送:支持向控制器发送文本区域,可设置字体颜色和对齐方式。
- 时间显示:能发送时间区域到控制器,以
hh:mm:ss
格式显示时间。 - 动态区域:支持发送动态区域,适用于六代控制器特定操作。
- 测试支持:提供单元测试和集成测试示例,确保代码正确性和稳定性。
安装使用步骤
假设用户已下载本项目的源码文件,按以下步骤操作:
步骤1:导入SDK
将所有库文件拷贝至libs
文件夹,并在build.gradle
文件中添加依赖:
```gradle
implementation files('libs/bx05-0.5.0-SNAPSHOT.jar')
implementation files('libs/bx05.message-0.5.0-SNAPSHOT.jar')
implementation files('libs/bx06-0.6.0-SNAPSHOT.jar')
implementation files('libs/bx06.message-0.6.0-SNAPSHOT.jar')
implementation files('libs/log4j-1.2.14.jar')
implementation files('libs/simple-xml-2.7.1.jar')
implementation files('libs/uia-comm-0.3.3.jar')
implementation files('libs/uia-utils-0.2.0.jar')
implementation files('libs/uia-message-0.6.0.jar')
implementation(name: 'java.awt4a-0.1-release', ext: 'aar')
在`project`的`build.gradle`中添加如下代码:
gradle
allprojects {
repositories {
google()
jcenter()
flatDir {
dirs 'libs'
}
}
} ```
步骤2:SDK初始化
在Application
的onCreate()
方法中初始化SDK:
```java
public class MyApp extends Application {
private static final String TAG="MyApp";
@Override
public void onCreate() {
super.onCreate();
try {
// java.awt for android 初始化
AwtEnv.link(this);
// 是否启动抗锯齿
AwtEnv.configPaintAntiAliasFlag(false);
// 初始化五代
Bx5GEnv.initial();
// 建立 BX6G API 運行環境。
Bx6GEnv.initial();
Log.d(TAG, "sdk 6 version:" + Bx6GEnv.VER_INFO);
}
catch (Exception ex) {
Log.d(TAG, "sdk init error");
}
}
} ```
步骤3:添加权限
在AndroidManifest.xml
中添加网络访问权限:
xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
步骤4:调用接口
在子线程中调用相关接口,例如获取控制器状态: ```java new Thread(new Runnable() { @Override public void run() { Bx5GScreenClient screen = new Bx5GScreenClient("screen"); try { // 连接控制器 screen.connect(ip.getText().toString(), 5005);
// 获取控制器状态
screen.ping();
// 断开链接
screen.disconnect();
} catch (Bx5GException e) {
e.printStackTrace();
return;
}
}
}).start(); ``` 通过以上步骤,可成功集成并使用本项目的SDK,实现与仰邦控制器的交互功能。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】