「安卓原生3D开源渲染引擎」Sceneform‑EQR：我的开源进化之路

Ne0inhk

— 10 min read
「安卓原生3D开源渲染引擎」Sceneform‑EQR：我的开源进化之路
在这里插入图片描述

Sceneform‑EQR：我的开源进化之路

“那一夜凌晨 3 点，第一次提交 PR 的手在抖……”
—— 那是我第一次把代码推向世界，也是我真正开始与开源世界对话的起点。

文章目录

一、起点：一次“救火”式的开源尝试

2020 年，Google 官方宣布 sceneform-android-sdk 归档。对很多 Android 3D/AR 开发者来说，这是一次技术断崖。

在这里插入图片描述

而我，当时正是一名“AR + GIS”的一线开发人员，Sceneform 是我们业务中与 ARCore 深度结合的核心模块。SDK 突然停摆，不只是“无法更新”，更是直接影响业务连续性。

起初，我只是“临时救火”：Fork 一份仓库，想办法让它多撑一阵子。但这个“应急操作”很快演变成一次深入的技术探索——我开始学习Filament、尝试接入华为 AREngine、调试场景渲染 bug，逐步把 Sceneform 从“被遗弃的代码”转变为“可维护、可拓展的系统”。

也正是在这个过程中，我意识到：

这不是在修复一个 SDK，而是在建造一座属于中国开发者自己的 3D 渲染桥梁。

二、一段接力：从谷歌到社区，再到我

1、SceneView/sceneform-android

谷歌 Sceneform 被归档后，社区的开发者们并未放弃这条技术线。

开发者 ThomasGorisse 接过了第一棒，基于原始 SDK 构建并维护了 SceneView sceneform-android，为社区延续了 Sceneform 的生命。

在这里插入图片描述

但在 2023 年之后，这条线也停止了维护。

在这里插入图片描述

2、EQ-Renderer

在ThomasGorisse的仓库不再维护Java接口的Sceneform之后，我开始维护一个私有的仓库，初次命名为“EQ-Renderer”，意为“EQ的渲染器”。

主要内容是基于谷歌存档的Sceneform-android-sdk，接入了ThomasGorisse对Sceneform的一些修改。并解决了gltf模型加载内存泄漏问题，接入了AREngine，解决了由于颜色映射异常导致的View颜色显示不正确的问题。

repo截图：

在这里插入图片描述


版本记录：

在这里插入图片描述

3、Sceneform‑EQR

2024年初，我开源了自己的本地库“EQ-Renderer”，并重命名为“Sceneform‑EQR”。

在这里插入图片描述

EQR = Extended, Quick, Rewired

一套为新场景而生、快速适配、重新连接生态的安卓原生 3D 渲染引擎。

这是我第一次在社区独立维护一个依赖库——我不是在“造轮子”，而是在“守火种”。

尽管文档不完善，也没有做任何推广，仅是随缘挂着，但总会有一线研发人员私信我，请教适配问题或请求 SDK 支持。

这些沟通、答复与调试，都是出于对 Sceneform 的热爱——
哪怕只有一个人用着，它也值得被延续。

在这里插入图片描述

三、如今的 Sceneform‑EQR

至今，我一直以个人开发者身份维护这份代码。

不再有业务束缚，我可以真正从架构层重构它：

  • 翻译 Sceneform 源码，增补注释；
  • 剔除已弃用的接口；
  • 理解 Filament 材质调用流程；
  • 深入安卓与底层渲染接口的适配逻辑；
  • 尝试更多的可能，扩展新功能；

我把它当作一次学习机会，一个可以实践所有三维原生图形想法的场所。

Sceneform‑EQR 是 EQ（EQ-雪梨蛋花汤） 对谷歌 sceneform-android-sdk 的扩展，适用于图形与视频、增强现实（AR）和虚拟现实（VR）相关领域。
它集成了 ARCore、AREngine 和 ORB-SLAM，支持普通场景、AR 场景、VR 场景以及自定义背景场景，以满足多端多样的原生三维开发需求。

1、GitHub & GitCode 双平台同步

2025 年 7 月，为方便国内开发者访问，项目实现了：

GitHub ⇌ GitCode 双向同步

从此，国内外开发者都能顺畅访问与协作，社区建设进一步推进。
在这里插入图片描述

四、难关与成长：从内存泄漏到动态材质

1、内存泄漏的破冰之战

2022年3月左右开发“AR + GIS SDK”时，我们发现一个致命问题：

3D模型多次加载与释放，会导致内存泄漏，最终崩溃。
在这里插入图片描述

我反复比对日志、查阅源码，最终通过社区开发者 steven-gao 的一段代码找到了突破口。

以下是问题解决后，内存正常释放的监控截图

这项修复被我合入 Sceneform‑EQR 本地库，在社区伙伴遇到类似问题时，我也积极帮助。 Issue#424

前车之覆，后车之鉴。这是我从“使用者”转变为“参与者”的分水岭。

2、材质探索：复刻 AR 涂鸦的全过程

2023 年底，一位朋友拿来三星手机，展示了其 AR 涂鸦功能：“你能实现吗？”

功能包括：

  • 文本与图片的涂鸦；
  • 3D 自由线条绘制；
  • 流动、透明、呼吸等视觉材质。

我查阅 Filament 的材质文档，使用 matc 工具自编 .mat 文件：

  • 支持动态图、视频纹理注入；
  • 搭配 Sceneform 节点系统，实现交互绘制；
  • 自研材质支持透明通道、UV 位移、实时变色；

这项功能虽未正式商用，但成为我深入理解 Filament 材质使用流程的重要跳板。
👉 【Sceneform-EQR】在安卓中使用filament(sceneform)材质(一)
👉 【Sceneform-EQR】在安卓中使用filament(sceneform)材质(二)

部分效果图如下：

在这里插入图片描述


在这里插入图片描述

3、OST AR 眼镜项目：眼镜上的 Launcher 实战

在这里插入图片描述

2023年底，在深圳的FBEC会上，认识的新朋友希望用原生方式实现 眼镜 Launcher 应用。

我发现 Sceneform‑EQR 具备极佳的适配潜力：

  • 原生 AR 渲染体验；
  • 支持 ARCore / AREngine 双平台统一；
  • 适配单双屏、XR 显示模式；

最终成功打造出一个可部署到 AR 眼镜的 Launcher 原型。
👉 文档：【Sceneform-EQR】使用EQ-Renderer实现AR桌面

支持ARCore的平板上显示效果：

在这里插入图片描述


眼镜端左右双屏显示效果：

在这里插入图片描述

五、项目现状：生态建设持续进化中

1. 项目地址

2. 项目结构

  • Eq‑Renderer 渲染库：
    • Android/eq‑renderer：主要源码；
  • 示例工程 SampleProj/app：Demo 程序；
  • Maven 本地依赖发布：
maven { allowInsecureProtocol true url "http://repo.eqgis.cn" } implementation "com.eqgis:eq‑renderer:1.0.9"

3. 核心功能模块

  • 场景加载：支持 glTF 模型加载（普通场景、AR/VR 场景均可）(github.com)；
  • 动画支持：封装 ModelAnimation，自动播放、设置时长、循环，接入 FilamentAnimator；
  • XR 支持：支持AR、VR、普通3D场景。集成 ARCore、AREngine、ORB‑SLAM3，支持场景间一键切换；
  • 背景扩展：支持透明背景、图片背景、视频背景，特点是灵活配置、流程简洁 (blog.ZEEKLOG.net)；
  • 材质扩展：调用 matc 生成材质，实现呼吸、流动纹理、视频贴图等；
  • 手势交互：单指旋转、双指平移/缩放、点击事件等基本场景交互内置；(blog.ZEEKLOG.net)；

4. 核心功能截图

  • 案例：AR桌面

通过手势控制模型（单指旋转、双指平移、双指缩放）

在这里插入图片描述

手势点击交互

在这里插入图片描述

支持GLTF模型动画

在这里插入图片描述

在AR场景加载GLTF格式的模型

在这里插入图片描述

在普通3d场景加载GLTF格式的模型

在这里插入图片描述
通过渲染安卓原生View实现
  • 支持双屏显示，常用于XR眼镜
曾用于团队定制的的AR眼镜，实现原生安卓Launcher（支持3DOF|6DOF切换）
  • 案例：AR涂鸦（自定义纹理、流动纹理、视频纹理、移位贴图）
呼吸效果，通过Filament的matc工具编译自定义材质文件

流动纹理，使用视频资源作为纹理贴图

六、写在最后：开源是信仰，更是修行

开源的起点，是热爱；中途，是孤独；坚持，是信仰。

从谷歌 Sceneform 被弃，到我多次凌晨提交代码。
从一人维护，到今日支持多设备适配与社区反馈。

Sceneform‑EQR 不只是一个技术项目，
它也是我技术成长、自我构建、走向开源世界的旅程。

“用不用在你，做与不做在我。”

这句话，我写给自己，也写给每一个仍在热爱技术的你。

愿每一个在深夜为 PR 苦战的人，
都能看到属于自己的光，也成为别人的光。

如果你也有想法、有热情，欢迎加入共建。

📫 交流地址：GitCode Issues

EQ-雪梨蛋花汤

Read more

告别 Copilot 时代：Cursor, Kiro 与 Google Antigravity 如何重新定义编程？

如果说 GitHub Copilot 开启了 AI 辅助编程的“副驾驶”时代，那么 2024-2025 年则是 AI Agent（智能体） 全面接管 IDE 的元年。 现在的开发者不再满足于简单的代码补全，我们需要的是能理解整个项目架构、能自主规划任务、甚至能像真人同事一样工作的“编程搭子”。 今天，我们盘点三款目前最受瞩目、处于风口浪尖的 AI 编程工具：Cursor、Kiro 以及 Google 的重磅新品 Antigravity。无论你是想提升效率，还是想尝鲜最前沿的 Agentic Workflow，这三款神器都不容错过。 1. Cursor：当下体验最好的 AI 代码编辑器 定位：目前最成熟、最流畅的 VS Code 替代者 Cursor

By Ne0inhk

AI绘画报错

提示输出验证失败：CheckpointLoaderSimple: - 值不在列表中：ckpt_name: 'v1-5-pruned-emaonly-fp16.safetensors' 不在 ['anything-v5-PrtRE.safetensors'] 中 模型文件夹里面没模型 这是官方链接：v1-5-pruned-emaonly.safetensors https://huggingface.co/runwayml/stable-diffusion-v1-5/tree/main 点击同一行的小下载箭头。然后把文件放在：models/checkpoints文件夹里 你还需要标准的VAE文件，也就是：vae-ft-mse-840000-ema-pruned.safetensors https://huggingface.co/stabilityai/sd-vae-ft-mse-original/tree/main 这个文件放在：models/vae文件夹里 现在你已经拥有运行所需的一切了。慢慢来。你最初生成的图片会很糟糕。但是继续尝试，很快你就能得到很棒的结果。

By Ne0inhk
我用Openclaw + Claude搭了一套自动写作系统，每天省3小时

我用Openclaw + Claude搭了一套自动写作系统，每天省3小时

这是我目前最重要的一套AI工作流。从信息获取到发布，几乎不用手动完成。 一、为什么我要搭建这套系统？ 信息过载的困境 如果你也在持续关注AI，应该会有同样的感受： 信息太多了。 每天打开 X、公众号、GitHub、技术社区，都会冒出大量新内容。 AI模型更新、工具更新、Agent框架、自动化方案…… 想跟上这些信息，本身就已经是一项工作。 手动写作的低效循环 更别说： * 整理信息 * 找选题 * 写文章 * 配图 * 发布到各个平台 如果全部手动完成，写作就会变成一件非常消耗精力的事。 我一度也在这种状态里： 想持续输出，但写作本身占用了太多时间。 一个关键问题 后来我开始思考一个问题： 如果写作这件事可以被"系统化"，会发生什么? 于是，我不再把AI当成写作工具。 而是开始搭一套完整的 AI写作工作流。 二、思路转变：从优化写作到优化流程 大多数人的AI写作方式 大多数人使用AI写作，是这样：

By Ne0inhk
实现GitHub和Google第三方登录

实现GitHub和Google第三方登录

第三方登录流程图如下： 一、在第三方平台创建OAuth GitHub： 1.登录GitHub ➡ 右上角个人设置 ➡ 开发者设置 2.OAuth Apps  ➡ 右上角创建新OAuth应用  ➡ 重点填写Authorization callback URL； Authorization callback URL为流程图中第七步第三方code和state返回的路径，后续前端用于获取系统服务端token GitHub的Authorization callback URL返回路径没有具体要求，填什么地址，code和state就返到对应的页面 Enable Device Flow(是否启动设备流)： 如无法使用web形式授权输入邮箱密码登录，启动设备流可通过其他设备扫码等形式完成授权登录 3.保存Client ID和Client secrets Google： 1.登录https://console.cloud.google.com ➡ New project ➡ 测试项目信息可随意填写 2. APIs & Services ➡ Credentia

By Ne0inhk