跳到主要内容

Snapchat Web Lenses

Snapchat Web Lens 是在 Snapchat 内以 Lens 形式运行的 Web 应用，在 iOS 和 Android 上全屏竖屏显示。本页介绍如何发布编辑器项目。代码项目请改用 Snapchat Web Lens 入门模板。

发布前，请根据 Snap 的平台要求和功能与限制检查游戏。尤其要注意，Lens 以竖屏运行，只能加载自身 ZIP 内的文件，因此项目不能从其他主机加载内容。

添加 Web Lens API​

Web Lens API 提供排行榜、玩家 Bitmoji 和可跨启动保留的存储。添加方法如下：

  1. 从 @snap/web-lens-api 包的 dist 文件夹下载 snap-api.js。
  2. 将其作为脚本资源上传到项目。
  3. 在资源检查器中，将 Loading Type 设为 Before Engine。

脚本会将 API 安装到 window.snapchat，因此应用启动时可调用 snapchat.init()，并在使用各功能前检查 snapchat.isSupported()。API 必须随 ZIP 一起分发，不要将其放在 Settings > External Scripts 中。在 Snapchat 之外，包括启动页中，API 会通过内置桩实现返回预设数据。

下载并打包构建​

  1. 从 Publish 对话框下载项目构建。
  2. 将构建文件夹中的内容打成 ZIP，确保 index.html 位于 ZIP 根目录，而非某个子文件夹内。在 Windows 上避免使用 PowerShell 的 Compress-Archive，因为它在 ZIP 中写入的反斜杠会破坏相对路径。
  3. 使用 unzip -l 检查 ZIP。总大小不得超过 8 MB，index.html 不得超过 1 MB。

上传到 Snapchat​

登录 My Lenses，创建新 Lens，选择 Web Lens，并上传 ZIP。图标、预览视频等信息及审核流程详见 Snap 的发布指南。