文档

应用内购

IAP 客户端 API

IAP SDK API

Webshop Admin API

Webshop Client API

应用内购

Webshop 限制参考

查找适用于 Unity 网上商店的结构、命名、媒体和运行时限制。
阅读时间10 分钟最后更新于 3 个月前
本页面列出了适用于 Unity 网上商店的限制。如需了解这些限制约束的概念，请参阅网上商店简介、主题和品牌。

结构限制

以下限制适用于您可以创建的网上商店、环境和工作室的数量。

对象

--limit

注意

每个 Unity Cloud 项目的 Webshop1为同一项目创建第二个网上商店会返回冲突响应。
每个网上商店的环境25包括生产环境。
发布环境仅限生产非生产环境仅限草案；使用 Apply to production 可将非生产草案复制到生产中。
Studio 范围每个 Unity 组织一个首次创建网上商店时设置。可从组织设置中重命名，但不能在组织之间传输。

命名规则

以下规则适用于工作室名称、蛞蝓和其他标识符。

字段

规则

工作室名称：
^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$
（3–64 个字符；小写字母、数字和连字符；不能以连字符开头或结尾）。在 Unity 中全局唯一。
蛞蝓
^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$
（3–64 个字符；小写字母、数字和连字符；不能以连字符开头或结尾）。在工作室中是独一无二的。
Display name（显示名称）1–255 个字符。
深度链接最多 31 个字符（34 个字符带有尾随
://
），图案
^[a-z][a-z0-9+.\-]{0,30}(?:://)?$
（必须以小写字母开头；仅限小写字母、数字、
+
、
.
和 
-
）。Webshop 会拒绝 
javascript
、
data
、
vbscript
、
file
、
blob
和 
about
值。
深度链接最多 512 个字符。

媒体限制

Unity Dashboard（Unity 后台）支持以下网上商店的图像上传类型：
  • 英雄横幅：向网上商店中的玩家显示。
  • **缩略图：**向网上商店中的玩家显示。
  • 屏幕截图：用作 AI 主题生成的参考输入，不会显示在 Webshop 中。
所有图像上传类型都支持 PNG、JPEG 和 WebP 格式。Unity Dashboard（Unity 后台）在存储每次上传之前都会对其进行重新编码。

上传：

用途

最大文件大小

每个请求的文件

注意

英雄横幅显示在商店顶部5 MB1Dashboard 会将其重新编码为 1920 × 384 px (5:1) WebP。按此宽高比或更宽进行上传以避免裁剪。
缩略图在链接预览和链接卡片中使用1 MB1Dashboard 会将其重新编码为 48 × 48 px（方形）WebP。
截屏AI 主题生成的参考每个文件 2 MB每个请求最多 6 个未在商店中显示；仅用作主题生成器的附加输入。单个上传请求在所有截屏中总共最多可以包含 10 MB。

运行时限制

以下限制适用于实时流量和 API 调用。

值

--limit

注意

Dashboard preview-link 令牌自签发之日起 72 小时。开发预览 URL (
?token=
) 中的已签名令牌。为每个审查周期生成一个新链接。
SDK 草案预览链接从发布开始大约 1 小时。游戏解析草案时 Storefront-link 终端返回的短暂草案 URL。SDK 在每次启动时都会重新解析，因此玩家看不到短暂的生命周期。
玩家会话令牌短暂、一次性使用。受限制的玩家身份验证将标记游戏币（带有 
GenerateRestrictedTokenAsync
）并附加为开店的
sessionToken
。游戏会立即设置其生命周期和单次使用属性；未来 Unity SDK 方法将管理这些属性。商店会在浏览器中将其交换一次以作为玩家会话。请参阅将网上商店集成到 Unity 游戏中。
玩家 ID 令牌1 小时，自动刷新。网上商店会在玩家 ID 令牌到期前不久刷新该令牌，因此玩家不会在会话中途重新进行身份验证。
玩家会话无固定到期时间。玩家会话保持有效，直到服务器将其撤销。Webshop 会将其保留在浏览器中（在 Live Shop 上
localStorage
，在 Dashboard 预览路径上
sessionStorage
），范围为项目和环境。
Admin API 速率限制每个源 IP 每秒 40 个请求。适用于每个内部 API 调用（后台请求、服务帐户编程调用）。超出限制的突发自动化会
429 Too Many Requests
。
玩家目录请求速率限制每分钟 600 个请求（玩家、项目、环境），每个 IP 备份每秒 20 个请求，每分钟 300 个请求。应用于播放器前端的运行时目录获取。这两个限制叠加在一起，因此单个行为不当的玩家无法用尽 IP 的允许数量。
Player shell 流量不受服务速率限制。商店的 HTML shell 和媒体由内容交付网络提供，绝不会进入 Dashboard 服务。

访问和可见性

网上商店将上传的媒体和开发预览链接作为公共 Web 内容提供，就像内容交付网络提供任何静态资源一样。拥有 URL 的任何人都可以在不登录的情况下打开它们。URL 使用不可猜测的标识符，并且未与商店关联，因此不容易发现，但它们也不受访问控制。选择要上传的内容以及与谁共享预览链接时，请记住这一点。

Resource

谁可以访问

注意

开发预览 URL拥有链接的任何人，直到令牌到期Webshop 以 
/_preview/{publisher}/game/{slug}
路径提供预览，并在 URL（
token
查询参数）中使用经过签名的限时令牌进行授权。渲染使用匿名会话，因此没有登录或每用户检查 — 令牌是唯一保护链接的方法。与您共享的任何人都可以查看草案，直到令牌到期（72 小时）。为每个审查周期生成一个新链接。
上传的媒体（英雄横幅、缩略图、屏幕截图）拥有 URL 的任何人上传的媒体将重新编码到 WebP 中，并作为公共对象存储在通过内容交付网络在商店
_media/
路径（例如 
https://shop.unity.com/_media/{projectId}/branding/logo.webp
）中提供的云存储桶中。没有针对每个请求的身份验证，并且公开缓存对象。品牌文件使用固定名称，截屏使用内容哈希名称，因此路径中的项目 ID 是唯一无法猜测的部分，任何拥有 URL 的人都可以打开文件。将上传的媒体视为公开可见。

AI 主题生成

以下值适用于 AI 主题生成。

Detail

当前值

用于生成主题的模型大型语言模型（随着可用模型的改进，可能会发生变化）。
生成输入的来源列出您提供的 URL、上传的截屏或两者的 Apple App Store。Dashboard（后台）会为其图标、屏幕截图和调色板抓取提供的列表。
主题生成速率限制每个项目的速率限制作为滥用保障。此限制设置远高于正常的交互式使用（以 Dashboard 允许的速度生成和优化主题不会达到此限制），因此只会在失控的自动化中跳闸。超过此值的请求返回 
429 Too Many Requests
。
主题生成预算每个项目的每日和每周主题生成支出上限。当项目达到上限时，在窗口重置之前会阻止进一步生成。每个项目都会跟踪上限，不会通过删除和重新创建网上商店来重置上限。
有关使用此生成器的面向用户的过程，请参阅生成 AI 网上商店主题。