入门

概述

OZero Security 通过在一般黑客工具难以访问的 Native C++ 层执行安全逻辑来保护 Unity 游戏。只需在 Unity 编辑器内的仪表板中激活模块，即可运行核心保护功能。无需场景设置或编写额外代码。

1 导入包

打开 Unity 编辑器并导入 OZero Security 包。您可以通过 Unity 包管理器或双击 .unitypackage 文件进行导入。

当出现 Import Unity Package 对话框时，在勾选所有项目的情况下点击 Import。所需的脚本、原生插件和编辑器工具将自动添加。

Welcome 窗口

导入 OZero SDK 包后，Welcome 窗口（Window > OZero Security > Welcome）会自动打开。每次导入 OZero SDK 包（即使再次导入相同版本）都会打开，新 SDK 版本首次加载时也会打开。导入 Built-in TMP 对话框包或 TMP 资源时不会打开。

窗口顶部有一张大卡片 STEP 1 · Run Setup。点击 Start setup 会打开 Check Setup，列出项目仍需的设置，Auto Setup 会在每次修改前确认后再应用。下方是两张在设置完成后使用的卡片。Read the Manual 中有 Online（OZero 网站手册）和 Offline（包内附带的 HTML 手册，Assets/OZeroSecurity/Documentation/HTML/index.html）按钮，若没有附带手册，Offline 按钮将不可用。Security Config（Open config）会打开 Edit > Project Settings > OZero Security，以便在设置完成后更改预设或单项保护功能。

安装了附加组件的项目中还会显示 Online Services 行。点击 Open 会打开 Window > OZero Security > Online Services 窗口（如设置不存在则创建）。

安装了附加组件时，Offline 按钮会打开附加组件附带的手册（Assets/OZeroSecurity/Online/Documentation/HTML/index.html）。

勾选 Don't show this window automatically again 后，此项目中将不再自动打开，但仍可随时通过菜单打开。在 batch 模式下或设置了 OZERO_SUPPRESS_WELCOME 环境变量时不会打开，因此不会中断 CI 和自动构建。

2 打开仪表板

导入完成后，从 Unity 菜单栏打开 Config Dashboard：

打开 Config Dashboard 后，可以在此屏幕上一次性管理预设、安全模块、许可证和构建完整性设置。无需在 Project 窗口中直接查找并修改文件。仪表板就是 Edit > Project Settings 中的 OZero Security 页面，也可以直接在那里打开。

Unity 编辑器菜单说明

OZeroSecurity 将设置窗口放在 Window > OZero Security，将诊断和 bake 命令放在 Tools > OZero Security。安全预设会在 Config & Dashboard 中应用，方便您在保存前确认实际变更的设置。

• Window > OZero Security > Welcome：开始界面
• Window > OZero Security > Config & Dashboard：安全设置（打开 Edit > Project Settings > OZero Security）
• Window > OZero Security > Check Setup：设置检查与自动设置（Auto Setup）

Check Setup 与 Auto Setup

打开 Window > OZero Security > Check Setup，或在 Welcome 窗口中点击 Start setup。建议在导入软件包后和发布构建前各运行一次。

Check Setup 会检查项目、当前构建目标和安全设置，列出阻止构建的项目和建议修改的项目。每个项目都有 Docs（说明）和修复按钮，请先解决阻止构建的项目。

点击 Auto Setup，会逐步显示建议的修改。每一步都会显示当前值和修改后的值，请选择 Apply 或 Skip。完成后会显示已应用、已跳过和仍待处理项目的摘要。当不再有阻断项目和 Auto Setup 可应用的变更时，会显示 Setup complete 框和 Open Build Settings 按钮，之后照常构建即可。

Auto Setup 会修改的项目：关闭 Development Build、切换到 IL2CPP、将 Managed Stripping 设为 Low、Android API 24 与 ARM64、生成 DeveloperSecret、导入 TMP 对话框软件包、生成 manifest 签名密钥（并开启 Require Manifest Signature）、添加 Android 调试 SHA。

签名密钥文件：Auto Setup 生成的 manifest 签名私钥文件请放在项目和版本控制之外，并确保包括 CI 在内的所有构建机器都能使用。

详细：Auto Setup 的步骤与行为

Check Setup（Window > OZero Security > Check Setup，或 Welcome 窗口中的 Start setup）会检查项目、当前构建目标、安全设置以及各平台的发布设置，列出阻断问题、建议事项和信息。每个项目都有 Docs 和修复按钮，窗口顶部会显示 Auto Setup 可以应用的建议变更数量。窗口顶部的按钮从左到右依次为 Auto Setup（显示待应用的变更数）、Re-check（重新运行检查）、Manual 和 Security Config。Security Config会打开 Edit > Project Settings > OZero Security。实际构建玩家时，构建时验证仍会照常运行。

导入 OZero SDK 包后首次打开 Check Setup 时，如果有 Auto Setup 可以应用的变更，会询问是否开始 Auto Setup（Start Auto Setup / Not now）。即使再次导入相同版本，每次导入后都会再次询问；在 batch 模式下不会询问。也可以稍后通过 Auto Setup 按钮开始。

Auto Setup 会先列出计划执行的步骤，只列出项目和当前构建目标需要的步骤，然后选择 Start（或 Cancel）。每一步都会显示当前值和变更后的值，让你选择 Apply、Skip 或 Stop。最后的摘要画面会列出已应用、已跳过和仍未解决的项目，并可通过 Run Auto Setup Again 从头再次运行。可能出现的步骤如下：

1. 关闭 Development Build
2. 将 Scripting Backend 改为 IL2CPP
3. 仅限 IL2CPP：将 Managed Stripping Level 设为 Low
4. Android：最低 API 级别 24，目标架构 ARM64
5. 生成 DeveloperSecret
6. 导入 Built-in TMP 对话框包。如有需要会安装 TextMeshPro/Unity UI，并依次导入 TMP Essential Resources 和对话框包。全部完成之前，Processing 画面会显示当前阶段和已用秒数，完成后进入下一步。即使经过脚本重新加载也会继续。
7. 生成清单签名密钥对（信任锚点会自动更新）。私钥文件的创建位置会显示在步骤画面中。不会弹出结果对话框，私钥位置和指纹会记录在控制台日志中。如果已存在密钥，会弹出对话框询问是否覆盖。下一步会开启 Require Manifest Signature。
8. 添加 Android 调试 SHA。结果会记录在控制台日志中。如果没有调试 keystore，会弹出对话框询问是否创建。 通过 Security Config 或 Keystore SHA Extractor 的按钮直接运行时，仍会像以前一样弹出结果对话框。

安全设置中的 Fail Build on Setup Warnings 开启时（默认），密钥生成和 Require Manifest Signature 也是普通步骤：跳过后警告会保留，玩家构建会在 preflight 阶段失败，步骤画面和摘要画面也会提示这一点。只有在该设置关闭时，它们才会成为标有“(optional, review first)”的可选步骤。密钥生成步骤会显示私钥文件的创建位置。请将私钥放在项目之外并排除在版本控制之外，同时确保包括 CI 在内的所有构建机器都能使用。

此编辑器无法应用的步骤（例如 Unity 编辑器未安装 IL2CPP 模块时的 IL2CPP 步骤）不会逐步执行，而是在概览和摘要画面的 Needs your action 中单独列出。缺少 IL2CPP 模块时，请在 Unity Hub > Installs > Add modules 中添加目标平台的 IL2CPP 模块，然后重新运行 Auto Setup。Player Settings 的变更无法通过 Undo 撤销，所有已应用的变更都会显示在摘要画面中。

以下两项 Check Setup 错误用于保护 OZero 的原生加载锚点（客户端保护的局限）。OZero native plugins are not set to Load on startup：Auto Setup 会重新开启 OZero 原生插件的 Load on startup，请勿关闭该设置。Android boot provider library is missing：Mono 后端的 Android 构建需要该库，请重新导入 OZero Security 软件包以恢复 Assets/OZeroSecurity/Plugins/Android/OZeroSecurityBoot.androidlib。

安装在线附加组件后，Auto Setup 还可以让你输入只有你知道的值并完成设置。这类步骤会显示输入框（标签位于输入框上方），输入值后按 Apply 即可。值在保存前会先经过检查，不会写入 Console 或日志。检查失败时，该步骤会显示原因且不保存任何内容；请修改后重新输入，或按 Skip。

• License Key：用于 Pro license key is empty、Native Variant <NNNN> needs your license key 和 … is bound to a different license key。如果项目中有绑定许可证的 Native Variant，保存前会与该 Variant 的许可证核对，其他许可证的密钥不会被保存。
• Server Public Key：用于 Pro server signing public key is not configured。请从 Customer Portal > Server Key 复制签名公钥（64 个十六进制字符）。其他格式会被拒绝，并以小写形式保存。
• Application Identifier：用于 Application identifier is not registered for Native Variant <NNNN>。需要输入的值取决于当前构建目标，与 Customer Portal > Platform settings 一致。Android 输入 Package Name，iOS 输入 Bundle Identifier，输入框会预先填入当前标识符；由于该选项关闭时 Unity 会忽略输入的标识符，Apply 还会开启 Player Settings 中的 Override Default Package Name / Bundle Identifier。Windows、macOS、Linux 请在各自的输入框中分别输入在 Customer Portal > Platform settings 中为该平台登记的 Company Name 和 Product Name（门户中显示为 Company / Product）；两个输入框会预先填入当前值，并按 company.product 或 com.company.product 核对。Apply 会设置 Player Settings 的 Company Name 和 Product Name；Product Name 也是构建出的应用名称。WebGL 通过门户中登记的页面 origin（域名）识别，项目中无需修改，该步骤会显示为不可用。输入的值必须已为你的许可证登记；如果未登记，会提示你先在 Customer Portal 中登记，再重新下载包。

3 激活模块

在仪表板内可以查看安全模块列表及切换开关。请激活您要使用的模块。以下是推荐的初始配置。

选择安全预设

首先选择一个预设，然后根据项目进行个别模块调整。对于一般的实时在线游戏，建议从 Standard 开始。这能在保护级别、性能和误报率之间取得最佳平衡。

详细：预设会修改的值

Quick Preset 面板会显示与当前设置一致的预设，例如 Current: Standard，对应按钮以粗体和 * 标出。应用后手动修改数值时会显示 Current: Custom，此时任何按钮都不带标记。推荐值为 Standard，按钮上显示为 Standard (Recommended)；预设名称仍为 Low / Standard / Strict。每个按钮下方会显示预设说明，按钮的工具提示中也有相同说明。

Windows 系统模块扫描（enableWindowsSystemModuleScan）：Low OFF / Standard、Strict ON。这是安全预设，而非许可证等级。兼容性和观测规则请参阅 Injection 设置。

设置下载由 enableRemoteSpeedHackConfig、enableRemoteInjectionConfig 和 enableRemotePhysicsConfig 控制。安全预设只有在项目的许可证等级（Online Services 设置）为 Pro 时才会开启这些选项；若为 Standard 或没有许可证设置，预设会让所有 Pro 专用服务器选项保持关闭（将等级改为 Pro 后请重新应用预设）。这些选项仅在 Pro 中生效。远程配置选项本身不会开启 BIV 服务器验证、安装来源同步、服务器白名单或遥测；预设会另外更改这些值（参见上方的预设表）。

• Low: 仅保留轻量的核心检查。放宽平台原生检查及强制关闭策略，以免测试环境过早被封锁。
• Standard: 启用核心保护套件、启动验证、运行时再验证、模拟器检查以及推荐的 IL2CPP 文件覆盖。是一个平衡了兼容性与保护级别的配置。
• Strict: 采用最广泛的覆盖范围，将更多的失败视为致命违规。请在充分测试平台、签名及商店发布流程后再采用。

许可证模型 — Standard / Pro

OZero Security 提供 Standard 和 Pro 两种等级。Standard 模式无需服务器联动，仅使用本地保护功能。Pro 模式提供项目专属 Native Variant 包、清单 / Bundle ID 绑定、遥测、签名服务器时间、远程策略、服务器校验等运营功能。

이 앱은 부정 행위와 변조를 방지하기 위해 OZero Security SDK(오제로시큐리티 주식회사)를 사용합니다. 보안 검사는 기기 안에서 이루어지며, [Pro 서버 기능이 켜진 경우] 보안 이벤트가 발생하면 다음 정보가 OZero 서버로 전송됩니다: 앱별로 해시된 기기 식별자, 플랫폼·운영체제, 앱 버전, 탐지된 보안 이벤트의 종류와 결과, 탐지에 관련된 외부 프로그램 모듈의 파일명·서명자·해시, 접속 국가. [물리 검증을 켠 경우: 캐릭터 위치·속도·씬 이름.] [Steam 확인을 켠 경우: Steam 인증 티켓과 SteamID(해시로 저장).] 기기의 원문 식별자, IP 주소, 채팅·닉네임·결제 정보는 전송되지 않습니다. 전송된 기록은 90일 후 삭제되며, 외부 프로그램 모듈 정보는 개인·기기와 연결되지 않는 형태로 OZero의 부정 프로그램 판별 기준을 개선하는 데 사용됩니다. 자세한 내용: https://www.ozerosecurity.com/privacy.html

This app uses the OZero Security SDK (OZero Security Inc.) to prevent cheating and tampering. Security checks run on the device. [When Pro server features are enabled] the following is sent to OZero servers when a security event occurs: an app-specific hashed device identifier, platform and OS, app version, the type and result of the security event, the file name, signer and hash of third-party modules involved in the detection, and the country of connection. [Physics validation: character position, velocity and scene name.] [Steam verification: the Steam auth ticket and SteamID, stored hashed.] The raw device identifier, IP address, chat, nicknames and payment data are not sent. Records are deleted after 90 days. Module information is used, in a form not linked to any person or device, to improve OZero's cheat-program classification. Details: https://www.ozerosecurity.com/privacy.html

本アプリは不正行為と改ざんを防ぐために OZero Security SDK（OZero Security Inc.）を使用しています。セキュリティ検査は端末内で行われ、[Pro サーバー機能が有効な場合] セキュリティイベント発生時に次の情報が OZero サーバーへ送信されます：アプリごとにハッシュ化した端末識別子、プラットフォーム・OS、アプリのバージョン、検知したイベントの種類と結果、検知に関係した外部モジュールのファイル名・署名者・ハッシュ、接続国。[物理検証：キャラクターの位置・速度・シーン名。][Steam 確認：Steam 認証チケットと SteamID（ハッシュで保存）。] 端末の生の識別子、IP アドレス、チャット・ニックネーム・決済情報は送信されません。記録は 90 日後に削除され、モジュール情報は個人や端末と結び付かない形で OZero の不正プログラム判定基準の改善に使われます。詳細：https://www.ozerosecurity.com/privacy.html

本应用使用 OZero Security SDK（OZero Security Inc.）防止作弊与篡改。安全检查在设备内进行，[启用 Pro 服务器功能时] 发生安全事件时会向 OZero 服务器发送以下信息：按应用哈希处理的设备标识符、平台与操作系统、应用版本、安全事件的类型与结果、与检测相关的第三方模块的文件名·签名者·哈希、连接国家。[物理验证：角色位置、速度与场景名。][Steam 验证：Steam 认证票据与 SteamID（以哈希保存）。] 不会发送设备原始标识符、IP 地址、聊天、昵称与支付信息。记录在 90 天后删除；模块信息以不关联个人或设备的形式用于改进 OZero 的作弊程序判定标准。详情：https://www.ozerosecurity.com/privacy.html

Online Services 设置

Security Config 会在两个位置显示附加组件设置。Protection Modules 组末尾，即页面最底部（Steam Anti-Piracy (PC Only) 之后）的 Pro - License & Online Services 卡片以 License（层级和许可证密钥）开头。Tier 为 Pro 时，还会显示 Server Connection、Offline & Device Policy、Security Level Enforcement（含 Security Config Hash (build allowlist) 列表）、Telemetry、Online Verification UI 和 Validate License Now，并且每个检测模块部分（Build Integrity、Install Source (Android Only)、Device Binding、Speed & Time Hack、Injection & Hooking、Steam Anti-Piracy (PC Only)）中会出现包含该模块在线设置的 Pro - Online 区块。模块的 Activate 关闭时，该区块不可用。

这些值保存在 ProjectSettings/OZeroLicenseSettings.asset 中，请将该文件提交到版本控制；Project 窗口中没有设置资源。也可以在独立界面中编辑相同的设置：Security Config 和 Welcome 窗口中的 Online Services 按钮会打开 Window > OZero Security > Online Services 窗口（如设置不存在则创建），窗口中有 Select Settings Asset 和 Validate License Now 按钮。通过窗口顶部的 Security Config 和 Check Setup 按钮可以进入相应画面。本节其余部分以独立界面为准，项目名称在 Security Config 中相同。

在 License 部分选择层级。两种层级都会显示 License Key 字段。选择 Standard 时只显示 License 部分，并提示 Standard 无需服务器即可运行：在线服务处于关闭状态，不会向 OZero 服务器发送任何内容。只有在使用包含 Native Variant 的包时才需要输入 License Key，并且只在本地检查。选择 Pro 后会显示服务器连接和在线服务设置。

设置的结构与 Security Config 相同，顺序为 Quick Preset、License、Server Connection、Offline & Device Policy、Security Level Enforcement（通过标题中的 Enable 开启）、模块部分 Build Integrity、Install Source、Device Binding、Speed & Time Hack、Injection & Hooking、Steam Anti-Piracy，最后是 Telemetry 和 Online Verification UI。

整个 SDK 只有一个预设。这里的 Low / Standard / Strict 按钮与 Security Config 应用的是同一个预设，因此在任一处应用结果都相同。这里同样以 Standard 为推荐值，显示为 Standard (Recommended)，每个按钮下方都有说明。应用预设会同时更新检测模块、在线服务默认值和 Declared Security Level，许可证、服务器 URL 和密钥保持不变。面板会显示当前状态，例如 Current: Standard，对应按钮以粗体和 * 标出；应用后手动修改在线设置时会显示 Current: Custom，此时任何按钮都不带标记。当 Declared Security Level 与所应用的预设不一致时，Security Level Enforcement 部分会显示警告。

模块部分的名称和顺序与 Security Config 相同。标题中显示该模块在 Security Config 中的状态（Active / Inactive，只读），每个部分开头用一行说明在线服务为该模块增加的内容。服务器开关位于该部分的第一行：

• Build Integrity：Check Integrity With Server
• Install Source：Check Installer With Server
• Device Binding：Verify Device With Server
• Speed & Time Hack 和 Injection & Hooking 有多个服务器功能，因此没有单一开关。
• Steam Anti-Piracy：Check Steam DRM With Server

在 Security Config 中，模块关闭时，该模块的 Pro - Online 区块会显示为不可用，并提示 Activate this module to use its online settings.。在独立界面中，未启用模块的部分会提示在启用模块之前这些在线设置不起作用，并提供 Open Security Config 按钮。

Telemetry 和 Online Verification UI 是在线专用部分。Telemetry 涉及发送到 Customer Portal 的安全事件和远程物理配置。Online Verification UI 决定服务器验证期间所显示画面（验证中、重试、需要在线、超时）的行为，设置项包括 UI 策略、重试与需要在线的时间、超时操作，以及网络恢复时自动重试。对话框的设计和语言遵循 Security Config > Player Notice (Managed UI)。当 Check Integrity With Server 和 Check Steam DRM With Server 都关闭时，会提示该部分未被使用。

附加组件没有单独的日志开关，日志遵循 Security Config 中的 Enable Debug Logs。

Pro 包与 Native Variant

Pro 客户从 Customer Portal 的下载页面获取 Pro unified package（Pro 统合包）：为该许可证生成的一个 .unitypackage，包含 Standard SDK、在线附加组件以及所有平台的 Native Variant。卡片提供两个选项：

• With your Native Variant（包含 Native Variant）：分配给该许可证的专用原生库。卡片会显示分配编号（Variant · Native · ABI），该包绑定到你的许可证（许可证密钥以及为其注册的 Bundle ID / 包名）。
• With the Standard variant (0000)（包含 Standard variant 0000）：Standard SDK 自带的公共原生库，不绑定许可证。

更换（轮换）Variant 时：使用之前的 Variant 制作的现有构建仍可继续运行。新的 Variant 从更换后重新下载的软件包所制作的构建开始生效。更换会占用一次轮换次数，更换后无法退款。

要在 Tier Standard 下使用包含 Native Variant 的包，请将 Tier 保持为 Standard，只需在 Security Config > Pro - License & Online Services > License 中输入 License Key。构建和玩家只在本地检查密钥，Tier Standard 不会与 OZero 服务器通信。这依赖默认开启的 Allow Standard Build With Premium License；如果它被关闭，Check Setup 会提示你开启该选项或将 Tier 设为 Pro。

如果要在没有许可证密钥的情况下构建，请下载包含 Standard variant (0000) 的包。

如果你在 Unity Asset Store 购买了 SDK，请从 Asset Store 安装 SDK，并只从 Customer Portal 下载 Pro extension package（Pro 扩展包）：其中包含针对卡片上所选 SDK 版本的在线附加组件和已分配的 Native Variant，不包含 SDK 本身。

Check Setup 中的 Native Variant 项目

当包中含有 Native Variant 时，Check Setup 会在构建前报告项目是否与之匹配。玩家构建也会因同样的原因停止。

游戏服务器集成：设备 ID 与用户 UUID

Pro 让你的游戏服务器可以配合 OZero 使用的 ID。读取 OZero 设备 ID 并与玩家账号一起保存，再关联游戏自己的用户 UUID（账号 ID），即可在 Customer Portal 中查找该用户使用过的设备并封禁该用户。

读取设备 ID

请读取 OZeroLicenseRuntime.CurrentDeviceId。在默认设置下，它与 Customer Portal 和遥测中显示的值相同。不要为了关联账号而替换 DeviceIdProvider，那样会改变服务器所知道的设备 ID。请改用下面的用户 UUID API，设备 ID 会保持不变。

关联用户 UUID

• 玩家登录后调用 OZeroLicenseRuntime.SetExternalUserId(uuid)。如果去掉首尾空白后为空、超过 128 个字符或包含控制字符，它会返回 false 并忽略该值。
• 登出时调用 OZeroLicenseRuntime.ClearExternalUserId()。可以通过 HasExternalUserId 判断当前是否关联了用户。
• UUID 会在设备内使用每个许可证独有的 salt 进行 SHA-256 哈希。遥测、物理事件和设备策略检查只发送哈希值，服务器也只保存哈希值。原始 UUID 不会离开设备，也不会写入磁盘。
• 可以在激活完成前调用。SDK 会先把 UUID 保存在内存中，激活后再开始发送哈希值。

封禁用户

在 Customer Portal 中，用户封禁规则有以下两种动作之一：

• 仅回调：游戏在每个会话中收到一次 policy action（Module = "user_policy"、PolicyId = 规则 ID、Reason = 运营者填写的原因），由游戏决定如何处理。会话不会结束。
• 强制结束：游戏先收到 policy action（Module = "user_policy"、ActionId = "user_blocked"、Reason = "terminate"）。随后 SDK 显示与设备策略封禁相同的结束提示（OZ-SEC-0E）并结束会话。

通过 OZeroLicenseRuntime.LastServerBlockCode 区分用户封禁和设备封禁：用户为 "USER_BLOCKED"，设备为 "DEVICE_BLOCKED"。判定会在调用 SetExternalUserId 后约 5 秒内执行（即使设备策略 heartbeat 已关闭），且最短间隔为 30 秒。如果网络失败，不会结束会话，由下一次检查判定。

Customer Portal：User UUID 页面

在 Customer Portal 中打开 Operations > User UUID（Pro）。该页面有三个标签页：

• Find user（查找用户）：输入游戏传给 SetExternalUserId 的 UUID。浏览器会在发送前进行哈希，原始值不会到达服务器。结果会显示该用户使用过的设备（首次和最近观测时间、事件数）、最近的事件（遥测、物理事件、策略封禁）以及封禁状态，并提供创建、编辑或解除封禁规则的按钮。Find by device（按设备查找）输入设备 ID（CurrentDeviceId），显示关联的用户数和每个用户键的前 8 个字符。原始 UUID 无法显示，请通过 UUID 搜索来确认用户。
• Block rules（封禁规则）：查看规则列表（生效中或全部）。在 New rule 中填写用户 UUID、动作（Callback only 仅回调或 Terminate 强制结束）、同时会发送给游戏回调的原因，以及到期时间：Never（默认，直到解除）、7、30、90 天或指定日期。为已有规则的用户保存时会更新原规则。每条规则都会显示创建来源：Portal、Server API 或 Operator。
• Settings（设置）：显示该许可证的 salt、计算公式、UUID 规范化规则、当前关联数量，以及在你的服务器上计算相同哈希（h1）的 C#、Node.js 和 Python 示例。你的服务器使用这个 h1 调用服务器 API。游戏客户端不需要 salt，SDK 会在激活时获取。

在 Settings 标签页中执行 Reissue salt（重新签发 salt）会断开现有关联：用旧 salt 建立的用户关联和封禁规则将不再与用户匹配，现有规则保留在旧键下。游戏会在下次激活时获取新 salt，你的服务器也必须用新 salt 重新计算 h1。

保存或解除封禁规则以及重新签发 salt 的操作，会记录在 Operation history（操作历史）的 User UUID 类别中。

Customer Portal 是单页应用。如果更新后页面显示仍是旧版或异常，请刷新页面。

与 Settings 标签页相同的示例。请用 API 参考（OZeroLicenseRuntime）中的测试向量验证你的实现。

// C#
using System.Security.Cryptography;
using System.Text;

static string ExtUserHash(string salt, string uuid)
{
    var id = uuid.Trim(' ', '\t', '\n', '\v', '\f', '\r');
    var bytes = SHA256.HashData(Encoding.UTF8.GetBytes("OZERO-EXTUID-V1|" + salt + "|" + id));
    return Convert.ToHexString(bytes).ToLowerInvariant();
}

// Node.js
const crypto = require("crypto");

function extUserHash(salt, uuid) {
  const id = uuid.replace(/^[ \t\n\v\f\r]+|[ \t\n\v\f\r]+$/g, "");
  return crypto.createHash("sha256").update("OZERO-EXTUID-V1|" + salt + "|" + id, "utf8").digest("hex");
}

# Python
import hashlib

def ext_user_hash(salt: str, uuid: str) -> str:
    uid = uuid.strip(" \t\n\v\f\r")
    return hashlib.sha256(f"OZERO-EXTUID-V1|{salt}|{uid}".encode("utf-8")).hexdigest()

示例：登录、登出与 policy 回调

using OZeroSDK.Security;
using OZeroSDK.Security.License;
using UnityEngine;

public sealed class OZeroAccountLink : MonoBehaviour
{
    private void OnEnable()
        => OZeroSecurityManager.Instance.RegisterUserPolicyActionCallback(OnPolicyAction);

    private void OnDisable()
        => OZeroSecurityManager.Instance.UnregisterUserPolicyActionCallback(OnPolicyAction);

    // Call after your sign-in succeeds.
    public void OnSignedIn(string accountUuid)
    {
        if (!OZeroLicenseRuntime.SetExternalUserId(accountUuid))
            Debug.LogWarning("OZero: user id rejected (empty, too long, or control characters).");

        // Optional: keep the OZero device id with the account on your server.
        string deviceId = OZeroLicenseRuntime.CurrentDeviceId;
        MyGameServer.ReportDevice(accountUuid, deviceId);
    }

    // Call on sign-out.
    public void OnSignedOut() => OZeroLicenseRuntime.ClearExternalUserId();

    private void OnPolicyAction(OZeroPolicyActionEvent evt)
    {
        if (evt.Module != "user_policy")
            return;

        if (evt.ActionId == "user_blocked")
        {
            // Terminate rule: the SDK shows the termination notice and ends the session next.
            MyGame.SaveQuickly();
            return;
        }

        // Callback-only rule: the game decides what to do.
        Debug.LogWarning($"User block rule {evt.PolicyId}: {evt.Reason}");
        MyGame.RestrictAccount(evt.Reason);
    }
}

隐私与商店披露

• 请使用化名的账号 ID 作为 UUID，不要使用邮箱地址或电话号码。
• iOS：附加组件的隐私清单已经声明了 User ID，无需额外添加。
• Google Play：如果关联了用户 UUID，请在 Data safety 表单中声明 User IDs。

安全设置哈希许可列表

每个构建都会封存其安全设置（OZeroSecurityConfig，包括在线附加组件设置）并计算 SHA-256 哈希。批准你发布的构建的哈希后，服务器的安全等级检查只放行这些构建，因此即使篡改构建削弱了设置并声明高安全等级，也无法通过。

• 兼容模式（没有已批准的哈希）：只比较声明的安全等级，所有构建都会通过哈希检查。
• 强制模式（至少一个已批准的哈希）：哈希未被批准的构建会被拒绝。开启 Fail On Security Level Reject 时游戏结束，否则降级为 Standard。

仅限 Pro。只有开启 Security Config > Pro - License & Online Services > Security Level Enforcement（标题中的 Enable，enableSecurityLevelCheck）时才会生效。关闭时构建不会发送哈希，许可列表不起作用，该部分会显示一条警告，而不是哈希列表。

查看构建的哈希

• 构建日志会输出 [OZero] Security config digest for this <Target> build: <64 hex>。
• 开启 Security Level Enforcement 时，Security Config 底部 Pro - License & Online Services 卡片的 Security Level Enforcement 部分中的 Security Config Hash (build allowlist) 会显示最近 5 次构建（目标平台、时间（UTC）、哈希和 Copy 按钮）。Window > OZero Security > Online Services 窗口的同一部分中也有相同的列表。
• 记录文件 Library/OZeroSecurity/BuildConfigDigests.json 保存最近 20 次构建。
• 玩家发送的哈希与构建日志和 Pro 卡片（或 Online Services 窗口）中显示的摘要相同。
• 在另一台机器上用相同设置构建，哈希也相同。
• 编辑器 Play Mode 发送的是根据配置资源计算的哈希，而不是构建哈希。它可能出现在门户的 Hashes the server received 列表中，请不要批准它。

在 Customer Portal 中批准哈希

打开 Policy Settings > Security Config Hashes（Pro）。

• 顶部显示策略模式（Enforced 强制或 Compatibility 兼容）以及有效的已批准哈希数量。
• Approved hashes（已批准的哈希）：点击 Revoke 解除。解除最后一个哈希后，许可证会回到兼容模式。
• Hashes the server received（服务器收到的哈希）：开启 Security Level Enforcement 的构建发送的哈希（不保存设备 ID，观测次数每小时最多计一次）。在发布构建的哈希上点击 Approve。
• Register a hash（直接登记哈希）：输入构建日志或 Pro 卡片中的哈希、标签以及到期时间（Never、30 天、90 天或 1 年）。
• 首次批准时会要求确认“未批准的构建将被拒绝”。开启前请先批准当前正在发布的所有构建。

批准和解除操作会记录在 Operation history（操作历史）中。要从 CI 登记哈希，请参阅 API 参考中的安全设置哈希（CI）。

Pro 许可证密钥注册

Standard 不需要单独的许可证设置即可使用。使用 Pro 时，请在 Online Services 设置（保存在 ProjectSettings/OZeroLicenseSettings.asset 中）中输入为项目签发的许可证密钥。Pro 密钥用于从门户下载项目专用 Native Variant 包，并在构建时确认该包属于当前项目。Pro 密钥还用于运行时服务器激活和 Pro 专用服务器功能。

1. 创建设置资产

在线附加组件会在导入后编辑器空闲时，自动在 ProjectSettings/OZeroLicenseSettings.asset 中创建许可证设置（如果 Assets/ 下仍有旧的 OZeroLicenseConfig 资源则不会创建）。请在 Security Config 底部的 Pro - License & Online Services 卡片中输入许可证：在 License 中选择层级并输入许可证密钥（Standard 仅在使用 Native Variant 包时需要）；服务器 URL 和密钥位于 Server Connection。在 Security Config 或 Welcome 窗口中点击 Online Services 会打开包含相同设置的 Window > OZero Security > Online Services 窗口，如设置不存在则会创建。请将 ProjectSettings/OZeroLicenseSettings.asset 提交到版本控制。

2. 填写 Inspector 字段

3. 确认 Check Integrity With Server

构建前请确认 Security Config > Build Integrity > Pro - Online > Check Integrity With Server 是你想要的值。Standard 和 Strict 预设会开启它，Low 预设会关闭它；新建的 Online 设置以 Standard 的值（开启）开始。开启后会增加服务器构建判定和运行期间的再次确认，使用 Standard 时启动需要联网。门户的设备和 Variant 封禁无论此值是否开启都会生效。使用默认 Built-In 确认 UI 时需要 TMP dialog 包，Auto Setup 会导入它。如果游戏需要离线运行，请参阅离线操作。

4. 构建与验证

不需要额外编写代码。应用启动时，SDK 会自动读取构建时以加密资源形式放入玩家包的许可证设置。首次运行后，请在 Player 日志中确认是否出现类似 [OZeroLicense] activated; tier=pro caps=5 的行。如果已设置为 Pro 但日志显示 Standard 模式，请先确认 ProjectSettings/OZeroLicenseSettings.asset 存在且在构建前已保存，并且 Check Setup 没有显示 Old OZeroLicenseConfig asset found。

离线操作

Standard 无需服务器即可运行。Pro 可以使用已保存的激活信息离线启动；如果许可证策略要求每次启动都在线确认，则需要连接服务器。

Standard — 无需互联网即可启动

Standard 不会向服务器请求许可。它只运行应用内置的本地保护模块，所以玩家离线时游戏也能启动。只有遥测、signed time 等需要 Pro 服务器的功能不可用。

Pro — 本地保护保持离线，所选服务器功能使用缓存

启用可选的 Pro 服务器功能后，SDK 会在联网时确认设备和许可证。所选服务器功能可在有限时间内容忍短暂断网。此检查不会限制使用已获取 Native Variant 的构建或本地保护。

需要离线运行的游戏：Standard 和 Strict 预设会开启 Check Integrity With Server，因此需要联网完成服务器验证。若要离线运行，请应用 Low 预设，或关闭 Security Config > Build Integrity > Pro - Online > Check Integrity With Server。此时将不进行服务器构建判定和运行期间的再次确认。

已保存的 Pro 激活信息在服务器签名的激活令牌到期前有效。到期时间由 OZero 服务器在签发令牌时决定（目前为激活成功后 7 天），SDK 无法延长。超过该期限后，需要再次成功激活才能使用 Pro 服务器功能。已应用的 Native Variant 和本地检测设置不会改变。此有效期与下方的本地时间策略分别生效。

Pro — 选择如何使用设备时间

在客户门户 > 许可证 > 本地时间中，可以设置已保存的 Pro 激活信息能否用于离线启动。在线激活使用服务器时间，因此设备日期或时间不准确不会单独导致在线 Pro 功能降级。

Pro — 门户中阻止的版本离线也会被阻止

临时服务器或网络问题下继续以基础保护启动，和允许运营人员在门户中明确阻止的版本运行，是两件不同的事。Pro 激活成功时，服务器会同时下发带签名的阻止列表，例如被阻止的构建哈希、SDK 版本和应用版本。SDK 会将该策略与临时服务器功能状态分开处理。

请在 Security Config 的 Pro - License & Online Services 卡片中 Offline & Device Policy 部分，通过 Offline Pro Policy Mode（OZeroLicenseConfig.offlineProPolicyMode，Online Services 窗口中也有）配置此行为。它决定设备无法连接服务器时，本地 Build Integrity 如何处理最后一次收到的已签名 Pro 门户阻止策略。

总结来说，ApplyCachedBlockPolicies 是运营默认的 fail-open 模式，RequireFreshPolicy 是 fail-closed 策略模式，IgnoreCachedBlockPolicies 是测试用 bypass。如果每次验证都必须要求在线服务器确认，请不要只依赖此选项，还要同时配置服务器 Integrity 或 Managed Verification 的必需选项。

许可证问题解决

出现问题时，请先在 Unity Player 日志中搜索 [OZeroLicense]。这个日志会告诉你 SDK 是以 Standard 启动，还是 Pro 激活成功；如果失败，也会说明为什么降级到 Standard。安全事件上传问题则同时搜索 [OZeroTelemetry]。

项目设置

在调整各个安全模块之前，请先检查影响原生插件、商店构建和平台验证的 Unity Player Settings。

最低构建目标

发布构建的推荐设置

发布构建推荐使用以下设置。

• 将 Scripting Backend 设为 IL2CPP（Project Settings > Player > Other Settings）。
• 将 Managed Stripping Level 设为 Low。使用 Mono 后端时请保持 Disabled。
• 修改设置后，请在真机上测试场景切换、存档/读档以及支付、广告等外部 SDK。

客户端保护的局限

Mono 构建可以用常见工具反编译和修改，修改后的构建可以跳过客户端检查。IL2CPP 会大幅提高修改成本，但也不是完全的防护。真正的对策是服务器验证，以及让游戏代码依赖 Secure Variables 等 OZero API。

对于被绕过会造成较大损失的游戏，推荐以下配置：

• 将关键游戏数值（货币、分数、属性）交给 Secure Variables（OZeroSV） 管理。移除或禁用 SDK 会导致游戏无法正常进行，从而提高绕过成本。
• 开启服务器完整性验证（OZeroManaged 或 CustomerGameServer），并在游戏服务器上检查 OZA 令牌或 managed session。修改后的客户端无法获得有效的服务器签名。

macOS：Developer ID 签名与公证

Unity 生成的 macOS 构建是 ad-hoc 签名，开启 Build Integrity 时会在启动约 10 秒后退出。要分发，必须使用 Developer ID Application 证书签名。开启自动签名后，OZero 会在构建结束时签名。

开启自动签名（推荐）

1. 打开 Window > OZero Security > macOS Distribution Signing，开启 Sign macOS builds。构建目标为 macOS 时，也可以通过 Check Setup 中的 Open signing settings 打开。
2. 在 Certificate 中选择 Developer ID Application 证书。钥匙串中只有一个时，保持 Automatic 即可。
3. 如需在构建时一并公证，请开启 Notarize，并输入事先用 xcrun notarytool store-credentials 创建的 Notary keychain profile 名称。
4. 点击 Save。之后每次 macOS 构建完成时都会自动签名，Console 中出现 macOS distribution signing complete 后即可直接发布。

bash "/path/to/YourProject/Assets/OZeroSecurity/Tools/macOS/OZeroMacSign.sh" \
  --app "/path/to/YourGame.app" \
  --project "/path/to/YourProject" \
  --notary-profile "YourNotaryProfile"

OZERO_MACOS_SIGNED_APP_PATH="/path/to/YourGame.app" \
  "/path/to/Unity.app/Contents/MacOS/Unity" -batchmode -nographics -quit \
  -projectPath "/path/to/YourProject" \
  -executeMethod OZeroSDK.Security.Editor.OZeroMacOSPostSignIntegrityRebaker.RebakeAfterNestedSigning \
  -logFile rebake.log

Windows / Linux：代码签名与完整性文件重新生成

如果不自行对 Windows 或 Linux 构建进行代码签名，请跳过以下步骤。如果在构建后对可执行文件或原生模块签名，签名后必须重新生成 OZero 完整性文件，否则游戏会在启动时因完整性错误（0x0A）退出。

1. 照常构建后，为可执行文件和您自己的 DLL 或 .so 签名。OZero DLL 已经签名，无需再次签名。发布构建需要操作系统信任的证书，自签名测试证书无法通过。
2. 用下面的命令按已签名的输出重新生成完整性文件，也可以在编辑器中使用 Tools > OZero Security > Re-bake Integrity After Code Signing (Windows or Linux player)...。
3. 直接打包并发布。完整性文件位于 <Game>_Data/StreamingAssets 下，不属于签名对象。如果使用服务器验证，请登记重新生成时输出的 manifest 哈希。

set OZERO_SIGNED_PLAYER_PATH=C:\dist\YourGame.exe
"C:\Program Files\Unity\Hub\Editor\<version>\Editor\Unity.exe" -batchmode -nographics -quit ^
  -projectPath "C:\path\to\YourProject" ^
  -executeMethod OZeroSDK.Security.Editor.OZeroStandalonePostSignIntegrityRebaker.RebakeAfterSigning ^
  -logFile rebake.log

Android ProGuard / R8 设置

# OZero Security - Unity Android ProGuard/R8 keep rules
-keep class com.unity3d.player.UnityPlayer { *; }
-keep class com.unity3d.player.UnityPlayerActivity { *; }
-keep class com.unity3d.player.UnityPlayerGameActivity { *; }
-keep class com.unity3d.player.UnityPlayerForActivityOrService { *; }
-keepattributes *Annotation*,InnerClasses,EnclosingMethod,Signature

# If your game adds custom Java/Kotlin bridge classes that OZero or your code
# calls through AndroidJavaClass / AndroidJavaObject, keep those classes too.
# Replace the package below with your own bridge package.
# -keep class com.yourcompany.yourgame.bridge.** { *; }

• 不要重命名、删除或重新打包 libOZeroSecurity.so。将插件保留在 Assets/OZeroSecurity/Plugins/Android/arm64-v8a 下。如果您要分发 32 位版本，也请保留 armeabi-v7a。
• 如果您使用 Build Integrity > Check Platform Native 和 Android SHA Keys，请务必在应用 Minify/R8 后，使用最终签名的 APK 或 AAB 进行测试。调试密钥库的指纹与发布密钥库的指纹是不同的。

5 安全设置 (OZeroSecurityConfig)

导入包后会以 Standard 预设创建安全设置。请在 Edit > Project Settings > OZero Security 中编辑，Window > OZero Security > Config & Dashboard 也会打开同一页面。共享值保存在 ProjectSettings/OZeroSecuritySettings.asset 中，不含机密，请提交到版本控制。DeveloperSecret 和 manifest 签名私钥路径是按用户保存的值，存放在 UserSettings/OZeroSecuritySecrets.json 中，不纳入版本控制。在运行时和编辑器脚本中用 OZeroSecurityConfig.Instance 读取；若要通过脚本修改，请参见自定义构建脚本。页面顺序为 Quick Preset、Project & Advanced（Common Settings、Editor Play Mode）、Detection Response（Global Threat Response、Player Notice (Managed UI)）、Protection Modules。所有部分初始均为折叠状态，请点击标题展开后再设置。Security Termination Notice 策略位于 Detection Response 下的 Player Notice (Managed UI) 中。

通用设置

这些是所有安全模块共享的顶级设置。本表中的默认值以代码中定义的序列化初始值为准。在 Security Config 中，它们位于 Project & Advanced 组的 Common Settings 下，分为 Keys & Storage、Build Checks (Preflight) 和 Logs & Diagnostics。

Player Notice (Managed UI)（所有许可证）

Security Termination Notice、通用 dialog prefab 与 localization 对 Standard 和 Pro 开放。Pro 还显示 Build Integrity 与 Steam DRM 的 Managed Verification 重试、timeout 和 provider 设置。导入 optional package 前，请先从 Package Manager 安装 Unity UI 与 TextMeshPro。提示仅说明已经安排的终止，不能取消退出或延长 native deadline。

Global Threat Response

决定确认安全威胁后游戏的响应方式。在测试期间请先检查回调和日志，在实际部署构建中请根据项目的运营策略选择给玩家的提示时间和终止策略。

接入问题自查指南

如果启用 OZero Security 后应用退出，或只在特定环境中出现问题，请先通过本地诊断文件确认是哪个模块触发。不要先凭感觉修改设置，而是根据文件中的 module、subCode、reason 按下面的表逐步排查。

应用反复退出时先做什么

常见诊断字段

常见症状和第一步检查

构建完整性验证器设置

配置构建完整性检查器，以检测被修改的游戏文件、调试器连接以及异常的运行环境。

平台说明（门户封禁）：Android 构建不生成 manifest hash，因此构建哈希封禁不适用，只有版本封禁生效。WebGL 不会在本地检查已签名的封禁列表。版本封禁会用同一列表比较 SDK 版本和应用版本，且不区分平台，因此被封禁的版本对所有平台生效。

使用 CustomerGameServer 时，游戏服务器使用服务器 API 密钥调用 POST /v1/validate 检查每个令牌。完整流程和示例见 API 参考中的使用服务器 API 密钥集成游戏服务器。

生成 RSA 签名密钥（Build Integrity Manifest）

Build Integrity 可以为构建时生成的 manifest 添加 RSA 签名。该 manifest 包含运行时要验证的 assembly hash 与文件完整性信息。对于发布构建，如果 manifest 本身被替换，验证基准就不再可信，因此发布前请在 Window > OZero Security > Config & Dashboard 中点击 Generate Key Pair 生成 manifest 签名密钥对。自 SDK 1.2.0 起，聚合哈希（oz_ahash）在所有预设下始终包含播放器启动文件：Windows、macOS、Linux（Mono 与 IL2CPP）为 RuntimeInitializeOnLoads.json、ScriptingAssemblies.json、globalgamemanagers 和 globalgamemanagers.assets；Android 在原生库和 global-metadata.dat 之外再加上 RuntimeInitializeOnLoads.json 和 ScriptingAssemblies.json。在桌面平台上，Compression Method 为 LZ4/LZ4HC 时，globalgamemanagers、场景和资源会被打包成 data.unity3d 一个文件；此时只要该文件存在，就会代替单独的文件始终参与哈希。即使文件较大，SHA-256 计算在启动时也大约每 GB 1 秒。

为什么需要 Manifest 签名

构建时，OZero 会使用私钥为 manifest 签名。私钥不会包含在 player build 中，构建中只包含存储在安全设置中的公钥。运行时，SDK 会用公钥确认 manifest 签名。如果签名有效，SDK 会认为“构建时生成的 manifest 仍保持原样”，并以该 manifest 作为 assembly/file hash 检查的可信基准。如果签名缺失或不匹配，则 manifest 可能已被替换或编辑，因此 Build Integrity 会将其视作失败。之后的处理会按照 Response Settings 执行，例如记录日志、触发回调或关闭应用。

生成密钥对

1. 在 Unity 编辑器中打开 Window > OZero Security > Config & Dashboard。
2. 在该页面中展开 Build Integrity 部分。
3. 勾选 Require Manifest Signature 复选框。
4. 点击 Generate Key Pair 按钮。
5. OZero 会生成用于 Build Integrity manifest signing 的密钥对。公钥存储在安全设置（Project Settings）中，私钥 默认保存在以下路径（该路径本身按用户保存在 User Settings 中）：
   [ProjectRoot]/OZeroSigningKeys/manifest_private_key.pem
6. 将显示指示私钥位置的确认对话框。点击 OK 关闭它。

重要提示 — 私钥安全

• 私钥文件存储在 Assets/ 文件夹 外部，以防止 Unity 将其打包进构建中。切勿将其移入 Assets/ 中。
• 请将 OZeroSigningKeys/ 从版本控制中排除。使用 Git 时加入 .gitignore，使用 SVN 时加入 svn:ignore。将私钥提交到仓库是严重的安全风险。
• 请将私钥备份到安全位置。任何拥有此文件的人都可以为该项目创建有效的 Build Integrity manifest。
• 如果丢失私钥，已发布的旧构建仍会继续运行。但是下一次更新构建无法再用旧密钥签署新的 manifest。请生成新的密钥对，重新生成 integrity manifest，并通过 clean build 发布更新。公钥、fingerprint、manifest 和 signature 必须互相匹配，否则 Build Integrity 验证可能失败。

自定义私钥路径（CI/CD 和团队环境）

Manifest Signing Private Key Path 字段不是用来选择 Generate Key Pair 生成新密钥的位置。它用于告诉构建和验证工具从哪里读取 PEM 私钥。Generate Key Pair 会在项目默认路径生成密钥，并把该路径记录到 Config 中。对于 CI/CD 或团队构建，请先把同一个 PEM 还原到安全路径，再让此字段指向该路径。

• CI/CD 管道 — 将 PEM 保存为 CI Secret，并在 Unity 构建前还原。构建 runner 不需要长期把私钥保存在磁盘上。
• 团队环境 — 使用只有发布构建负责人或构建 runner 可访问的安全挂载路径或 Secret Manager。所有发布构建机器都必须使用同一个 PEM。

验证现有密钥对

如果要确认磁盘上的私钥是否与 安全设置中保存的公钥一致，请点击 Validate Key Pair。OZero 会从 PEM 重新推导公钥，并与 设置中的公钥比较。如果不匹配，请还原对应的私钥，或生成新的密钥对，然后进行 clean build。

何时应重新生成密钥对

• 当私钥丢失或泄露时。
• Validate Key Pair 报告不匹配（密钥未同步）时。
• 作为既定安全策略的一部分，有意轮换密钥时。

重新生成后，已经发布的旧构建仍会使用自身内置的密钥和 manifest 继续运行。下一次更新构建必须让新的公钥、fingerprint、manifest 和 signature 作为同一套匹配数据使用。请重新生成 integrity manifest，并通过 clean build 发布。

双指纹密钥轮换

点击 Generate Key Pair 按钮后，公钥会保存在安全设置中，同时识别该密钥的 fingerprint 也会记录在 Assets/OZeroSecurity/Scripts/Security/BuildIntegrity/OZeroManifestTrustAnchor.cs 中。运行时 SDK 会先确认 设置中的公钥是否匹配受信任的 fingerprint，然后才接受已签名的 manifest。

当前密钥与旧密钥

ExpectedPublicKeyFingerprintHex 是当前构建使用的密钥 fingerprint。PreviousPublicKeyFingerprintHex 是只在密钥轮换期间使用的辅助槽位。它不能替代 manifest 重新生成，也不是服务端密钥管理功能。安全设置中的公钥、fingerprint、manifest 和 signature 仍然必须基于同一把密钥组成一套匹配数据。

安全的密钥轮换步骤

1. 备份当前指纹。 打开 Assets/OZeroSecurity/Scripts/Security/BuildIntegrity/OZeroManifestTrustAnchor.cs，将 ExpectedPublicKeyFingerprintHex 的值复制到临时记录中。
2. 注册到旧密钥槽。 在同一文件中，将第 1 步复制的值粘贴到 PreviousPublicKeyFingerprintHex 中并保存。
3. 生成新的密钥对。 打开 Window > OZero Security > Config & Dashboard，在 Build Integrity 区域点击 Generate Key Pair。新的公钥和 Expected fingerprint 会自动更新。请保留第 2 步写入的 Previous 值。
4. 重新生成 integrity manifest，并制作 clean build。 新的 manifest 和 signature 必须基于新的私钥生成。
5. 保留更新过渡期。 已发布的旧构建会继续使用自身内置的密钥和 manifest 运行。Previous 槽位是在新构建发布过程中减少回滚或构建产物混用问题的安全措施。对于在线运营游戏，通常可以按 1 到 4 周作为参考。
6. 清空旧密钥槽。 当旧版本的使用量足够低后，将代码改回 PreviousPublicKeyFingerprintHex = ""，再次发布后轮换即告完成。

Previous 槽位的作用

已经发布的旧构建不需要知道新密钥也能继续运行，因为旧构建中已经包含当时的公钥、fingerprint、manifest 和 signature。Previous 槽位是在新的发布线中进行受控密钥轮换时使用的安全措施。只在需要过渡时保留，之后的版本中建议清空。

故障排除

遇到问题时，先按简单顺序检查：没有密钥就执行 Generate Key Pair，已有密钥就执行 Validate Key Pair，然后重新生成 integrity manifest 并制作 clean build。大多数问题来自以下四项之一不同步：私钥 PEM、安全设置中的公钥、OZeroManifestTrustAnchor 中的 fingerprint、生成出的 manifest/signature 文件。

症状 1 — 部署构建在运行后立即退出

ExpectedPublicKeyFingerprintHex 可能为空。发布构建在缺少 fingerprint 时会为了安全直接失败。解决：执行 Generate Key Pair，等待 Unity 重新编译完成后制作 clean build。如果该值已经存在，请执行 Validate Key Pair，并清空构建输出文件夹后重新构建。

症状 2 — 构建刚开始前就提示 "no manifest signing public key is configured" 并中断

当 Project Settings > OZero Security > Build Integrity > Manifest Signing Public Key 为空时触发。解决：打开 Window > OZero Security > Config & Dashboard，在 Build Integrity 区域点击 Generate Key Pair，然后重新构建。

症状 3 — 运行时日志："Manifest signing public key does NOT match the pinned trust anchor fingerprint — APK appears to have been repacked with attacker-controlled keys"

当 安全设置的公钥与 OZeroManifestTrustAnchor 中记录的 fingerprint 不一致时发生。只还原了密钥对的一部分，或手动修改了生成文件时经常出现。解决：执行 Validate Key Pair。如果报告不一致，请还原匹配的 PEM，或生成新的密钥对，然后重新生成 integrity manifest 并制作 clean build。如果只有已发布构建出现此消息，也请确认 APK 或可执行文件是否被重新打包。

症状 4 — 密钥轮换后新构建的 manifest 验证失败

轮换后的密钥数据中可能有一部分仍是旧值。请确认公钥、fingerprint、manifest、signature 是否都基于同一把密钥。解决：只有在需要过渡期时才把旧 fingerprint 保留在 PreviousPublicKeyFingerprintHex，然后依次执行 Validate Key Pair、重新生成 integrity manifest、清理构建输出文件夹、重新进行 clean build。

症状 5 — 本地构建成功，但 CI 构建时提示 "private key not found" 或使用错误的密钥签名

CI 不会自动拥有本地 PC 上的 OZeroSigningKeys/manifest_private_key.pem 文件。解决：将 PEM 保存在 CI Secret 中，并在 Unity 构建前还原到默认路径，或还原到 Manifest Signing Private Key Path 指定的路径。所有发布 runner 都必须使用同一个 PEM，并建议在发布环境中执行一次 Validate Key Pair 进行确认。

Install Source (Android Only) 设置

限制游戏仅在通过已批准的商店或途径安装时才能运行。这有助于防止侧载或重新打包的 APK。

Steam Anti-Piracy (PC Only) 设置

对在 Steam 发售的 PC 端查明 Steam 调用通道、App ID、权限情况、发布档设定。Standard 是局端核实，要想通过 Steam 取得牢固权证唯有依赖 Pro 级别之内的 Steam Attestation 来供给。

Steamworks SDK 文件夹与库的自动复制

在 Project Settings > OZero Security > Steam Anti-Piracy (PC Only) > SDK Folder（或 Check Setup 的 Steam 设置栏）中选择 Steamworks SDK 文件夹（sdk 文件夹或其上级文件夹）。构建时 OZero 会将目标平台对应的 Steam API 库自动复制到构建输出中，无需手动复制。

构建开始前，OZero 会检查库的文件格式、架构以及支持的 Steamworks 版本（SteamApps v008–v009, SteamUtils v009–v010, SteamUser v022–v023），不匹配时构建会停止。复制发生在写入完整性 manifest 之前，因此 Steam 库同样受完整性检查保护。为 macOS 构建签名时，libsteam_api.dylib 上的 Valve 签名会保持不变（macOS 签名）。

其他 PC 与 CI：所选文件夹只保存在该 PC 的 Editor 设置中，不会写入项目文件。在其他 PC 或 CI 上，请重新选择文件夹，或将环境变量 OZERO_STEAMWORKS_SDK 设为 SDK 文件夹路径。两者都没有时，构建会失败并显示说明消息。

仅限桌面：Steam Anti-Piracy 只在 Windows、macOS、Linux 播放器中运行。在开启状态下构建 Android、iOS 或 WebGL 时，构建只会留下警告并继续，该应用不会运行 Steam 检查，也不会包含 Steam 库。此时 Check Setup 会显示 Info 项 Steam Anti-Piracy is skipped for this build target。

与 Steamworks.NET 等封装库一起使用时：如果封装插件放入构建输出的 steam_api 库与所选 SDK 的不同，OZero 会用 SDK 中的库替换它，并在构建日志中留下警告。请将封装库构建时所用的同一 Steamworks SDK 版本指定为 SDK Folder。

Steam 保护的执行级别

只有当 Detection Action 为 Callback 或 Block，且 Response > Force Quit On Detection 已开启时，Steam 违规才会导致游戏终止。该执行级别在构建时封存到 boot 元数据中，终止由原生代码直接执行。如果构建输出中的封存值与安全设置不一致，构建 preflight 会失败，请重新构建。

当设置为 Observe 或 Off、关闭 Force Quit On Detection、开启 forceSteamAntiPiracyObserveOnly、关闭 requireSteamApiInit 或使用 Low 预设时，违规只会被记录，游戏不会终止。这些配置也是允许的，但 Check Setup 的 Steam enforcement 项会显示警告，构建时控制台也会输出警告。若配置会导致终止，同一项会显示 “terminates on detection”。

在在线附加组件中，通过 Check Steam DRM With Server 由服务器判定 Steam 所有权的配置，将按服务器判定流程处理而不是原生终止，本地 Steam 违规会作为观察记录。

设备绑定设置

保存首次信任设备的识别信息，并在后续启动时与当前设备进行比较。可用于发现同一账号或受保护存档是否被移动到其他设备。

运营中的使用方式

在 Pro 中，Device Binding 可以作为运营工具使用。服务器会记录每个许可证对应的设备指纹，因此可以阻断反复出现风险信号的设备，减少简单的许可证共享，并在不禁用整个许可证的情况下支持合法的设备更换。

在游戏中解除绑定

当玩家正当更换设备时，游戏可以通过 RequestReset 清除已保存的指纹。在玩家构建中，SDK 会询问通过 OZeroDeviceBindingDetector.SetResetAuthorizer 注册的授权回调，只有回调返回 true 时才会解除。解除后 SDK 会在同一会话中立即重新绑定当前设备，无需重启。

using OZeroSDK.Security;

// Register once at startup.
OZeroDeviceBindingDetector.SetResetAuthorizer(request =>
{
    // Approve only after your own check succeeds, for example a recent
    // account re-authentication or a support code your server verified.
    return MyAccountService.HasVerifiedResetFor(request.Reason);
});

// Later, from your account recovery or support screen:
bool cleared = OZeroDeviceBindingDetector.Instance?.RequestReset("ticket-1234") ?? false;

在玩家构建中，如果既没有授权回调也没有有效的服务器 Reset Token，解除会被拒绝并记录错误日志。在编辑器中始终会解除。RequestReset 和授权回调会在调用线程上同步执行。ClearStoredFingerprint(token) 仍可使用：配置了 Pro 许可证和服务器设置（服务器 URL、许可证密钥）时，非空令牌会在后台作为服务器 Reset Token 验证，因此解除会在调用返回之后发生；需要结果时，请在主线程上 await ClearStoredFingerprintAsync(token)（见下方流程）。其他情况下由授权回调判断，令牌通过 request.AuthorizationToken 传入。

Standard 游戏的客服处理指南

Standard 没有 OZero 服务器，因此无法使用门户的 Reset Token。请将游戏的客服确认流程直接接入授权回调（SetResetAuthorizer）。从下列方法中选择一种；无论哪种方法，都请按照上方警告，仅在确认通过后让回调返回 true。

A. 游戏有自己的服务器（账号系统）— 推荐

1. 客服在后台为玩家账号签发一次性支持码。
2. 玩家在游戏界面中输入该代码。
3. 游戏先在自己的服务器上异步验证代码。
4. 验证通过后，游戏调用 RequestReset，回调只检查刚才的验证是否通过。

玩家重新登录（平台重新认证）后允许解除的方式也是同样的结构。授权回调同步执行，因此请先完成异步验证，再调用 RequestReset。

bool _supportCodeVerified;

void Start()
{
    // The authorizer runs synchronously: it only reports whether the check just passed.
    OZeroDeviceBindingDetector.SetResetAuthorizer(_ => _supportCodeVerified);
}

async void OnSubmitSupportCode(string code)
{
    // Verify the one-time code issued by your support team on your own backend.
    _supportCodeVerified = await MyBackend.VerifyResetCodeAsync(accountId, code);
    try
    {
        bool cleared = OZeroDeviceBindingDetector.Instance.RequestReset("cs-support");
        ShowResetResult(cleared);
    }
    finally
    {
        _supportCodeVerified = false;
    }
}

B. 没有服务器的离线游戏 — 签名码方式

1. 游戏显示请求码，例如将一次性随机数和游戏自身的存档或玩家 ID 简短编码后的值。
2. 客服返回用只有开发商持有的私钥签名的响应码。
3. 游戏用内置的公钥验证响应，只有签名有效时回调才允许解除。请丢弃用过的随机数，防止同一响应被再次使用。

// Pseudocode. Game: build a request code that the player sends to support.
nonce        = RandomBytes(8)          // keep until the reset is done, then discard
requestCode  = ShortEncode(nonce + yourSaveOrPlayerId)

// Support tool on your side. The private key never ships with the game.
responseCode = Sign(studioPrivateKey, requestCode)          // Ed25519 or ECDSA

// Game: verify with the public key built into the game, then reset.
OZeroDeviceBindingDetector.SetResetAuthorizer(_ => _signedCodeVerified)
_signedCodeVerified = Verify(embeddedPublicKey, requestCode, responseCode)
OZeroDeviceBindingDetector.Instance.RequestReset("cs-offline")
_signedCodeVerified = false
Discard(nonce)

C. 清除应用数据或重新安装

绑定记录保存在应用的本地存储（PlayerPrefs）中。玩家清除应用数据或重新安装应用后，下次启动时会作为新设备注册。本地存档也可能丢失，因此仅在有服务器或云存档的游戏中将此作为客服答复。

D. 减少咨询

将 hardwareChangeTolerance 设为 1 或以上（Standard 预设为 1，Strict 为 0）时，即使因系统更新或隐私设置变更导致某一个识别值变化，也不会拦截，而是重新注册设备。

Pro：请使用门户 Reset Token 和 ClearStoredFingerprintAsync(token)。参见下方的 Reset Token 支持流程。

Reset Token 支持流程（Pro）

1. 先通过正常客服流程确认玩家账号，以及为什么需要重置设备。
2. 进入 Customer Portal → Device Binding，选择目标设备并发放 Reset Token。
3. 令牌只能通过已认证的支持渠道发送。不要留在公开聊天、截图或长期保存的工单中。
4. 游戏或支持界面应在主线程上通过 await OZeroDeviceBindingDetector.Instance.ClearStoredFingerprintAsync(token.Trim()) 传入令牌，并检查返回的 bool。ClearStoredFingerprint(token.Trim()) 也可使用，但服务器检查在后台进行，解除会在调用返回之后发生。
5. SDK 接受令牌后，会在同一会话中立即重新绑定当前设备，无需重启。

Speed & Time Hack 设置

对比 Unity 时间、原生基准时钟、后台计时器以及 Web/Pro 服务器时间，用来检测加速或减速游戏的操控，以及设备时钟变化。WebGL 中无法使用原生时钟对比：启动日志会说明这一点，浏览器时钟篡改（Date.now / performance.now）改由 Injection & Hooking 的 WebGL 运行时检查检测。

使用 OZeroTime.timeScale，而不是 Time.timeScale

启用 Speed & Time Hack 保护模块时，项目代码不得直接修改 Unity 内置的 Time.timeScale。如果绕过 OZero 直接修改，OZero detector 可能会将其视为外部作弊工具造成的可疑运行时时间篡改，并执行已配置的响应策略。

OZeroSecurityConfig.TimeScaleTamperExemptions 是用于登记仍需直接访问 Time.timeScale 的脚本的例外列表。请尽量保持该列表最小化。

仅在现有结构无法避免直接访问 Time.timeScale 时，将例外限制分配给已验证的第三方插件或 legacy adapter script。

除此之外，项目中的所有游戏逻辑都应无例外地优先使用 OZeroTime.timeScale。暂停、慢动作、过场速度控制、倍速播放等游戏内有意变速场景，都必须使用 OZeroTime.timeScale。

using OZeroSDK.Security;

// Correct: the detector knows this is an intentional game-side change.
OZeroTime.timeScale = 0.5f;

// Avoid: this bypasses OZero's expected time-scale tracking.
Time.timeScale = 0.5f;

防止长时间加载时 Watchdog 意外终止应用

OZero 的原生 Watchdog 通过周期性的 heartbeat 确认 Unity 主线程仍在运行。发布版中 heartbeat 期限在所有平台上约为 10 秒(启动宽限期之后)。超过期限时，Watchdog 先查看主线程在做什么：线程被阻塞且不消耗 CPU 的状态(长时间同步加载、日志刷写、磁盘 I/O、虚拟机暂停线程)视为停顿，仅记录；游戏仍在运行却不再发送 heartbeat 则视为篡改，按配置的响应策略终止。停顿超过五分钟的进程按无响应关闭。

大型场景加载、同步资源解压、shader warmup 或 Addressables 准备等正当工作，也可能因为主线程被有意阻塞数秒而触发这种情况。

请使用 OZeroWatchdog.BeginLoadingGrace(maxGraceMs) 包住这类可信加载边界。加载开始时 grace 开始，scope 被 dispose 或调用 End() 时会立即结束，因此不需要提前知道准确的加载时长。

using OZeroSDK.Security;
using UnityEngine.SceneManagement;

public void LoadLargeScene()
{
    using (OZeroWatchdog.BeginLoadingGrace(60000))
    {
        SceneManager.LoadScene("Battle", LoadSceneMode.Single);
        // Grace ends as soon as the using scope exits.
    }
}

public void WarmUpLargeAssets()
{
    OZeroWatchdog.RunWithLoadingGrace(() =>
    {
        BuildLargeRuntimeCache();
    }, 60000);
}

物理黑客检测器

注入检测器设置

检测进入运行中游戏的程序：被注入的原生模块、可执行私有内存、内联挂钩、远程线程式注入、高风险进程句柄以及 WebGL 运行时篡改。正常的覆盖层和录制工具也以同样方式进入游戏，因此检测器通过文件哈希和签名者识别每个模块，并允许逐个模块做出判定。

发现不熟悉的系统模块时，不会立即关闭游戏，而是先记录以供查看。重复出现或文件没有嵌入式签名，都不会单独触发拦截。现有允许规则仍然有效；通过文件哈希明确禁止的模块仍会按策略拦截。请在 Unity 的 Injection 设置中调整此选项，Pro 门户不支持远程修改。此选项不影响其他平台。

检测器如何识别模块

检测器每隔几秒遍历游戏进程中加载的全部模块，并与启动时的集合比较。新模块通过文件哈希识别，在 Windows 和 macOS 上还通过签名证书指纹识别。规则只看模块本身而不看安装目录名称，因此正常程序不会因安装路径而被误判。

每次检查按检测族返回三种结果之一：已检测、扫描后正常或尚未到检查时间。只有真实样本才会改变计数；未执行的检查不会清除先前的检测，完全无法执行的检查会作为扫描器健康问题上报，而不是正常结果。

确认检测后的行为。开启 Force Quit On Detection(Standard、Strict 预设的默认值)时，确认的注入模块会在回调宽限时间结束后关闭游戏，即使 OZeroSecurityReceiver 或回调只记录日志也是如此；在 Windows 上由原生模块监视直接关闭。若只想在游戏代码中处理注入，请关闭 Force Quit On Detection(Low 预设)并在 Receiver 中响应。

Pro 构建。向 Pro 构建注入未签名模块后，许可证服务器会拒绝下一次在线检查(约每 4 分钟一次)。该拒绝属于 Build Integrity 失败，无论 Force Quit On Detection 或回调如何设置，都会关闭游戏。若模块合法，请在门户中允许。

Pro：在门户中允许或阻止检测到的模块

启用 enableServerWhitelist 后，Pro 构建会获取一份签名列表，合并项目在门户中的判定与 OZero 的全局判定。列表会在启动时、设定的轮询间隔以及允许或禁止列表到期前自动更新。

• 列表绑定到您的许可证，并使用许可证服务器密钥(Ed25519)签名。SDK 用其在激活时已信任的同一公钥进行验证。
• 验证过的列表保存在设备上，离线启动时同样生效。验证失败的列表不会被接受，检测本身也绝不会关闭。
• 从未连接过的设备只使用构建中自带的基线信任列表。之后的刷新连上服务器时，会获取并缓存列表。
• 当 OZero 阻止了您项目允许的模块时，门户中的当 OZero 与本项目判定不一致时设置决定以谁为准(默认：OZero)。您项目阻止的模块始终被阻止。
• ABI 21 SDK 还会上报 Windows 和 macOS 模块的代码签名主体(例如 Discord Inc.)，门户可在证书指纹旁显示公司名。iOS 和 Android 模块没有可读的签名者。
• 检测器已发现但尚未处理的模块会以来源 决定前已发现 进入门户的 已观测模块 列表，您可以在任何玩家受影响之前允许或阻止。设备上证书链验证通过的模块显示为 可信签名，此类模块不会被 identity 规则自动关闭，而是等待您的决定。

扫描器不可用(abort code 0x15)

若原生扫描器本身无法运行(配置应用失败、原生扫描反复出错，或 managed/native 契约不一致)，SDK 会上报 ModulationType.InjectionScannerUnavailable(值 10，abort code 0x15，message key injection_scanner_unavailable)，即使关闭了 ForceQuitOnDetection 也会关闭游戏。这不是攻击检测，而是防止悄然损坏的扫描器让游戏失去保护。请向玩家显示 OZ-SEC-15 等支持代码，并在日志中保留 abort code。

PlayerPrefs 加密

对于需要保护的新 key，请使用 OZeroSafePlayerPrefs，而不是 Unity 的 PlayerPrefs。常见的 Get/Set、HasKey、Delete、Save 方法名保持熟悉的形式，但加密数据与已有的普通 PlayerPrefs 数据不兼容。

using OZeroSDK.Security;

// Save a value
OZeroSafePlayerPrefs.SetInt("score", 4200);
OZeroSafePlayerPrefs.SetFloat("volume", 0.8f);
OZeroSafePlayerPrefs.SetString("username", "Hero");

// Read a value
int    score    = OZeroSafePlayerPrefs.GetInt("score", 0);
float  volume   = OZeroSafePlayerPrefs.GetFloat("volume", 1.0f);
string username = OZeroSafePlayerPrefs.GetString("username", "");

存档文件加密

要加密存档文件，请使用 OZeroSV_File 代替 File.ReadAllText / File.WriteAllText。文件在写入时自动加密，在读取时自动解密。加载时还会检查是否被篡改。

using OZeroSDK.Security;

string path = Application.persistentDataPath + "/save.json";

// Write encrypted file
OZeroSV_File.WriteAllText(path, jsonString);

// Read and decrypt file
string json = OZeroSV_File.ReadAllText(path);

4 游戏内变量保护（Secure Types）

Secure Types 会将常规 C# 变量类型替换为加密类型。因为值存储在 Native C++ 堆中，内存扫描器和内存编辑器即使扫描内存也无法找到。只需更改类型名称，其余代码即可照常运行。

示例代码

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using OZeroSDK.Security;

public class PlayerStats : MonoBehaviour
{
    [SerializeField] OZeroSV_Int Gold = 5000;
    [SerializeField] OZeroSV_Float Speed = 3.5f;
    [SerializeField] OZeroSV_Int HP = 1000;
}

支持类型

7 安全事件处理（可选）

默认情况下，当 OZero 检测到威胁时，它会按照配置的响应策略来终止应用或只留存日志。如果您需要直接显示警告屏幕、发送您自己的服务器日志或在退出之前执行保存操作，则可以注册回调。该回调将通过 OZeroSecurityEvent 提供修改类型、中止代码、消息键、详细消息以及是否即将退出等信息。

using UnityEngine;
using OZeroSDK.Security;

public class SecurityHandler : MonoBehaviour
{
    void OnEnable()
    {
        // RegisterUserCallback runs on the user chain only.
        // The built-in default handler runs independently and cannot be silenced.
        OZeroSecurityManager.Instance.RegisterUserCallback(OnThreatDetected);
    }

    void OnDisable()
    {
        OZeroSecurityManager.Instance.UnregisterUserCallback(OnThreatDetected);
    }

    void OnThreatDetected(OZeroSecurityEvent evt)
    {
        // evt contains Type, AbortCode, AbortCodeHex, MessageKey, Message, and WillAbort.
        Debug.LogWarning(
            $"OZero threat: {evt.Type} {evt.AbortCodeHex} {evt.Message}");

        switch (evt.Type)
        {
            case ModulationType.SpeedHack:
                // e.g. kick the player, show warning, report to server
                break;

            case ModulationType.BuildIntegrity:
                // evt.WillAbort is usually true for fatal build integrity violations.
                break;

            case ModulationType.Injection:
                break;
        }

        if (evt.WillAbort)
        {
            // Last chance to flush your own analytics or save state.
        }
    }
}

OZeroSecurityEvent、ModulationType 以及 OZeroAbortCode 的完整列表已记录在 API 参考中。

门户策略回调

Customer Portal 策略可以分阶段运营。Observe 只记录证据，Callback 将服务器下发的 policy action 传递给游戏，Device Block 会在后续服务器验证中阻止选中的设备。在使用更强的设备封禁之前，如需由游戏显示警告、限制匹配、要求重新登录或引导玩家联系支持，请使用 Callback。

using UnityEngine;
using OZeroSDK.Security;

public class PolicyActionHandler : MonoBehaviour
{
    void OnEnable()
    {
        OZeroSecurityManager.Instance.RegisterUserPolicyActionCallback(OnPolicyAction);
    }

    void OnDisable()
    {
        OZeroSecurityManager.Instance.UnregisterUserPolicyActionCallback(OnPolicyAction);
    }

    void OnPolicyAction(OZeroPolicyActionEvent evt)
    {
        Debug.LogWarning(
            $"Policy callback: {evt.Module}, score={evt.Score}, reason={evt.Reason}");

        if (evt.Score >= 80)
        {
            // Show your own UI, limit sensitive actions, or ask the player to reconnect.
        }
    }
}

下一步

现在 OZero 的核心防线已经在为您保驾护航了。翻查文档，全面探究每个接口，类、或控制选项的真谛。

故障排除参考

Use this section when an OZero dialog appears, a security log is reported, or the app closes for a security reason. Start with the code shown on screen or in the log, then follow the first checks below.

Support Codes

Support codes are short labels shown in OZero dialogs and logs. When a player sends this code to support, the development or QA team can quickly identify which broad area to check. OZ-SEC-* means a security event was reported, and OZ-MV-* means an online or managed verification state needs attention.

Abort Codes

Abort codes are stable categories used in logs, callbacks, and OZ-SEC-* support codes. They tell the development team which protection area responded without exposing detailed evidence to the player.

For API fields and callback examples, see OZeroAbortCode & Event Messages.

解决流程