接口参考¶
Pier 的接口按四个绑定分别列出。
| 绑定 | 引用方式 | 函数和方法 | 类型 | 常量 |
|---|---|---|---|---|
| Rust | use levilamina::... |
792 | 117 | 76 |
| Go | import "github.com/Maskviva/pier/bindings/go/levilamina" |
628 | 62 | 316 |
| Zig | @import("levilamina") |
305 | 23 | 3 |
| C++ | #include "sdk/abi.h" |
207 | 42 | 323 |
C++ 一行的函数数是 abi.h 的 201 个槽位加上 6 个宏。
一个条目怎么读¶
- 标题:接口的名字。方法写成
类型::方法(Rust)或类型.方法(Go、Zig)。 - 声明:源码里的签名,原样照抄。
- 说明:源码里写在它上面的文档注释。
- 参数、返回值类型:从签名里拆出来。
- 对应槽位:这个接口最终调用的 abi.h 槽位,链接到 C++ 页上那个槽位的条目,那里写着宿主怎么处理这次调用。
- 已弃用:标着弃用的接口在标题下面有一个提示框,写着从哪个版本起弃用、改用什么。
「对应槽位」列的是这个接口在源码里追得到的 abi.h 槽位:函数体里直接写到的,加上经同一类型的其他方法、带类型名的调用和同一文件里的函数间接调到的,最多四层。经未标注类型的变量调用的槽位列不出来;列出的每个槽位在源码里都有调用路径。
按场景找¶
想先看一件事怎么做,比如订阅事件、注册命令、读写玩家属性,请看教程里的常见任务,每个场景都有三种语言的示例。