快速开始

本页只说明如何运行仓库自带的示例。

接入已有项目请看集成概览。

1. 发布 Avalonia Sample

先确认机器上安装了 .NET 10 SDK，然后在仓库根目录运行：

Windows win-x64：

dotnet publish ./src/BlenderAvaloniaBridge.Sample/BlenderAvaloniaBridge.Sample.csproj -c Release /p:PublishProfile=aot-win-x64 --configfile ./NuGet.Config

macOS osx-arm64：

dotnet publish ./src/BlenderAvaloniaBridge.Sample/BlenderAvaloniaBridge.Sample.csproj -c Release /p:PublishProfile=aot-osx-arm64 --configfile ./NuGet.Config

生成的 bridge 文件夹默认位于：

artifacts/publish/aot/win-x64/
artifacts/publish/aot/osx-arm64/

当前仓库提供的 AOT publish profile：

• aot-win-x64
• aot-osx-arm64

2. 在 Blender 中添加本地扩展仓库

打开 Blender 的扩展设置，使用 Add Local Repository 指向下面这个目录：

src\blender_extension

然后启用仓库里的 avalonia_bridge 扩展。

3. 在面板中指定 bridge 程序并启动

启用扩展后：

1. 打开 View3D > Sidebar > AvaloniaBridgeDemo
2. 在 Avalonia Executable 中选择刚刚发布出来的 bridge 程序的可执行文件
3. 按需调整 Display Size、Render Scaling 和 Target FPS。Display Size 是 Avalonia 逻辑尺寸；Render Scaling 控制渲染密度和 Blender overlay 显示倍率；Target FPS 默认是 120。
4. 点击 Start UI Bridge

如果一切正常，你会看到 sample UI 出现在 Blender overlay 中。

修改尺寸、倍率或目标帧率后需要重启 bridge。Diagnostics 面板会显示 frame cadence，以及 capture、transport、GPU upload、overlay draw 等阶段耗时。