实时时钟外设。通过场景组件读写实际时间,后端为 DS3231(I²C)。
仓库:github.com/dekiengine/deki-rtc · 最新版本:0.19.0 · 需要引擎 0.19.0 或更高版本 · 依赖:deki-i2c
使用 DekiEditor --packages-add deki-rtc <project> 或通过包管理器安装。引擎自身的组件和 C++ API 见 Deki 文档。
在编辑器中显示为 **RTC (Real-Time Clock)**。
组件
功能开关
可以从构建中去掉的部分。带有 define 的功能通过该 define 开关,其余的随其组件一起被剥离。
| 功能 | define | 默认值 |
| DS3231 (I²C) | DEKI_FEATURE_RTC_DS3231 | 开 |
组件参考
DS3231RTCComponent
通过 I2C 读取和设置 DS3231 实时时钟。
检视器中的名称:DS3231 RTC · 类别:传感器 · 类型:DekiRtc::DS3231RTCComponent
| 属性 | 类型 | 默认值 | 约束 | 说明 |
| i2cPort | int32 | 0 | 0 到 3 | 时钟芯片所在的 I2C 总线。必须与设置该端口的 I2C 总线组件一致。 |
SystemClockRTCComponent
使用计算机自身的时钟作为实时时钟,用于在编辑器和桌面上运行时。
检视器中的名称:系统时钟 RTC · 类别:系统 · 类型:DekiRtc::SystemClockRTCComponent
没有反射的属性。
更新日志
更新日志为英文。
0.19.0
Changed
- minEngine 0.19.0: built against engine 0.19.0, whose component metadata records the package each class is in. A build of this package from before does not load and is rebuilt.
Added
- Japanese, Simplified Chinese and Korean: editor/lang/ja.json, zh.json and ko.json translate the names, tooltips and enum values this package's components show in the Inspector.
0.18.0
Changed
- minEngine 0.18.0. Reflection ABI 21: the package must be rebuilt.
- Names follow the code style (deki-engine/docs/codestyle): types, functions and enum values are PascalCase, constants kPascalCase, members m_PascalCase, locals and parameters camelCase. The code is formatted with clang-format 22.
- The functions the editor finds by name are PascalCase: DekiRTCRegisterComponents, DekiRTCGetAutoComponentCount, DekiRTCEnsureRegistered and the rest. Built against engine ABI 21; a build of this package from before does not load and is rebuilt.
Removed
- The former names from before 0.16.0 (bare class names, and deki-gpio's DekiEsp32::ESP32PinSetup). A scene that old is upgraded with 0.17 first.
更早的版本:CHANGELOG.md
由包的反射数据生成(引擎 0.19.0)。属性名就是场景文件中使用的键。重命名后会保留别名(兼容性)。