Velix-MPV-Core/DOCS/CORE_API_VERSIONING.md

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。