跳到主要内容

3 篇博文 含有标签「widgets」

查看所有标签

小部件与年龄验证的移动集成指南

我们更新了文档，以阐明 k-ID 在移动端的集成方式：原生构建年龄门控和同意流程，并将 Web 嵌入保留给年龄验证 URL。

新功能​

年龄门控和端到端小部件的移动端指南​

年龄门控和端到端小部件不推荐用于移动应用。在移动端，请使用自定义工作流并原生构建年龄门控和同意 UX 元素，遵循 CDK UX 指南。

移动端唯一支持的 Web 嵌入是 k-ID API 返回的年龄验证和年龄保证 URL。有关具体端点和挑战类型，请参阅移动应用指南。

重新编写的移动应用指南​

移动应用指南已重新以年龄验证为中心，这是移动端仍推荐使用 Web 嵌入的流程：

默认浏览器方法​

在移动端实现方法下，我们记录了默认外部浏览器方法。它在 Android（Intent.ACTION_VIEW）和 iOS（UIApplication.open）上均可使用，完全支持 AgeKeys，并通过 redirectUrl 回调将焦点返回到您的应用。

设备方向指南​

年龄验证在竖屏方向下效果最佳。由于应用内浏览器界面会继承您应用的方向锁定，锁定横屏方向的应用应在默认外部浏览器中打开验证 URL。浏览器管理自己的方向，因此用户可以旋转到竖屏，并且当流程完成时 redirectUrl 回调会将他们返回到您的应用。

文档更新​

后续步骤​

  • 如果您在移动端集成，请使用自定义工作流和 CDK UX 指南原生构建您的年龄门控和同意 UX
  • 在移动端仅嵌入年龄验证 URL，并对锁定横屏的应用使用默认浏览器方法

Age Gate Widget 重定向 URL 支持

我们已为 Age Gate Widget 端点添加了 redirectUrl 作为可选参数。

新功能​

Age Gate Widget API 更新​

/widget/generate-age-gate-url 端点现在支持在 options 对象中使用可选的 redirectUrl 参数。这允许您指定在 Age Gate Widget 完成后重定向到的 URL，类似于端到端 Widget 端点。

redirectUrl 参数支持 HTTP/HTTPS URL 或具有自定义协议方案的移动端深度链接。

更新的 API​

Widget.ExitReview 澄清和 API 更新

我们已澄清何时关闭年龄验证和 VPC 流程的窗口小部件 UI，并在 MegaWidgetOptions 架构中添加了 redirectUrl 支持。

新功能​

Widget.ExitReview 澄清​

我们已更新文档，明确 Widget.ExitReview 是应确定何时关闭年龄验证和 VPC 流程 UI 的信号。

更新的文档:

  • 年龄验证指南 - 添加了有关监听 Widget.ExitReview 以关闭验证 UI 的指导
  • VPC 指南 - 添加了有关监听 Widget.ExitReview 以关闭 VPC 窗口小部件 UI 的指导
  • CDK 嵌入式流程 - 添加了有关监听 Widget.ExitReview 以关闭窗口小部件 UI 的指导

所有语言版本（英语、日语、简体中文和韩语）均已更新此澄清。

API 更新​

MegaWidgetOptions 中的 redirectUrl​

MegaWidgetOptions 架构现在包含 redirectUrl 支持，与年龄验证请求架构一致。这允许您在使用端到端窗口小部件时指定重定向 URL。

更新的架构:

  • MegaWidgetOptions 现在包含对 #/components/schemas/RedirectUrl 的引用的 redirectUrl 字段

此更改在所有 OpenAPI 规范文件（英语、日语、简体中文和韩语）中可用。

文档改进​

产品图片规格​

为 Compliance Studio 的产品图片添加了推荐的宽高比和分辨率:

  • Logo: 1:1（正方形），512×512px
  • Banner: 3:1（横向），2430×810px