用途:帮助开发者正确实现 Roblox 游戏通行证(一次性购买、赋予该体验内永久权限)。核心原则是:玩家未拥有时由客户端发起购买提示,实际权益只在服务端发放,并做幂等与错误处理。
主要能力与规则:通行证为一次性购买,Roblox 按用户按体验记录所有权;开发者产品则可重复购买,需服务端 ProcessReceipt。自 2026 年 5 月 30 日起,跨体验通行证与开发者产品销售已停用。权益交付由创作者全权负责,Roblox 只处理交易与 UserOwnsGamePassAsync 查询。
创建与资产 ID:Creator Dashboard → 已发布体验 → Monetization → Passes → Create a Pass,上传 ≤512×512 圆形友好图标;创建后复制 Asset ID 作为脚本中的 passID。如需在商店页外部销售,在 pass 的 Sales 中启用并设价。
关键用法:客户端用 pcall 调用 MarketplaceService:UserOwnsGamePassAsync 决定按钮状态,未拥有则 PromptGamePassPurchase(player, passID)。服务端在 PromptGamePassPurchaseFinished 回调或 PlayerAdded 复查时,用 pcall 调用 UserOwnsGamePassAsync 并派发权益,使用 granted 表做幂等保护,PlayerRemoving 时清理。动态 UI 价格用 GetProductInfoAsync(id, Enum.InfoType.GamePass),但不得据此发放权益。所有购买 API 需为场所启用 API Services(Studio 在 Game Settings → Security 开启),且体验需已发布。
个性化:RankProductsAsync(最多 50 个标识)与 RecommendTopProductsAsync 可返回个性化排序/推荐,建议仅在加入时各调用一次。还可通过仪表盘 Promotions 标签将通行证加入 Robux 购买页奖励池,需唯一通行证、促销价 50–800 Robux、有缩略图、符合社区标准、非付费随机物品。
分析与限制:仪表盘 Passes → Analytics 提供销量、净 Robux、时间序列与促销归因。安全要点:仅客户端提示、仅服务端发放;总是 pcall 查询与提示;每次会话重新校验所有权;自行用 DataStore 记录所有权与状态;UI 不硬编码价格;仅在专用测试体验测试购买;付费随机物品需先用 PolicyService 检查 ArePaidRandomItemsRestricted 与 IsPaidItemTradingAllowed;ProcessReceipt 全局只能赋值一次,成功后返回 PurchaseGranted,失败返回 NotProcessedYet。Robux 转账(PromptRobuxTransferAsync)仅限 Roblox Plus 订阅者从服务端发起,金额 10–500,发送者不得等于接收者,平台费 10%,需 BindReceiptHandler 处理,且滥用风险高。资料未提供具体价格、地区差异或其他未述功能。