【花雕动手做】行空板 K10 系列实验之音频录放 WS2812B 背景音乐小灯

行空板K10是一款专为快速体验物联网和学习人工智能而设计的开发学习板，100%采用国产芯片，知识产权自主可控，符合信息科技课程中编程学习、物联网及人工智能等教学需求。该板集成2.8寸LCD彩屏、WiFi蓝牙、摄像头、麦克风、扬声器、RGB指示灯、多种传感器及丰富的扩展接口。凭借高度集成的板载资源，教学过程中无需额外连接其他设备，便可轻松实现传感器控制、物联网应用以及人脸识别、语音识别、语音合成等AI人工智能项目。

主要特点
集成摄像头&内置算法，可进行离线图像检测
集成麦克风&内置算法，可进行离线语音识别
集成扬声器&内置算法，可进行离线语音合成
2.8寸彩色屏幕，数据展示更清晰
集成度高，利于教学
接口丰富，兼容软件多，扩展性好

主打：音频录放模块

相关说明

辅助：屏幕显示相关积木

LED控制模块

【花雕动手做】行空板 K10 系列实验之音频录放 WS2812B 背景音乐小灯
实验开源代码

// 引入行空板K10核心驱动头文件，封装屏幕、按键、RGB彩灯、音频等全部硬件接口#include"unihiker_k10.h"// 实例化行空板全局硬件对象，后续所有屏幕、灯光操作均通过k10调用UNIHIKER_K10 k10;// 屏幕显示方向参数：2代表屏幕正向显示，可修改0/1/2/3切换横竖屏翻转uint8_tscreen_dir=2;// 实例化音乐播放对象，用于播放内置预设旋律Music music;// 板子上电/复位后仅执行一次的初始化函数voidsetup(){// 初始化行空板底层硬件总线k10.begin();// 根据设定方向初始化屏幕驱动k10.initScreen(screen_dir);// 创建画布缓存，所有文字、图形绘制都在画布上完成再统一刷新屏幕k10.creatCanvas();// 设置屏幕背景色为纯白色（RGB十六进制 0xFFFFFF）k10.setScreenBackground(0xFFFFFF);// 在画布第3行打印蓝色标题文字k10.canvas->canvasText("行空板K10系列实验",3,0x0000FF);// 在画布第5行打印红色副标题文字k10.canvas->canvasText(" WS2812音乐小灯",5,0xFF0000);// 将画布内容刷新输出到实体屏幕，文字才会真正显示k10.canvas->updateCanvas();}// 循环函数，setup执行完毕后无限重复运行voidloop(){// 播放内置预设旋律DADADADUM（短促提示音）music.playMusic(DADADADUM);// 程序阻塞延时1000毫秒(1秒)delay(1000);// 控制板载全部RGB彩灯(-1代表全部灯珠)点亮纯红色 0xFF0000k10.rgb->write(-1,0xFF0000);delay(1000);// 全部彩灯切换为青蓝色 0x00FFFFk10.rgb->write(-1,0x00FFFF);delay(1000);// 全部彩灯切换为纯蓝色 0x0000FFk10.rgb->write(-1,0x0000FF);delay(1000);}

代码解读

一、头文件与全局对象定义

#include"unihiker_k10.h"

引入行空板 K10 官方底层库，封装了屏幕、RGB 彩灯、扬声器、按键、I2C 等全部硬件驱动，不用手动配置引脚。

UNIHIKER_K10 k10;

创建行空板主硬件实例，所有屏幕、灯光操作都依靠 k10 调用内部函数。

uint8_tscreen_dir=2;

屏幕旋转参数，2 为正常正向显示，修改 0/1/3 可翻转屏幕、切换竖横屏。

Music music;

创建音乐播放器对象，内置多段预设旋律，直接调用即可播放提示音。

二、setup () 上电初始化函数
上电、复位只运行 1 次，负责硬件初始化与开机界面绘制：
k10.begin()：初始化板载所有底层硬件总线；
k10.initScreen(screen_dir)：按照设定方向初始化显示屏；
k10.creatCanvas()：创建屏幕画布缓冲区，所有绘图先存在缓存，避免屏幕闪烁；
k10.setScreenBackground(0xFFFFFF)：设置屏幕底色为白色；
canvasText(文字,行数,颜色)：在画布指定行写入彩色文字；
updateCanvas()：把缓存里的文字画面刷新到实体屏幕，文字才能显示。

三、loop () 无限循环主逻辑
setup 执行完成后，该函数会无限循环往复执行，完整流程：
music.playMusic(DADADADUM)：播放内置短促提示音效；
delay(1000)：阻塞等待 1 秒；
k10.rgb->write(-1, 0xFF0000)：-1 代表控制全部板载 RGB 灯，参数 2 是十六进制颜色，当前亮红色；
间隔 1 秒切换青蓝色，再间隔 1 秒切换蓝色，再等待 1 秒回到循环开头，重复播放音乐、循环变色。

四、整体功能总结
程序上电后屏幕显示实验标题，之后持续循环：播放一段提示音乐 → 红、青、蓝三色 RGB 灯依次各亮 1 秒，无限往复。

Mind+图形编程

实验场景图与视频记录