跳到主要内容
版本：3.0 Beta 🧪

系统 API

概述​

系统 API 提供与 Matrix OS 系统交互的功能，如重启设备、打开设置菜单和旋转界面等。

此 API 的头文件是 os/MatrixOS.h 的一部分，实现位于 os/system/System.cpp。

MatrixOS::SYS::Millis​

uint32_t Millis(void);

返回设备启动后的毫秒数。可用于时间跟踪或延迟。

返回值：

  • uint32_t：自启动以来经过的毫秒数。

MatrixOS::SYS::DelayMs​

void DelayMs(uint32_t intervalMs);

暂停执行指定的时间。

参数：

  • intervalMs (uint32_t)：延迟的毫秒数。

MatrixOS::SYS::Reboot​

void Reboot(void);

重启设备。

MatrixOS::SYS::Bootloader​

void Bootloader(void);

将设备重启到引导加载程序模式。

MatrixOS::SYS::OpenSetting​

void OpenSetting(void);

打开 Matrix OS 设置菜单。

MatrixOS::SYS::Rotate​

void Rotate(EDirection rotation, bool absolute = false);

将界面或特定组件向给定方向旋转。

参数：

  • rotation (EDirection)：旋转方向。
  • absolute (bool，可选)：旋转是否应为绝对旋转（从顶部位置开始）。默认为 false。

MatrixOS::SYS::ExecuteAPP​

void ExecuteAPP(string author, string app_name);

启动指定的应用程序。

参数：

  • author (string)：应用程序的作者。
  • app_name (string)：应用程序的名称。

MatrixOS::SYS::ExitAPP​

void ExitAPP(void);

退出当前运行的应用程序并返回到应用程序启动器。

MatrixOS::SYS::ErrorHandler​

void ErrorHandler(string error = "");

处理错误并记录指定的错误消息。

参数：

  • error (string，可选)：要处理的错误消息。默认为空字符串。

Comments