更新记录

1.0.0（2026-07-29）

• 首次发布
• 基于卓策 zckjAPI-2.9.jar 封装
• 支持系统控制、设备信息、显示控制、定时开关机、APK管理、网络控制、GPIO控制、硬件检测等完整 API
• 支持 ZC-20A / ZC-40A / ZC-40M / ZC-64A / ZC-83A / ZC-83E / ZC-328 系列 / ZC-339 系列 / ZC-312 / ZC-3568 / ZC-972 / ZC-3588 / ZC-H133 / ZC-H352 / ZC-982 / ZC-H527 等 20 款卓策主板型号

平台兼容性

uni-app(5.11)

uni-app x(5.22)

zmr-uts-zhuoche

卓策主板设备控制 UTS 插件

基于卓策官方 zckjAPI-2.9.jar SDK 开发的 uni-app UTS 原生插件，提供完整的卓策系列安卓主板设备控制能力。

安装方式

本插件为 uni_modules 插件，可通过以下方式安装：

1. 在 HBuilderX 中点击 插件市场 按钮，搜索 zmr-uts-zhuoche 导入
2. 或直接在插件市场页面点击 使用 HBuilderX 导入插件
3. 手动安装：将 uni_modules/zmr-uts-zhuoche 复制到项目对应目录

功能特性

• 系统控制: 关机、重启、恢复出厂设置、OTA升级、执行Shell命令、设置系统时间
• 设备信息: 获取设备编号、型号、序列号、MAC地址（以太网/WiFi）、SDK版本、设备标识、系统属性
• 显示控制: 屏幕旋转、全屏切换、导航栏/状态栏控制、背光控制、亮度调节
• 定时开关机: 设置/取消/查询定时开关机（支持按星期设置，含异步回调）
• APK管理: 静默安装/卸载APK、替换开机动画（含异步回调）
• 网络控制: 以太网静态IP/DHCP、以太网/WiFi/蓝牙开关、WiFi IP设置（含异步回调）
• GPIO控制: GPIO读写、模式设置
• 硬件检测 ⚠: 摄像头、屏幕、麦克风、扬声器、存储、触摸屏、WiFi状态检测（zckjAPI-2.9 中测试无效）

支持主板型号

ZC-20A, ZC-40A, ZC-40M, ZC-64A, ZC-83A, ZC-83E, ZC-328, ZC-328E, ZC-328S, ZC-339, ZC-339E, ZC-312, ZC-3568, ZC-356, ZC-972, ZC-3588, ZC-H133, ZC-H352, ZC-982, ZC-H527

返回值说明

所有带 callback 参数的方法均为异步回调风格，回调参数统一为 (code: string, data: string) => void：

• code === "0" 表示操作成功
• code !== "0" 表示操作失败，data 中包含错误信息
• 不带 callback 的方法为同步调用，直接返回结果

完整接口列表

设备信息类

系统控制类

显示控制类

定时开关机类

网络控制类

APK管理类

GPIO控制类

硬件检测类 ⚠

此分类下所有接口在 zckjAPI-2.9 中测试无效，返回 -1，请在实际主板上验证确认后再使用。

使用示例

import * as ZcDevice from '@/uni_modules/zmr-uts-zhuoche'

// 获取设备信息
ZcDevice.getDeviceNo((code, data) => {
  console.log('设备编号:', data)
})
console.log('设备型号:', ZcDevice.getBuildModel())
console.log('序列号:', ZcDevice.getBuildSerial())

// 系统控制
ZcDevice.shutDown()      // 关机
ZcDevice.reboot()        // 重启
ZcDevice.factoryReset()  // 恢复出厂设置

// 显示控制
ZcDevice.setNavigationBar(false)  // 隐藏导航栏
ZcDevice.setStatusBar(false)      // 隐藏状态栏
ZcDevice.setScreenRotationTo(1)   // 旋转屏幕

// 定时开关机（按星期设置：周一到周五 09:00-18:00）
ZcDevice.setPowerOnOffWithWeekly(9, 0, 18, 0, '01111100', (code, msg) => {
  if (code === '0') console.log('定时设置成功')
})

// 网络控制
ZcDevice.openCloseEth('eth0', true, (code, msg) => {
  console.log('以太网状态:', code)
})
ZcDevice.setStaticIP('192.168.1.100', '192.168.1.1', '255.255.255.0', '114.114.114.114', '8.8.8.8')

// GPIO控制
const val = ZcDevice.readGpio('P', 1)
ZcDevice.writeGpio('P', 1, 1)

// APK管理
ZcDevice.silentInstallApk('/sdcard/test.apk', (code, msg) => {
  if (code === '0') console.log('安装成功')
})

注意事项

1. 本插件仅支持 Android 平台，不支持 iOS
2. 仅适用于 卓策系列安卓主板，非卓策主板无法使用
3. 部分功能（如关机、重启、恢复出厂设置）需要 系统级权限（System权限或Root权限）
4. 定时开关机按星期设置中 weekStatus 参数为7位字符串，从周日到周六，1 表示开启，0 表示关闭（如 01111100 表示周一到周五）
5. 异步回调结果通过 BroadcastReceiver 接收，回调函数需要保持存活直到返回结果
6. setShjc（守护进程）和 defaultStartApk（自启动APK） 通过 Shell 写入配置文件实现，zckjAPI 无对应标准接口，功能测试无效
7. 硬件检测类接口（getCameraStatus 等）在 zckjAPI-2.9 中测试无效，返回 -1，实际可用性需在目标主板上验证

开发文档

UTS 语法 UTS API插件