Skip to content

API Reference zh

3cxc edited this page Sep 13, 2026 · 1 revision

API 参考

NativePluginKit 暴露以下命名空间:

命名空间 说明
NativePluginKit.Features 功能模块:Log, Transition, Scene, Config, Timing, Story, Card, Entity, EventBus, Strings
NativePluginKit.Events 事件类型, 事件载荷, EventDispatcher (宿主侧)
NativePluginKit.Features.Wrappers EntityId, ObjectIdNative, 强类型枚举
NativePluginKit.Loader PluginLoader
NativePluginKit.Loader.Constants HostApiTable, HostApiBridgeBuilder, HostApiAttribute, PluginInfo
NativePluginKit.Loader.Plugins Plugin, PluginContext

核心约定

  • 所有 API 必须在主线程调用
  • 所有字符串均为 UTF-8 宿主分配,插件读取后调用 Strings.Free 释放
  • 所有返回的字符串必须释放 —— 生成的 API 内部会自动处理
  • 所有事件载荷都是可 blittable 的结构体 —— 不包含托管引用
  • 枚举在原始 ABI 中以 int 传递 强类型访问器由 *.Manual.cs 扩展类提供

Clone this wiki locally