用途
本技能适用于在 Roblox 中处理购买相关逻辑的场景,包括新增或变更 Game Pass、Developer Product、订阅、私人服务器,以及涉及 Creator Rewards 的产品决策和购买资格检查。
主要能力
- 区分客户端与服务端职责:购买提示可以由客户端发起,但权益授予必须由服务端拥有的代码完成。
- Game Pass:维护单一的服务端 ID→权益注册表,加入游戏与购买刷新复用同一条幂等的权益路径(见 full.md §2a)。
- Developer Product:作为可重复消耗品,通过服务端收据处理器授予,可使用 ProcessReceipt 或 BindReceiptHandler 配合 Enum.ReceiptType.DeveloperProduct;PromptProductPurchaseFinished 不是购买确认。
- 收据失败处理:失败收据保持 NotProcessedYet,重试行为取决于所选收据 API,而非自行设定的计时器。
- 资格与政策:对资格敏感的购买,检查 PolicyService 与 Roblox 当前指引;若适用付费随机物品限制,向用户提供文档给出的选项,例如可获得的奖励、已知的非随机序列或直接购买,不应默认隐藏或阻止功能,也不能因此停止无关工作。
- Creator Rewards:属于平台计划而非授予 API,其资格、归因、参与度与仪表板报告应与购买和库存分开追踪。
- 测试要点:覆盖失败或重复授予、玩家缺席以及保存被中断的情况。转账、订阅变更与动态定价的细节见 full.md。
使用方式
在需要添加 Game Pass、Developer Product、订阅、私人服务器,或进行 Creator Rewards 相关产品决策与购买资格检查时加载本技能。具体购买流程与失败处理细节可加载 references/full.md。
适用场景
- 新增或审计 Roblox 场景中的付费项目与权益授予。
- 检查收据处理器是否正确:不能仅凭其存在判断正确性,需检查其所有权、持久化幂等授予逻辑,以及对未知产品或玩家缺席情况的重试路径。
- 涉及购买资格、政策合规与 Creator Rewards 追踪的产品决策。
限制
未提供官方文档正文;具体实现细节需参考 references/full.md。重试机制依赖所选收据 API,不使用自创计时器。转账、订阅变更与动态定价仅在 full.md 中有说明,本简介未展开。