AWTRIX3智能矩阵屏API开发指南

AWTRIX3智能矩阵屏API开发指南

awtrix3 Custom firmware for the Ulanzi Smart Pixel clock or self made awtrix. Getting started is easy as 1-2-3 项目地址: https://gitcode.com/gh_mirrors/aw/awtrix3

概述

AWTRIX3是一款功能强大的智能LED矩阵显示屏设备，提供了丰富的API接口供开发者进行二次开发。本文将全面介绍AWTRIX3的MQTT和HTTP API功能，帮助开发者快速掌握设备控制、状态监控、自定义应用开发等核心功能。

设备状态监控

AWTRIX3提供了多种方式获取设备运行状态信息：

基础状态信息

• 设备统计信息：包括电池状态、内存使用情况等基础指标
• 效果列表：获取设备支持的所有显示效果
• 过渡效果：查询可用的过渡动画效果
• 应用循环：查看当前循环显示的应用列表

这些信息可以通过MQTT主题订阅或HTTP GET请求获取，为设备监控提供了便利。

实时屏幕镜像

开发者可以获取矩阵屏的实时显示内容：

1. 像素数据获取：返回当前屏幕的24位色值数组
2. 浏览器实时查看：通过内置的Web界面查看屏幕内容
3. 截图功能：支持下载当前屏幕截图
4. GIF生成：可将当前显示内容导出为GIF动画
5. 全屏模式：提供全屏显示选项，可自定义帧率

电源管理

AWTRIX3提供了灵活的电源控制选项：

1. 开关控制：可随时开启或关闭矩阵显示
2. 深度睡眠模式：显著降低功耗，延长电池寿命
   • 可设置睡眠持续时间
   • 只能通过物理按键唤醒
   • 适用于需要长时间待机的场景

音频播放功能

设备支持多种音频播放方式：

1. 预设铃声播放：播放存储在MELODIES文件夹中的RTTTL格式铃声
2. DFPlayer支持：支持直接播放DFPlayer模块中的MP3文件
3. RTTTL字符串播放：支持直接发送RTTTL格式字符串进行播放

氛围灯控制

AWTRIX3可设置为全屏单色显示，创建氛围灯效果：

1. 颜色设置方式：
   • 色温值(Kelvin)
   • RGB颜色值
   • HEX颜色代码
2. 亮度调节：可独立控制亮度值
3. 注意事项：全屏高亮度显示会增加功耗和发热

彩色指示器

设备提供三个可编程的彩色指示区域：

1. 位置分布：
   • 右上角(Indicator1)
   • 右侧中部(Indicator2)
   • 右下角(Indicator3)
2. 显示效果：
   • 静态显示
   • 闪烁效果(可设置间隔)
   • 淡入淡出效果
3. 颜色设置：支持RGB数组或HEX代码
4. 隐藏方式：发送黑色或空指令

自定义应用与通知

AWTRIX3的核心功能之一，允许开发者创建个性化显示内容。

基本功能特性

• 文本显示：支持多种字体效果
• 图标集成：可显示内置图标或自定义8x8图像
• 图表功能：支持柱状图和折线图
• 进度条：可视化显示进度
• 绘图指令：提供像素级绘图控制

高级功能

1. 多页应用：支持一次发送多个页面内容
2. 彩色文本片段：实现文本不同部分不同颜色
3. 生命周期管理：可设置应用自动过期时间
4. 持久化存储：重要应用可保存到闪存
5. 特效叠加：支持多种视觉效果叠加

通知系统

• 临时通知：短暂显示后自动消失
• 持续通知：需用户确认才消失
• 唤醒功能：可在屏幕关闭时唤醒显示
• 声音提示：支持通知伴随声音
• 转发功能：可转发到其他AWTRIX设备

应用管理

1. 应用切换：支持顺序切换和直接跳转
2. 应用删除：提供多种删除方式
3. 通知清除：可编程清除持续通知

设备设置与维护

1. 参数配置：支持多种设备参数调整
2. 固件更新：提供OTA更新支持
3. 设备重置：
   • 重启设备
   • 恢复出厂设置
   • 清除所有设置

开发建议

1. 性能优化：避免过多绘图指令导致内存不足
2. 闪存保护：减少频繁写入延长设备寿命
3. 用户体验：合理设置通知持续时间和效果
4. 错误处理：考虑网络中断等异常情况

通过本文介绍的API，开发者可以充分发挥AWTRIX3智能矩阵屏的潜力，创建各种创新的显示应用和交互体验。无论是简单的信息展示还是复杂的交互应用，AWTRIX3都能提供强大的支持。

awtrix3 Custom firmware for the Ulanzi Smart Pixel clock or self made awtrix. Getting started is easy as 1-2-3 项目地址: https://gitcode.com/gh_mirrors/aw/awtrix3