专业版业务流程
宿主页面负责授权、容器和外层业务状态；iframe 负责已开放模块内的生成、编辑与导出。配置决定允许进入哪些模块，事件负责把执行结果传回宿主。
主流程
| 阶段 | 关键动作 | 接入方关注点 |
|---|---|---|
| 页面进入 | 用户进入接入方业务页面，页面准备 iframe 容器 | 容器尺寸、加载态、返回入口 |
| 授权准备 | 接入方服务端通过 /api/grant/otp_code 获取本次加载所需一次性 code | 专业版鉴权，code 有效期5分钟且单次使用，需与用户身份一致 |
| 引入 SDK | 前端页面引入 https://api-static.aippt.cn/aippt-coding.js | 这是专业版专用文件，不要与预装版 UI 的 aippt-iframe-sdk.js 混用 |
| 加载 iframe | 前端调用 AipptAgent.create | 传入 auth.appKey、auth.code、mount.container |
| 模块决策 | SDK 解析 routerOptions.list 和初始化参数 | 不传 list 默认全选；Generate-only 不进入 Editor；Editor-only 必须有 editor.sessionId |
| 初始化结果 | iframe 返回 APP_READY 或 APP_ERROR | 成功后隐藏加载态，失败时展示错误提示 |
| Generate 流程 | 模块开放时新建或恢复生成会话 | 通过 GENERATE_* 同步状态；开启 features.generateApproval 时，先由宿主批准或拒绝；Editor 未开放时隐藏“高级编辑” |
| Editor 流程 | 模块开放时直达或从 Generate 进入 Editor | 通过 EDITOR_*、PPT_SAVE_* 同步状态；Generate 未开放时退出不跳生成页 |
| 导出文件 | 用户触发导出，iframe 返回导出事件 | 接管下载时监听 PPT_EXPORT_* |
| 状态同步 | 接入方记录作品、会话或导出结果 | 刷新业务页面、展示下载入口或错误提示 |
七步跑通主流程
- 准备页面容器
- 获取一次性授权
code - 引入
aippt-coding.js - 选择开放模块并配置
routerOptions - 调用
AipptAgent.create - 监听
APP_READY/APP_ERROR - 按需监听生成、编辑与导出事件
模块分流
routerOptions.list | 初始入口 | 内部操作约束 |
|---|---|---|
| 不传 | 默认 Generate；配置 editor.sessionId 时可直达 Editor | Generate、Editor 均可用 |
['generate'] | Generate 新建态或会话态 | 隐藏“高级编辑”，Editor 操作被拒绝；导出和放映仍由 featureCodes、readonly 控制 |
['editor'] | Editor，必须提供 editor.sessionId | 不渲染 Generate；生成操作被拒绝，退出只发送 EDITOR_EXIT |