跳转到主要内容

已知问题

  • CSP 阻止 SDK 加载 — 若缺少必要的 CSP 指令(worker-srcscript-src 等),Web SDK 将无法加载 Web Workers 及其他资源。查看 CSP 配置

  • 在 iFrame 外调用 prepareSelfieCameraForIFrame 会返回错误 73724 — iFrame 方法仅在 iFrame 内部有效。非 iFrame 环境请使用 prepareSelfieCamera,反之亦然。

  • iPhone 上的全屏受到限制 — Apple 仅在 iPhone 上限制全屏 API 的使用(iPad 不受此限制)。在 iPhone 上进行采集时,需手动配置 iFrame 的定位。

  • 父级 CSS 导致 frame 变形 — 包含 grid 组件的设计系统(Bootstrap、Material-UI 等)可能会干扰采集 frame。请将 frame(id="box-camera")放置在不会继承多余 CSS 规则的位置。

  • Web Mobile 上智能摄像头在 frame 非 100vw/100vh 时失效 — 在移动端,采集 frame 必须占据设备屏幕的 100%,否则计算机视觉算法可能出现问题。

  • 带交互的活体检测在社交媒体 WebView 中不可用 — 无交互活体检测已在 Instagram 和 Facebook WebView 中通过审核;交互式版本不支持。