SDK 鉴权说明
SDK 2.x 根据浏览器打开的宿主页面和 auth.appId 决定如何鉴权。
| 宿主页面 | 省略 auth.appId | 填写 auth.appId |
|---|---|---|
本地 HTML 文件(file://) | 可直接使用 | 请改用本地 HTTP 服务联调域名白名单 |
本地服务(localhost、127.0.0.1) | 可直接使用 | 校验应用和宿主主机名 |
| 公网或局域网地址 | 必须填写 auth.appId,不可省略 | 校验应用和宿主主机名 |
注册和本地联调
- 在开放平台控制台创建应用,复制应用 ID。
- 将浏览器实际访问的宿主主机名添加到该应用的域名白名单。本地开发可添加
localhost,再用http://localhost:5173打开页面。白名单校验使用主机名,端口和路径不参与匹配。 - 在调用
createEditor或createPresentation时传入auth: { appId: 'YOUR_APP_ID' },等待初始化完成。配置不匹配时,初始化会返回错误。 - 发布前,将生产环境的主机名也加入应用白名单,并通过部署地址验证。Agent 的公网或局域网预览地址同样按浏览器实际打开的主机名校验。

排查鉴权失败
- 缺少
appId时,检查宿主地址,并确认auth.appId已传给正确的模式。通过统一的create入口时,将auth放在editor或presentation配置里。 - 白名单未命中时,核对
appId对应的应用和浏览器地址栏中的主机名。localhost和127.0.0.1需要分别匹配。 - 使用
file://时,如果要验证应用授权,请用本地 HTTP 服务打开页面后重试。