跳到主内容
快讯直播
AI智模界
教程

用编码智能体做 Snapchat AR Lens 并上线

适用场景

想给品牌活动、线下门店或社交内容做一个 Snapchat AR Lens,但团队里没有专职的 AR 开发者;或者你是前端、客户端工程师,愿意用 Claude Code、Cursor 这类编码智能体来写 Lens 脚本、整理素材清单、生成提交材料。这套流程解决的问题是:一个人如何把想法一路推进到 Snapchat 审核通过并上线。分工上,智能体负责写代码和文档,Lens Studio 负责渲染与打包,官方审核链路负责上线。

环境与前置条件

  • 操作系统:Lens Studio 提供 Windows 与 macOS 桌面版,对系统版本、显卡的具体要求以官方文档当前版本为准。AR 是实时渲染,建议用带独立显卡的机器;集成显卡能跑通简单 Lens,但预览容易掉帧。
  • 磁盘与内存:Lens Studio 本体加上工程缓存、素材包,建议预留几十 GB 可用空间;单个 Lens 工程通常在几十到几百 MB 之间,取决于贴图与模型体积。运行时建议内存 16 GB 起步,低于这个值编辑器会频繁卡顿。
  • 账号:一个可正常登录的 Snapchat 账号。提交审核需要在 Lens Studio 内登录并关联该账号;如果要发布到品牌账号,提前确认账号归属和权限。
  • 编码智能体:Claude Code(命令行)或 Cursor(编辑器)任一即可。两者都只需要能读写本地工程目录,不需要额外插件。
  • 版本控制:Git 可用。Lens Studio 工程是文件夹结构,适合纳入 Git;编辑器生成的缓存与临时目录写进 .gitignore,具体目录名以你本机工程结构为准。
  • 知识门槛:能看懂 JavaScript、理解"组件 + 事件"的概念即可。Lens 脚本以 JavaScript 语法为主,较新版本也支持 TypeScript 工程,具体支持情况以官方文档为准。

分步骤部署

第 1 步:安装 Lens Studio 并登录账号

从 Snap 官方开发者站点下载 Lens Studio 桌面版并安装(下载地址与版本以官方页面为准),启动后用 Snapchat 账号登录。

成功标志:主界面能看到新建工程入口与模板库,右上角显示你的账号头像。同时把手机上的 Snapchat 更新到应用商店当前版本,并登录同一账号——真机预览要靠它。

第 2 步:新建工程,摸清目录结构

在 Lens Studio 里用空白模板新建一个工程,保存到本地路径,例如 ~/lens-projects/coffee-cup-demo。然后最小化 Lens Studio,用文件管理器看一眼工程目录。

典型结构大致是 Assets/ 下放脚本、贴图、材质、预制体,根目录放场景文件与工程配置。不同版本目录名可能有差异,以你本机看到的为准。这一步的目的不是背目录,而是划清边界:智能体只需要读写 Assets/ 下的脚本与素材。

第 3 步:给智能体写一份"工程说明书"

这是整条链路里回报很高的一步。在工程根目录新建 CLAUDE.md(Claude Code 读取的约定文件;部分版本也识别 AGENTS.md,以官方说明为准),同时给 Cursor 配置 .cursor/rules 下的规则文件。内容示例:

```markdown

工程约定

  • 这是 Snapchat Lens Studio 工程,脚本目录:Assets/Scripts
  • Lens 脚本使用 JavaScript 语法,禁止使用 Node.js API(无 fs、无 fetch、不引入第三方 npm 包)
  • 只允许使用 Lens Studio 官方内置模块;不确定的 API 必须先问我,不要臆造
  • 所有脚本必须导出为可挂载到 Scene Object 的 Script Component
  • 事件监听使用官方提供的事件对象,不要自造生命周期名
  • 变量命名用 camelCase,注释用中文
  • 不要修改 Assets 以外的任何文件

```

关键那一句是"不许臆造 API"。编码智能体对 Snap AR 接口的记忆远不如对 React、Vue 那么准,这条约束能省掉大量返工。

第 4 步:把官方 API 参考喂进工程

从官方文档把你需要的模块示例代码或类型定义复制到本地,放到工程外的 docs/lens-api-notes.md(不要放进会被打包的脚本目录)。通常需要覆盖:脚本生命周期、变换与父子节点、输入与手势、摄像头纹理、2D/3D 文本、材质与渲染、音频播放。

然后在提示词里明确指向它:

```text

参考 docs/lens-api-notes.md 里我摘录的 API,

在 Assets/Scripts 下新建 tapToSpawn.js:

点击屏幕时,在点击位置生成一个预制的 3D 咖啡杯,

最多同时存在 5 个,超出时移除最早创建的那个。

不要引入任何文档里没有出现的 API。

```

成功标志:智能体生成的脚本里,每一处函数调用都能在你摘录的文档中找到对应项。

第 5 步:让智能体逐个写 Lens 逻辑

把需求拆小,一次只写一个脚本。几个可复用的提示词骨架:

  • 交互类:"写一个 dragRotate.js,手指水平拖动按角度旋转目标对象,垂直拖动缩放,缩放限制在 0.5–2.0。"
  • 状态类:"写一个 countdown.js,进入 Lens 后开始 15 秒倒计时,UI 文本每秒刷新,结束时触发自定义事件。"
  • 追踪类:"写一个 headAnchor.js,读取人脸追踪结果,把 3D 帽子挂到头顶位置,并做平滑插值避免抖动。"

每次生成后回到 Lens Studio,把脚本拖到对应的 Scene Object 上,在 Inspector 里确认脚本出现在 Script Components 列表中且没有红色报错。Logger 面板会实时打印 print() 输出,用它做第一层验证。

第 6 步:准备素材

素材有三条来源:

1. Lens Studio 内置的 Asset Library,是官方提供的模型、材质、特效库,授权范围以官方说明为准;

2. 自己用 3D 工具导出 glTF 或 OBJ,贴图分辨率控制在移动端实际需要的量级,通常 1K–2K 足够;

3. 用生成式工具产出贴图草稿或图标,再人工修正。

让智能体帮你出一份素材清单:

```text

根据 docs/lens-api-notes.md 和 Assets/Scripts 下已有脚本,

列出这个 Lens 需要的全部素材:类型、用途、建议尺寸、放在 Assets 的哪个子目录。

输出成表格。

```

注意:AI 生成的图片、音效、字体,商用授权与平台审核政策要逐项确认。带入未授权的音乐或第三方 logo,是最常见的拒审原因之一。

第 7 步:真机预览

先在 Lens Studio 内点预览跑一遍编辑器预览,再用 Preview in Snapchat(或生成 Snapcode 扫码)在手机上打开。

成功标志:手机上能看到你的 Lens,交互、音频、追踪都正常,帧率稳定不卡顿。这一步暴露的问题多与性能和追踪稳定性有关。把现象连同 Logger 输出一起贴给智能体,例如"人脸离开画面再回来,帽子位置漂移",让它给出修复方案,再回到第 5 步的循环。

第 8 步:提交审核

在 Lens Studio 内走发布/提交(Publish / Submit)流程,登录账号后按向导填写:

  • Lens 名称、描述、分类;
  • 图标与预览视频(尺寸、时长、格式以官方提交页面的提示为准);
  • 使用的追踪类型、摄像头权限说明;
  • 素材来源与版权声明。

提交后进入审核队列,审核时长与结果以官方通知为准。被拒时会给出理由,按理由改完再重新提交,不要绕过问题反复提交。

验证部署是否成功

按下面几条逐项检查,全部通过再提交:

1. 工程无编译错误:Logger 面板不出现红色 Error,脚本编辑器无红色波浪线。

2. 脚本已正确挂载:选中目标 Scene Object,Inspector 的 Script Components 里有对应脚本,且输入项(对象、材质、文本)都已赋值,没有留空的 None。

3. 编辑器内预览通过:点 Play 后交互按预期触发,print() 输出与预期一致。

4. 真机预览通过:手机扫码打开后连续使用 1–2 分钟不崩溃、不卡顿;切换前后摄像头、遮挡摄像头再恢复都正常。

5. 素材合规自查:逐项核对每张贴图、每段音频的来源与授权,确认没有第三方商标、未授权音乐、可识别人物肖像。

6. 提交表单完整:名称、图标、预览视频、描述、权限说明均已填写,预览视频内容与实际 Lens 一致。

常见报错与解决

报错:Cannot find module 'xxx',或脚本里某个 API 运行时报 undefined

→ 原因:智能体凭记忆写了一个当前版本不存在的模块名或函数名。

→ 解决:删掉该调用,改用手头版本官方文档中确实存在的 API;把官方示例补进 docs/lens-api-notes.md,并在 CLAUDE.md 里重申"只使用参考文件中出现的 API"。改完回到 Lens Studio 重新编译,确认 Logger 无红色报错:

```bash

提交前先看一眼改动范围,避免智能体误改素材目录

git status

git diff -- Assets/Scripts

```

报错:脚本挂到对象上后毫无反应,print() 也不输出

→ 原因:脚本没有正确导出为 Script Component,或生命周期回调名写错了(例如写成 React 风格的 useEffect)。

→ 解决:检查脚本末尾是否有官方的导出语句;对照文档确认初始化与逐帧更新回调的正确写法;把脚本从对象上移除后重新拖入,确认 Inspector 中出现可勾选的启用状态。

报错:Preview in Snapchat 打不开,或扫码后一直转圈

→ 原因:手机与电脑不在同一网络、Lens Studio 未登录、Snapchat 客户端版本过旧,或工程本身在真机上崩溃。

→ 解决:确认两端登录同一账号、网络互通;把 Snapchat 更新到应用商店当前版本;先在编辑器内预览确认不崩溃;仍失败时改用官方支持的本地推送方式,具体操作以官方文档为准。

报错:提交审核被拒,理由指向素材版权或品牌元素

→ 原因:使用了未授权的音乐、字体、第三方 logo 或可识别人物肖像。

→ 解决:逐项替换为自有素材或 Asset Library 中授权明确的素材,保留授权凭证;在提交说明里写清素材来源;改完重新提交。

报错:真机上帧率明显下降、设备发热严重

→ 原因:贴图分辨率过高、模型面数过多,或每帧都在做重计算(每帧新建对象、每帧遍历大量节点)。

→ 解决:把贴图降到实际显示尺寸所需的分辨率,合并材质减少 draw call,把重计算从逐帧执行改为事件触发时执行。可以让智能体专门做一轮性能审查,提示词写:"逐行检查 Assets/Scripts 下的脚本,指出所有每帧执行的循环和对象创建,给出优化后的代码。"

后续维护

  • 备份与版本控制:工程根目录纳入 Git,每次提交审核前打一个 tag(如 v1-submit),方便对比"过审版本"与"当前版本"的差异。素材大文件用 Git LFS,编辑器缓存目录写进 .gitignore。
  • 升级策略:Lens Studio 升级后,先在副本上打开旧工程做一次完整真机预览,确认脚本 API 与材质没有失效再继续开发;不要在正在迭代的工程上直接试新版本。同时更新 docs/lens-api-notes.md,把废弃 API 删掉,避免智能体继续照着旧文档写代码。
  • 日志:开发期靠 print() 加 Logger 面板;上线后依赖官方后台提供的 Lens 数据看板查看使用量、留存等指标,具体指标口径以官方页面为准。
  • 迭代节奏:每次更新只改一个变量(这版只调交互手感,下版只换素材),出问题时更容易定位是脚本还是资产导致的。
  • 交接归档:品牌账号所有权、审核联系人、素材授权凭证统一归档,避免人员变动后无法再次提交更新。

AI 生成本文由 AI 基于公开信息自动生成,仅供参考。