# Core API versioning

当前冻结版本：`VELIX_CORE_API_VERSION = 0x000100`（v0）。

- `MAJOR` 变化表示 ABI/API 不兼容，必须升级主 App 适配层。
- `MINOR` 变化只增加尾部字段或能力，旧调用方保持可用。
- `PATCH` 变化只修复实现，不改变公开结构布局。

版本宏、`velix_core_get_api_version()`、`velix_core_get_version()` 和 `velix_core_get_build_info()` 位于 `include/velix/core.h`，C ABI 使用 opaque handle 与固定宽度整数。变更 API 时同步更新 `metadata/build-info.json`、此文档与集成文档，并在发布前检查动态符号。

v0 不把 `mpv_handle`、`mpv_node`、FFmpeg、OHCodec、EGL、OHAudio 或 OHNativeWindow 类型带出 SDK。