既然来了，点个star吧！万分感谢！
2025.4.7留: 优化了程序框架，程序变得更加安全了，代码体积也有所缩小，但是仍然不完美，没有发布出来。最近作者打算鸽一段时间了，实在抱歉，这半年任务颇多，需要准备各种竞赛，实在分不出精力来完善这个项目。但是请放心，项目在完善之前不可能被放弃维护，也就是说作者闲下来之后会继续维护此项目。
2025.3.3留：由于作者在esp32上测试时发现程序框架有stm32上没有出现的bug，大概率是指针使用不当造成的，所以作者打算重构OLED UI。在此前，OLED UI已经重构了2次，耗费了作者许多的精力，但好在取得了一些小小的成果。此次重构将解决现有阶段的bug，优化程序设计，将OLED UI在 OLED-Basic-Lib的基础上开发，优化了底层代码，支持全系屏幕自适应刷新，并增加一些功能，敬请期待！作者正在熬夜撸码中···
写在最前面：
- 由于并本项目并没有使用U8G2库，所以占有的程序空间并没有特别多。
- 由c编写，所以可以部署在仅支持c的平台上。
- 移植不困难，基本只需要有控制GPIO的能力即可移植。
- 字符的长度不再受到屏幕宽度的限制，字符长度超过规定的显示区域的时候会自动滚动显示。
- 尽管使用了软件iic或是spi进行通信，但是您无需担心屏幕的刷新率不够支撑丝滑的动画效果。例如在主频为72MHz的STM32F103C8t6单片机上使用软件SPI，128X128的OLED屏幕仍然可以在多数时间当中维持在80Hz以上的刷新率，这显然足够了。
目前项目仍然在整理优化当中
-
关于编程语言： 此项目使用了c语言，在C99标准下编写。经过验证，此项目也可以在c++的arduino框架下编译运行。
-
关于硬件组成：
-
显示部分： OLED显示屏，以下是(将要)支持的显示屏型号：
屏幕主控芯片 分辨率 通讯方式 是否已经推出例程 SSD1306 128x32 IIC ✘ SSD1305 128x32 SPI ✘ SSD1306 128x64 IIC ✔ SH1106 128x64 SPI ✘ SH1106 128x64 IIC ✘ SH1107 128x128 SPI ✔ SH1107 128x128 IIC ✘ -
按键部分： 目前最基本的按键支持是四个按键，分别是 确认键 返回键 上键 下键 ，这四个按键可以实现所有最基本的功能。
-
编码器部分： 编码器的加入可以使操作更加便捷优雅，但是不使用编码器也可以实现所有功能。所以移植的时候可以先不使用编码器，待按键功能测试完毕后再考虑移植编码器。
-
定时器部分： 定时器提供20ms的中断，应该是属于状态机(我看别人会把这种在定时器中断当中读取按键的方式叫做状态机)，可以实现一些ui的精确停留延时的效果，并可以计算当前刷屏的帧数。【当然，没有定时器中断也可以运行OLED UI，只是这样不能计算帧数和进行精确的停留延时。】
-
-
关于例程提供： 我会尽可能多地提供一些例程，下面是一些已经完成或是将会完成的例程：
芯片生产商 MCU 是否已经完成例程 IDE/开发环境 STM STM32F103C8t6 ✔ Keil5 STC STC8051U ✘ Keil5 乐鑫 ESP32 WOORM32 ✔ VsCode PlatformIO Arduino 英飞凌 TC264 ✘ ADS TI MSPm0g3507g ✘ CCS
如果您要移植此项目到别的平台，请耐心阅读以下内容。
-
-
【复制OLED基础库并进行简单移植】 首先，您需要将OLED屏幕的基础库复制到您的工程目录下， 也就是说，您需要保证您的工程当中包含了表格当中的这些文件。 我将他们列在了下方，您需要根据您的OLED屏幕型号选择适合文件。
文件名 描述 移植的时候是否需要修改 OLED_Driver.c底层驱动文件 需要 OLED_Driver.h底层驱动文件的头文件 需要 OLED_Fonts.c字库文件 不需要 OLED_Fonts.h字库文件的头文件 不需要 OLED.c应用层文件 不需要 OLED.h应用层文件的头文件 不需要
此OLED的底层驱动、字库和应用层的结构取自 【 江协科技的OLED教程 】 ,这个教程非常不错，我在他的文件基础上修改增添了不少东西，在此表衷心感谢。
好了，您的工程文件夹中应该包含了这些文件了。 现在，请打开
OLED_Driver.c和OLED_Driver.h文件，找到OLED_Init(void)函数，将GPIO的初始化部分修改为您的实际GPIO初始化代码。此外，您还需要修改将GPIO置高电平或置低电平的函数，将他们修改成适合您的GPIO驱动的函数。到现在为止，操作都很简单，就是初始化GPIO，然后修改GPIO驱动函数，即使是初学者应该也能轻松搞定，毕竟步操作的难度堪比点灯。接着，在您的主函数所在的文件内包含
"OLED.h"这个头文件，然后初始化OLED屏幕，进行简单的测试。代码如下：#include "OLED.h" int main(){ // 初始化OLED屏幕 OLED_Init(); // 进行简单的测试 while(1){ // 清除屏幕 OLED_Clear(); // 使用可以显示中英文混合字符串的函数，中文使用12X12的字体，英文使用7X12的字体 OLED_PrintfMix(0, 0,OLED_12X12FULL,OLED_7X12_HALF,"你好,HI."); // 将显存数组的内容刷新到屏幕上 OLED_Update(); } }
编译运行一气呵成，如果没有报错，恭喜您，您的OLED屏幕已经工作正常了。此时，您成功地移植了一个好用的OLED基础库。这个库有很多功能函数，后面我会详细介绍，您也可以参考 【 江协科技的OLED教程 】 ，这个教程有其中一些函数的使用方法。
-
注意事项与可能遇到的问题
- 如果您成功编译并且运行了，ASCII字符能够正常显示但是中文字符无法显示，请检查您的代码文件的编码格式。如果您使用的是UTF-8编码，请打开
OLED_Fonts.h文件，在前几行找到如下宏定义代码：并将括号内部的2改成3，这是因为UTF-8编码格式给中文字符分配了3个字节，而GB2312编码格式给中文字符分配了2个字节。（这在江协科技的教程当中是有的）/*中文字符字节宽度*/ #define OLED_CHN_CHAR_WIDTH (2) //UTF-8编码格式给3，GB2312编码格式给2
- 您最好打开
OLED.h文件,检查一下以下代码确认一下OLED屏幕的实际分辨率，如果分辨率与上述代码不符，请修改这两个宏定义。//使用宏定义的方式确定oled的横向像素与竖向像素 #define OLED_WIDTH (128) #define OLED_HEIGHT (128)
- 有关IIC通讯的问题：如果您的OLED屏幕使用的是IIC通讯，并且恰好您的单片机主频非常高，那么有必要在置高低电平的函数中加入延时，保证屏幕能够正确地接受数据。如果您的屏幕使用的是SPI通讯，那么您可以忽略这一点。当然，您完全可以自己修改OLED驱动文件，使用硬件IIC。
- 如果您成功编译并且运行了，ASCII字符能够正常显示但是中文字符无法显示，请检查您的代码文件的编码格式。如果您使用的是UTF-8编码，请打开
-
-
-
【复制OLED_UI实现文件并进行按钮驱动的编写】 现在，您需要将OLED_UI的实现文件复制到您的工程目录下， 也就是说，您需要保证您的工程当中包含了表格当中的这些文件。 我将他们列在了下方。
文件名 描述 移植的时候是否需要修改 OLED_UI_Driver.c按钮、编码器等驱动文件 需要 OLED_UI_Driver.h按钮、编码器等驱动文件的头文件 需要 OLED_UI.c实现文件 暂不需要 OLED_UI.h实现文件的头文件 暂不需要 OLED_UI_MenuData.c菜单数据文件（其实就是示例程序的菜单数据） 暂不需要 OLED_UI_MenuData.h菜单数据文件的头文件 暂不需要
好了，您的工程文件夹中应该包含了这些文件了。 现在，请打开
OLED_UI_Driver.c和OLED_UI_Driver.h。这两个文件主要是用来驱动按键、编码器等硬件的，同时也包含一些需要根据实际移植情况修改的函数。在OLED_UI_Driver.h当中，有这些函数的声明，您需要根据您的实际情况实现这些函数。下方是对它们的说明：读取按键状态的函数（此处使用宏来代替，目的是提高效率，减少代码量）
//获取确认，取消，上，下按键状态的函数(【Q：为什么使用宏定义而不是函数？A：因为这样可以提高效率，减少代码量】) #define Key_GetEnterStatus() digitalRead(BUTTON_PIN_1) //确认键 #define Key_GetBackStatus() digitalRead(BUTTON_PIN_2) //返回键 #define Key_GetUpStatus() digitalRead(BUTTON_PIN_3) //上键 #define Key_GetDownStatus() digitalRead(BUTTON_PIN_4) //下键
这些宏定义是用来获取按键的状态的，您需要根据实际情况修改它们，使它们能够获取到按键的状态。
初始化函数
//定时器中断初始化函数，初始化一个每20ms运行一次的定时器中断 void Timer_Init(void); //按键初始化函数 void Key_Init(void); //编码器初始化函数 void Encoder_Init(void);
这些函数是用来初始化硬件的，您需要根据实际情况修改它们，使它们能够正确地初始化硬件。
编码器使能、失能、读取增量值函数
// 编码器使能函数 void Encoder_Enable(void); //编码器失能函数 void Encoder_Disable(void); //读取编码器的增量值 int16_t Encoder_Get(void);
这些函数是用来控制编码器的，您需要根据实际情况修改它们，使它们能够正确地控制编码器。 延时函数
//延时函数 void Delay_us(uint32_t xus); void Delay_ms(uint32_t xms); void Delay_s(uint32_t xs);
这些函数是用来延时的，您需要根据实际情况修改它们，使它们能够正确地延时。
以上这些函数的修改，如果有困难，请参考 例程中 的实现。此外，编码器并不是必须的，如果您不需要编码器，那么您可以不实现这些函数。【将函数内容清空，如果有return值的函数，则返回0即可。】
-
【编写主函数并运行示例程序】 现在，您需要编写主函数，并在其中调用OLED_UI的实现函数。代码如下：
// 包含OLED_UI.h头文件 #include "OLED_UI.h" // 包含例程菜单数据头文件 #include "OLED_UI_MenuData.h" int main() { OLED_UI_Init(&MainMenuPage); while(1) { //OLED_UI的主循环函数 OLED_UI_MainLoop(); } } // 定时器中断服务函数 void Timer() { // OLED_UI的定时器中断服务函数 OLED_UI_InterruptHandler(); }
如果之前的操作都没问题，那一般来说就可以成功运行OLED UI的示例程序了。如果有问题，请仔细检查您的代码。请注意，
void Timer()是您的定时器中断服务函数，您需要根据实际情况修改函数名。如果定时器中断函数对您来说有困难，请将
OLED_UI_InterruptHandler()这个函数也放置到主循环内，那样也可以运行OLED_UI，如下。只不过有关精确时间的计算就不再准确。// 包含OLED_UI.h头文件 #include "OLED_UI.h" // 包含例程菜单数据头文件 #include "OLED_UI_MenuData.h" int main() { OLED_UI_Init(&MainMenuPage); while(1) { //OLED_UI的主循环函数 OLED_UI_MainLoop(); OLED_UI_InterruptHandler(); } }
-
如果您已经成功运行了示例程序，那么您已经具备了创建自己的菜单的条件，下面将介绍如何创建自己的菜单。
在OLED_UI框架中，菜单系统主要由两个核心结构体组成：MenuPage（菜单页面）和MenuItem（菜单项）。下面我们将通过实例来学习如何创建自己的菜单。
- MenuPage（菜单页面）：表示一个完整的菜单屏幕，包含多个菜单项。
- MenuItem（菜单项）：菜单中的单个选项，可以执行操作或进入子菜单。
- MenuWindow（菜单窗口）：用于显示临时信息或数据的弹窗。
以下是创建一个简单列表菜单的步骤：
首先，我们需要定义一个MenuItem数组，每个元素代表一个菜单项：
// 定义菜单项数组
MenuItem MyMenuItems[] = {
// 第一个菜单项：带回调函数的选项
{.General_item_text = "显示窗口", .General_callback = ShowMyWindow, .General_SubMenuPage = NULL},
// 第二个菜单项：进入子菜单的选项
{.General_item_text = "设置", .General_callback = NULL, .General_SubMenuPage = &SettingsMenuPage},
// 第三个菜单项：布尔开关选项
{.General_item_text = "开启功能", .General_callback = NULL, .General_SubMenuPage = NULL, .List_BoolRadioBox = &featureEnabled},
// 第四个菜单项：整数值选项
{.General_item_text = "亮度", .General_callback = NULL, .General_SubMenuPage = NULL, .List_IntBox = &brightnessValue},
// 第五个菜单项：浮点数值选项
{.General_item_text = "阈值", .General_callback = NULL, .General_SubMenuPage = NULL, .List_FloatBox = &thresholdValue},
// 返回上级菜单选项
{.General_item_text = "[返回]", .General_callback = OLED_UI_Back, .General_SubMenuPage = NULL},
// 终止标记：最后一个菜单项必须将General_item_text设为NULL
{.General_item_text = NULL}
};然后，我们需要定义一个MenuPage结构体来表示整个菜单页面：
// 定义菜单页面
MenuPage MyMenuPage = {
// 基本配置
.General_MenuType = MENU_TYPE_LIST, // 菜单类型：列表菜单
.General_CursorStyle = REVERSE_ROUNDRECTANGLE, // 光标样式：圆角矩形反色
.General_FontSize = OLED_UI_FONT_12, // 字体大小：12像素
.General_ParentMenuPage = NULL, // 父菜单：NULL表示这是主菜单
.General_LineSpace = 4, // 行间距：4像素
.General_MoveStyle = UNLINEAR, // 移动风格：非线性
.General_MovingSpeed = 4, // 移动速度：4
.General_ShowAuxiliaryFunction = NULL, // 辅助显示函数：无
.General_MenuItems = MyMenuItems, // 菜单项数组
// 列表菜单特有配置
.List_MenuArea = {0, 0, OLED_WIDTH, OLED_HEIGHT}, // 菜单显示区域
.List_IfDrawFrame = false, // 是否显示边框：否
.List_IfDrawLinePerfix = true, // 是否显示前缀：是
.List_StartPointX = 4, // 列表起始点X坐标
.List_StartPointY = 2 // 列表起始点Y坐标
};#define MENU_TYPE_LIST (0) // 列表菜单
#define MENU_TYPE_TILES (1) // 图标菜单
#define MENU_TYPE_EMPTY (2) // 空菜单#define UNLINEAR (0) // 非线性移动
#define PID_CURVE (1) // PID曲线移动#define REVERSE_RECTANGLE (0) // 反色矩形
#define REVERSE_ROUNDRECTANGLE (1) // 圆角反色矩形
#define HOLLOW_RECTANGLE (2) // 空心矩形
#define HOLLOW_ROUNDRECTANGLE (3) // 空心圆角矩形
#define REVERSE_BLOCK (4) // 反色块
#define NOT_SHOW (5) // 不显示光标#define OLED_UI_FONT_8 (8) // 8号字体
#define OLED_UI_FONT_12 (12) // 12号字体
#define OLED_UI_FONT_16 (16) // 16号字体
#define OLED_UI_FONT_20 (20) // 20号字体如果需要在菜单项中显示窗口，可以定义窗口结构体：
// 定义窗口结构体
MenuWindow MyWindow = {
.General_Width = 80, // 窗口宽度
.General_Height = 28, // 窗口高度
.Text_String = "这是一个窗口", // 窗口文本
.Text_FontSize = OLED_UI_FONT_12, // 字体大小
.Text_FontSideDistance = 4, // 文本到边缘的距离
.Text_FontTopDistance = 3, // 文本到顶部的距离
.General_WindowType = WINDOW_ROUNDRECTANGLE, // 窗口类型：圆角矩形
.General_ContinueTime = 4.0, // 窗口持续时间（秒）
// 如需显示数值，可添加以下配置
// .Prob_Data_Int = &value, // 整数值指针
// .Prob_Data_Float = &floatValue, // 浮点数值指针
// .Prob_DataStep = 1, // 数值步进
// .Prob_MinData = 0, // 最小值
// .Prob_MaxData = 100 // 最大值
};
// 显示窗口的回调函数
void ShowMyWindow(void) {
OLED_UI_CreateWindow(&MyWindow);
}#define WINDOW_RECTANGLE (0) // 矩形窗口
#define WINDOW_ROUNDRECTANGLE (1) // 圆角矩形窗口窗口支持绑定两种类型的数据：
Prob_Data_Float: 浮点型数据指针Prob_Data_Int: 整型数据指针
数据显示风格由系统自动根据绑定的指针类型确定：
WINDOW_DATA_STYLE_FLOAT(0): 浮点数据风格WINDOW_DATA_STYLE_INT(1): 整型数据风格WINDOW_DATA_STYLE_NONE(-1): 无数据风格
在主函数中初始化OLED_UI并启动菜单：
#include "OLED_UI.h"
// 定义全局变量
bool featureEnabled = false;
int16_t brightnessValue = 50;
float thresholdValue = 0.5;
int main() {
// 初始化OLED和其他硬件
// ...
// 初始化OLED_UI并设置当前页面为我们创建的菜单
OLED_UI_Init(&MyMenuPage);
while(1) {
// 运行OLED_UI主循环
OLED_UI_MainLoop();
// 如果没有定时器中断，可以在这里直接调用中断处理函数
// OLED_UI_InterruptHandler();
}
}
// 如果有定时器中断，在中断服务函数中调用
void TIM_IRQHandler(void) {
// 清除中断标志位
// ...
// 调用OLED_UI中断处理函数
OLED_UI_InterruptHandler();
}除了列表菜单，OLED_UI还支持图标菜单。创建图标菜单的步骤如下：
// 图标数据（示例，实际使用时需要根据自己的图标数据修改）
const uint8_t MyIcon[] = {
0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00,
// ... 更多图标数据
};// 定义图标菜单项
MenuItem MyTilesMenuItems[] = {
{.General_item_text = "功能1", .General_callback = NULL, .General_SubMenuPage = &SubMenuPage1, .Tiles_Icon = Icon1},
{.General_item_text = "功能2", .General_callback = NULL, .General_SubMenuPage = &SubMenuPage2, .Tiles_Icon = Icon2},
{.General_item_text = "功能3", .General_callback = NULL, .General_SubMenuPage = NULL, .Tiles_Icon = Icon3},
{.General_item_text = "设置", .General_callback = NULL, .General_SubMenuPage = &SettingsMenuPage, .Tiles_Icon = SettingsIcon},
{.General_item_text = NULL} // 终止标记
};// 定义图标菜单页面
MenuPage MyTilesMenuPage = {
// 基本配置
.General_MenuType = MENU_TYPE_TILES, // 菜单类型：图标菜单
.General_CursorStyle = NOT_SHOW, // 光标样式：不显示
.General_FontSize = OLED_UI_FONT_12, // 字体大小：12像素
.General_ParentMenuPage = NULL, // 父菜单：NULL表示这是主菜单
.General_LineSpace = 5, // 行间距
.General_MoveStyle = PID_CURVE, // 移动风格：PID曲线
.General_MovingSpeed = 4, // 移动速度
.General_ShowAuxiliaryFunction = NULL, // 辅助显示函数：无
.General_MenuItems = MyTilesMenuItems, // 菜单项数组
// 图标菜单特有配置
.Tiles_ScreenWidth = 128, // 屏幕宽度
.Tiles_ScreenHeight = 64, // 屏幕高度
.Tiles_TileWidth = 32, // 图标宽度
.Tiles_TileHeight = 32 // 图标高度
};-
菜单结构：
- 保持菜单层级简单，避免过深的嵌套
- 主菜单适合使用图标菜单，子菜单适合使用列表菜单
- 在每个子菜单中添加返回选项
-
交互设计：
- 使用直观的菜单项名称
- 对于布尔值选项，使用
.List_BoolRadioBox字段 - 对于需要调整的数值，使用
.List_IntBox或.List_FloatBox字段 - 对于需要临时显示信息的场景，使用窗口功能
-
性能优化：
- 避免在菜单回调函数中执行耗时操作
- 对于复杂的辅助显示，考虑使用
.General_ShowAuxiliaryFunction - 合理设置
.General_MovingSpeed以获得流畅的动画效果
以下是一个完整的简单菜单系统示例：
#include "OLED_UI.h"
// 全局变量
bool ledEnabled = false;
int16_t brightness = 100;
float temperature = 25.5;
// 子菜单页面声明（用于前向引用）
MenuPage SettingsMenuPage;
// 窗口定义
MenuWindow TempWindow = {
.General_Width = 80,
.General_Height = 28,
.Text_String = "当前温度",
.Text_FontSize = OLED_UI_FONT_12,
.Text_FontSideDistance = 4,
.Text_FontTopDistance = 3,
.General_WindowType = WINDOW_ROUNDRECTANGLE,
.General_ContinueTime = 3.0,
.Prob_Data_Float = &temperature,
.Prob_DataStep = 0.5,
.Prob_MinData = 0.0,
.Prob_MaxData = 100.0,
.Prob_BottomDistance = 3,
.Prob_LineHeight = 8,
.Prob_SideDistance = 4
};
// 窗口显示函数
void ShowTempWindow(void) {
OLED_UI_CreateWindow(&TempWindow);
}
// 主菜单项
MenuItem MainMenuItems[] = {
{.General_item_text = "显示温度", .General_callback = ShowTempWindow, .General_SubMenuPage = NULL},
{.General_item_text = "设置", .General_callback = NULL, .General_SubMenuPage = &SettingsMenuPage},
{.General_item_text = "[返回]", .General_callback = OLED_UI_Back, .General_SubMenuPage = NULL},
{.General_item_text = NULL}
};
// 设置菜单项
MenuItem SettingsMenuItems[] = {
{.General_item_text = "LED开关", .General_callback = NULL, .General_SubMenuPage = NULL, .List_BoolRadioBox = &ledEnabled},
{.General_item_text = "亮度调节", .General_callback = NULL, .General_SubMenuPage = NULL, .List_IntBox = &brightness},
{.General_item_text = "[返回]", .General_callback = OLED_UI_Back, .General_SubMenuPage = NULL},
{.General_item_text = NULL}
};
// 主菜单页面
MenuPage MainMenuPage = {
.General_MenuType = MENU_TYPE_LIST,
.General_CursorStyle = REVERSE_ROUNDRECTANGLE,
.General_FontSize = OLED_UI_FONT_12,
.General_ParentMenuPage = NULL,
.General_LineSpace = 4,
.General_MoveStyle = UNLINEAR,
.General_MovingSpeed = 4,
.General_ShowAuxiliaryFunction = NULL,
.General_MenuItems = MainMenuItems,
.List_MenuArea = {0, 0, OLED_WIDTH, OLED_HEIGHT},
.List_IfDrawFrame = false,
.List_IfDrawLinePerfix = true,
.List_StartPointX = 4,
.List_StartPointY = 2
};
// 设置菜单页面
MenuPage SettingsMenuPage = {
.General_MenuType = MENU_TYPE_LIST,
.General_CursorStyle = REVERSE_ROUNDRECTANGLE,
.General_FontSize = OLED_UI_FONT_12,
.General_ParentMenuPage = &MainMenuPage,
.General_LineSpace = 4,
.General_MoveStyle = UNLINEAR,
.General_MovingSpeed = 4,
.General_ShowAuxiliaryFunction = NULL,
.General_MenuItems = SettingsMenuItems,
.List_MenuArea = {0, 0, OLED_WIDTH, OLED_HEIGHT},
.List_IfDrawFrame = false,
.List_IfDrawLinePerfix = true,
.List_StartPointX = 4,
.List_StartPointY = 2
};
int main() {
// 初始化OLED和其他硬件
// ...
// 初始化OLED_UI
OLED_UI_Init(&MainMenuPage);
while(1) {
// 主循环
OLED_UI_MainLoop();
// 这里可以添加其他任务
// ...
}
}-
菜单项终止：每个菜单项数组的最后一个元素必须将
.General_item_text设为NULL，作为数组结束的标记。 -
菜单层级：确保正确设置
.General_ParentMenuPage，以便返回功能正常工作。 -
回调函数：回调函数应该保持简洁，避免在其中执行耗时操作，以免影响UI响应速度。
-
内存使用：如果在资源受限的设备上使用，请注意内存使用情况，避免定义过多或过大的菜单结构。
-
字符编码：确保代码文件使用正确的字符编码（UTF-8或GB2312），并在
OLED_Fonts.h中设置相应的OLED_CHN_CHAR_WIDTH宏。
通过以上步骤，您可以创建自己的OLED_UI菜单系统，实现各种交互界面。如果您需要更复杂的功能，可以参考示例代码中的其他实现方式。