UUID API

通过附加到 WebView URL 或经由 JavaScript 获取的唯一 UUID 来识别应用安装。

WebViewGold UUID API 允许您获取一个非个人化的唯一设备 ID（UUID，即 “Universally Unique Identifier”，通用唯一标识符），可用于唯一标识一台 iOS 设备。此功能适用的场景包括：

• 在服务器端存储用户特定设置
• 维护会话状态
• 在客户端读取已保存的数据

隐私提示：使用此功能时，请确保遵守当地及国际的隐私法律法规，因为它涉及设备识别。

如何获取 UUID：

如需在基于 WebView 的应用中获取 UUID，请使用以下代码：

<a href="get-uuid://">Get UUID</a>
<a href="#" onClick="alert(uuid);">Show UUID</a>
                    

• Get UUID：向 WebViewGold 请求 UUID。
• Show UUID：通过 alert 弹窗显示 UUID，方便测试。

替代方式：将 UUID 追加到 WebView URL

如果您希望将 UUID 包含在 URL 参数中，请在 Config.swift 中启用 enhanceUrlUUID 选项，并将其设置为 true。这样，在首次请求时会自动向 WebView URL 追加 uuid=XYZ，让您可以直接在 Web 内容中获取 UUID：

• 示例：如果您的 WebView URL 为 https://www.example.org，则实际请求将变为 https://www.example.org?uuid=XYZ。
• 注意：仅首次 URL 请求会包含此 GET 参数，因此如果您需要在应用中稍后再引用它，请考虑将其保存到会话或 Cookie 中。

自动将 UUID 注入到 JavaScript：

要在所有页面中自动使 UUID（以及其他变量）在 JavaScript 中可用，而无需修改 URL，请在 Config.swift 中将 autoInjectVariable 设置为 true。这样，您就可以在任何页面中直接访问 UUID 及其他值。