请输入
鑫通态官网
菜单
项目配置有误
下载
1. 进入项目所在目录的\.devicesetting目录
2. 可能是devicesconf.json在非正常关闭时损坏了，挑一个最近的，改成devicesconf.json
分享文章
上一个
加入模拟器SDL库，并修改模拟器设置
下一个
网络问题相关
最近修改: 2026-08-02
Powered by
Apus IDE 使用手册
前言
第一章 快速上手
1.1 HMI型号
1.2 下载安装
IDE下载地址
1.3 IDE使用
1.3.1 项目管理
1.3.2 工具菜单
1.3.3 IDE字体安装
1.3.4 项目目录结构
1.4 创建工程
01 Hello World
02 组态变量
03 资料取样
04 历史曲线
05 数据导出
06 编写C++代码
1.5 调试模拟
1.6 下载到HMI
网络下载第一次成功，再次下载就提示连接设备失败
1.7组态快速入门（ModBusRTU）
1.8串口快速上手（自由协议）
1.10常见问题
第二章 控件教程
2.1 控件属性
同时启用【可见控制】【闪烁动画】
重着色
2.2 窗体控件
2.2.1 程序中页面操作
2.2.2 内置对话框
2.2.3 使用整型变量切换页面
2.2.4 设置窗体的背景图片
2.3 常规控件
2.3.1 面板
显示GIF动画
长方形，背景透明，边框不透明
面板固定不滑动
2.3.2 贴磁
2.3.2 文字
2.3.3 功能键
2.3.4 文本框
修改系统键盘布局
修改系统键盘样式
用代码模拟点击文本框
2.3.5 LED
2.3.6 进度条
从右到左增加的进度条
2.3.7 下拉框
2.3.8 图片
怎么在代码中 设置 wMImage 的图像
从服务器下载下来的图片不能显示
如何对图片进行非等比缩放
图片显示花掉（数据错位）
2.3.9 列表框
addButton中的文字水平居中
2.3.10 滑动轴
2.3.11 滑块
2.3.12 圆盘
2.3.13 切换按钮
2.3.14 二维码
2.3.15 画布
代码示例
2.3.16 弧形进度条
2.3.17 视频播放器
视频控件上叠加的控件一起截图
消除叠加在视频上的文字锯齿
RTSP流媒体播放延迟
多路RTSP流媒体防卡死
播放本地文件的文件基本要求
2.3.18 直线
2.3.19 曲线图
2.4 元件
5.4.1 按钮型
5.4.2 开关型
5.4.3 指示灯
5.4.4 仪表盘
5.4.5 指针
5.4.6 刻度盘
5.4.7 多状态标签
5.4.8 数值元件
5.4.9 文本区
2.5 数据/资料
2.5.1 实时曲线
2.5.2 历史曲线
指定查询日期(历史数据模式)
指定查询时间范围(历史数据模式)
2.5.3 资料取样
指定查询日期范围(历史数据模式)
设置表头标题及数据保留小数位数
2.5.4 事件显示
单元格文本的对齐
2.5.5 报警显示
2.5.6 报警条
2.5.7 配方表
2.5.8 操作日志
这个操作日志有方法能用代码添加进去吗
2.5.9 数据查询
使用mssql进行数据查询
2.6 外设
2.6.1 串口
2.6.2 打印机
2.6.3 定时器
2.6.4 键盘
2.6.5 扫码枪/读卡器
2.6.6 HTTP
2.6.7 异步
2.6.8 变量消息
第三章 实时变量
3.1 变量初值
3.2 设备变量的驻留
3.3 掉电保存
3.4 导入导出
CoDeSys导入变量
3.5 变量传递
第四章 资料取样
导出全部采样数据到CSV文件
采样值的线性换算
导出到HMI的Flash里
第五章 配方功能
第六章 事件管理
设置事件表的类别别名、时间模式
勾选更新配置数据
查询指定时间范围的事件
事件的确认及其颜色
关于事件表数据行背景色的优先级
事件数据库eventlog.db
第七章 定时任务
第八章 多语言
使用代码设置多语言
设置常规规定语言之外的语言
第九章 用户权限
第十章 字体管理
一些字体文件下载
第十一章 数据库功能
数据维护及两个下拉框联动
程序下载到屏幕上只运行某个函数一次的办法，重新上电也不会再次运行该函数
第十二章 系统内置功能
12.1 概述
12.2 系统设置
12.3 系统信息
12.4 时间日期
12.5 背光屏保
12.6 以太网
12.7 WiFi 设置
12.8 4G网络
12.9 物联网
12.10 密码设置
12.11 OTA设置
12.12 文件管理器
12.13 串口测试
12.14 分期管理
第十三章 常用设备驱动
！连接必读
ModBus驱动
ModBus多设备连接
ModBus常见问题
ModBus类脚本操作
西门子驱动
三菱系列驱动
三菱Q系列 R系列 FX5U系列网口连接说明
台达系列驱动
信捷系列驱动
通用MQTT（3.1 3.1.1）驱动
人脸识别驱动
指纹识别驱动
TTS语音驱动
阿里云MQTT驱动
APUS之阿里云物联模拟器版开发示例
亚马逊MQTT驱动
通用物联网云平台(MQTT IOT)驱动
在MQTT IOT启动前修改配置
Emqx实例
附加MQTT参数-r --will-retain --will-topic --will-payload
判断订阅时的连接状态
欧姆龙连接说明
第十四章 脚本（C/C++）开发(进阶)
(标准) C/C++语法结构
(鑫通态) C/C++语法结构
(标准) string相关
(鑫通态) string相关
(标准) vector相关
(鑫通态) vector相关
(鑫通态) vm 相关（变量管理器）
(鑫通态) pm 相关（页面管理器）
(鑫通态) asyn异步相关
(鑫通态) 类与指针相关
(鑫通态)util工具类-高频使用接口（时间/文件/字符串/网口/串口）
(鑫通态)其他常用接口
内部枚举常量
页面接口（开关页面/消息对话框/自定义页面）
变量接口（vm变量管理器函数）
硬件接口（IIC/I2C,PWM,TTS，网卡）
数据库接口（Sqlite,MySQL···）
控件接口（位置，大小，颜色）
表格接口（行列操作）
采样接口（导出数据）
权限接口（管理用户权限）
网络接口（http,Socket）
控件接口
下拉框控件
图片控件
按钮类控件
面板类控件
编码器接口
(标准)时间戳转化设置时间
(标准)自定义json
调用linux命令
动态生成控件示例1 - 图片文件预览
工程案例讲解
出厂Demo控件部分（第一页贴磁）
出厂Demo外设部分（第二页贴磁）
出厂Demo采样视频部分（第三页贴磁）
加SUM校验串口收发案例
自定义Socket客户端案例
自定义Socket服务端案例（多客户端连接）
SQLite数据库操作
查看数据库案例
HTTP操作案例
动画效果案例
心跳效果
雷达效果
跑马灯效果
蒙板效果
IO控制案例
多路视频案例
消息队列案例（进阶篇）
自定义控件样式绑定变量
使用XPDF显示PDF文档
自定义Modbus
OPC UA客户端和服务端配置搭建
自定义串口
常见问题 FAQ
工程编译运行相关
调试程序
开机启动后卡在蓝色LOGO页面怎么办
平台更新后旧工程编译失败怎么办
添加的代码/函数被刷新怎么办
用户自定义代码区
如何启用看门狗（WatchDog）
如何在屏幕下显示打印输出调试
recompile with -fPIc
IDE常用快捷键
在“C/C++ 索引器”期间发生了内部错误。
页面运行不刷新怎么办(如何清理缓存)
工程项目打不开或导入失败
缺少”MDemo”的项目描述文件(.project)
中文汉字编码转换问题
编译出现找不到文件的情况怎么办
还原到上次编译通过的代码
加入模拟器SDL库，并修改模拟器设置
项目配置有误
网络问题相关
网线连接不通怎么办
如何修改屏的ip
如何在自定义页面修改设备IP
rtsp在电脑上模拟是可以显示的，下载到屏幕里就不行了
连接设备失败!
串口相关
如何使用全局串口
端口号下拉框没有选项
控件相关
如何获取/设置控件颜色及透明度
如何获取当前页ID
动态添加控件
如何使用自定义键盘
如何使用自定义密码管理
配方表中的数据更改后未保存怎么办
动画效果如何设置上移/下移
如何自定义下拉框/列表框/滑动轴内容
视频播放中，弹出对话框时，视频不显示了，如何能继续显示？
控件的最大最小值如何用代码控制
如何用代码打开内置窗口
如何在视频上绘制图形
问题集
数值缩放平移
表达式如何使用
如何获取控件的当前状态
为何页面可以左右或上下拖动
如何修改画面标题
如何获取输入弹出框的内容
对于下拉框列表框的多语言设置
对于同名图片如何做到图片切换
c++脚本相关
如何延时执行一个函数
如何生成/解析JSON数据
自己增加的成员变量不见了？
如何加入第三方动态库
我串口接收到某一标志后，需要修改其他窗体 字体颜色，代码怎么操作？
如何生成自己的动态库
通讯驱动相关
如何查看设备是否连接
程序刚启动时获取不到设备变量的值怎么办
如何动态修改驱动IP或COM口
ModBus如何按长字节读取
如何读取长字节数组各个字节数据
连接参数都正常但是连不上PLC
如何修改设备名称
如何在组态变量中使用动态设备地址
字体相关问题
字体安装失败怎么办
为什么组态设计时的字体和实际运行的字体大小不一致
calibri粗体16号以下显示不正常
FontAwesome字体的编码与图形对照表
HMI系统相关
如何更新镜像
屏幕默认字符编码（UTF-8 GBK）
如何获取设备唯一号（SN）
如何刷新Linux文件缓存
将文件下载至U盘
如何设置MMA
U盘和SD卡的路径是什么
在多语言标签中点击添加没反应
对于ide及屏下常用路径的说明
对于固定不可更改的型号如何修改成可编辑的型号
用户权限相关
如何使用不同用户跳转不同页面
时间控件相关
控件如何显示当前时间？
脚本获取当前时间（时间戳）
如何同步屏幕系统（HMI）时间
数据库相关
资料采样、事件等记录达到设定的上限值会怎么样
请问资料取样，采样周期怎么设置变量来修改
其他常见问题
专题
普通变量与设备变量
设备变量无法正常添加？
定时任务和异步线程
曲线控件使用
实时曲线示例1：显示变量的曲线图
曲线光标的使用
实时曲线能否从原点（0，0）绘制曲线图
表格控件使用
资料取样示例1：显示指定日期范围的数据及导出
采样值的线性变换及控制小数位数
怎么翻页
媒体（动画、视频、声音等）
01 显示GIF动画文件
02 多状态切换方式
03 用代码编写动画
04 使用动画效果属性
11 视频-播放文件（组态操作）
12 视频-播放文件（编程代码）
13 视频-播放USB摄像头
14 视频-播放RTSP流
15 播放mp3
16 播放wav
21 画布-绘制直线
22 画布-手写
头文件
DataSample.h
Util.h
这个扫码枪的鼠标是不是可以隐藏
使用AI方法
使用DeepSeek来审核代码
附录
触摸屏校准
OTA服务器搭建案例
控件截屏
嵌入式页面使用
本地http/ftp服务器搭建
APUS通过外接USB键盘实现界面操作及快捷键使用
APUS通过编码器实现三键控制界面操作
更换开机LOGO
常用代码块
获取指定类型的子控件
生成下拉选项的json
通过7-Zip打包程序文件
MD5算法源文件
HMI 辅助调试软件
屏幕的VNC怎么配置
DNS设置
上传文件到ftp服务器
Powered by
大纲
分享文章
;}.cls-2{fill:%230868f7;}.cls-3{fill:url(%23未命名的渐变_44);}.cls-4{fill:%23333;}%3c/style%3e%3clinearGradient%20id='未命名的渐变_8'%20x1='33.73'%20y1='100.61'%20x2='-0.03'%20y2='-1.06'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%237ae9fb'/%3e%3cstop%20offset='0.67'%20stop-color='%232b90f8'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3clinearGradient%20id='未命名的渐变_44'%20x1='27.86'%20y1='18.67'%20x2='68.36'%20y2='22.22'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%235ac7f2'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3c/defs%3e%3cpath%20class='cls-1'%20d='M29,28.74V81.91l-9.51-3.68v0L8.52,74A7.17,7.17,0,0,1,4,67.32V24.54A3.76,3.76,0,0,1,9.08,21Z'/%3e%3cpath%20class='cls-2'%20d='M68.09,78.07a13.15,13.15,0,0,1-17.9,12.06L29,81.91h0V28.74L50.19,37A13.17,13.17,0,0,0,68.08,25.3h0Z'/%3e%3cpath%20class='cls-3'%20d='M68.08,25.3a13.19,13.19,0,0,1-6.73,10.87A13.09,13.09,0,0,1,50.19,37L29,28.74V6A3.76,3.76,0,0,1,34.1,2.52l25.59,9.91A13.22,13.22,0,0,1,68.08,25.3Z'/%3e%3cpath%20class='cls-4'%20d='M129.06,81.76a4.33,4.33,0,0,1-3.19-1.31,4.4,4.4,0,0,1-1.31-3.24V56.86H97.65V77.21a4.36,4.36,0,0,1-1.35,3.2A4.68,4.68,0,0,1,93,81.76a4.32,4.32,0,0,1-3.19-1.31,4.37,4.37,0,0,1-1.32-3.24V27.27A4.58,4.58,0,0,1,89.83,24a4.59,4.59,0,0,1,7.82,3.27V48.15h26.91V27.27A4.58,4.58,0,0,1,125.91,24a4.59,4.59,0,0,1,7.82,3.27V77.21a4.37,4.37,0,0,1-1.36,3.2A4.65,4.65,0,0,1,129.06,81.76Z'/%3e%3cpath%20class='cls-4'%20d='M163.77,81.66c-6.57,0-11.76-1.92-15.44-5.7s-5.54-9.07-5.54-15.74a26.76,26.76,0,0,1,2.09-10.43,17.72,17.72,0,0,1,6.67-8.06,19.15,19.15,0,0,1,10.68-2.95,19,19,0,0,1,10.46,2.8,18.7,18.7,0,0,1,6.55,7.36,22.53,22.53,0,0,1,2.36,10.28A4.51,4.51,0,0,1,177,63.77H152.23a10.8,10.8,0,0,0,3.49,6.65c2,1.68,4.88,2.52,8.66,2.52a22.25,22.25,0,0,0,7.54-1.21c.74-.3,1.55-.67,2.37-1.07a3.75,3.75,0,0,1,1.84-.4,4.09,4.09,0,0,1,3,1.15,4,4,0,0,1,1.12,3,4.38,4.38,0,0,1-2.58,3.82,32.34,32.34,0,0,1-6.36,2.61A28.67,28.67,0,0,1,163.77,81.66ZM172.4,55.9a9.72,9.72,0,0,0-1.63-4.56A9.9,9.9,0,0,0,167,48a10.38,10.38,0,0,0-4.64-1.14,12,12,0,0,0-4.77,1.06,9.54,9.54,0,0,0-4.89,5.66,11.78,11.78,0,0,0-.51,2.3Z'/%3e%3cpath%20class='cls-4'%20d='M193,81.64a4.49,4.49,0,0,1-4.51-4.55V27.28A4.58,4.58,0,0,1,189.84,24a4.48,4.48,0,0,1,3.28-1.36A4.36,4.36,0,0,1,196.35,24a4.46,4.46,0,0,1,1.31,3.31V77.09a4.34,4.34,0,0,1-1.35,3.2A4.67,4.67,0,0,1,193,81.64Z'/%3e%3cpath%20class='cls-4'%20d='M263.79,81.71a5.7,5.7,0,0,1-4.2-1.74,5.76,5.76,0,0,1-1.73-4.19V27.37a4.58,4.58,0,0,1,1.35-3.27A4.59,4.59,0,0,1,267,27.37V72.53h24a4.58,4.58,0,0,1,3.27,7.82A4.66,4.66,0,0,1,291,81.71Z'/%3e%3cpath%20class='cls-4'%20d='M424.48,81.74a4.71,4.71,0,0,1-2.71-.88,5.43,5.43,0,0,1-1-1l-.07-.09-12.41-17-5.41,5v9.44a4.31,4.31,0,0,1-1.36,3.19,4.66,4.66,0,0,1-3.3,1.36A4.29,4.29,0,0,1,395,80.42a4.36,4.36,0,0,1-1.32-3.23V27.37A4.58,4.58,0,0,1,395,24.1a4.52,4.52,0,0,1,6.58.12,4.54,4.54,0,0,1,1.24,3.15V56.31l17.72-16.38.05,0a4.8,4.8,0,0,1,2.94-1.11,4.4,4.4,0,0,1,3.27,1.2,4.57,4.57,0,0,1,1.2,3.27,4.44,4.44,0,0,1-.77,2.33,7.45,7.45,0,0,1-1.43,1.65l-11,9.64,13.34,17.68a5,5,0,0,1,1,2.71,4.12,4.12,0,0,1-1.36,3.24A4.64,4.64,0,0,1,424.48,81.74Z'/%3e%3cpath%20class='cls-4'%20d='M317.93,81.76a21.5,21.5,0,1,1,21.17-21.5A21.37,21.37,0,0,1,317.93,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,317.93,47.66Z'/%3e%3cpath%20class='cls-4'%20d='M212.18,101.22a4.12,4.12,0,0,1-3.05-1.26,4.17,4.17,0,0,1-1.26-3.1V43.34a4.37,4.37,0,0,1,1.3-3.14,4.26,4.26,0,0,1,3.13-1.3,4.19,4.19,0,0,1,3.1,1.26,4.32,4.32,0,0,1,1.26,3.16,20.77,20.77,0,0,1,13-4.54,21.51,21.51,0,0,1,0,43,20.51,20.51,0,0,1-13-4.57V96.86a4.15,4.15,0,0,1-1.3,3.06A4.5,4.5,0,0,1,212.18,101.22Zm17.43-53.63c-6.23,0-12.93,4.11-12.93,12.72a12.73,12.73,0,0,0,25.46,0A12.71,12.71,0,0,0,229.61,47.59Z'/%3e%3cpath%20class='cls-4'%20d='M365.76,81.76a21.5,21.5,0,1,1,21.18-21.5A21.37,21.37,0,0,1,365.76,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,365.76,47.66Z'/%3e%3c/svg%3e)