要用起来先准备什么 · DodoSpeak 帮助中心

受众：采购 / 集成负责人 · 适用：DodoSpeak Oral

目标：上线前先选定嵌入方式，再按方式把套餐、密钥、挂载与完成态列清。试用可改方式；正式锁定。两种都要时另开 Oral 机构账户，独立运行。

先确认 Oral 适合你们，见什么是 DodoSpeak Oral、选 Oral、SaaS 还是私有部署。嵌入方式对照见两种正式接入。

采购要定的

套餐：Speak Lite / Class / Assess / Exam。套餐决定「能不能用任务、记录、考试」，不会把四个入口从界面藏掉。详见套餐、权利与用量。
机构：可先在官网开通口语接入台试用（沙箱）；正式机构与 机构密钥 以商务开通为准（密钥只给后端）。
用量口径：按 50 人档 与计费分钟（详见分钟池与计费）；开通表单填 预估学员规模 用于建议档数；Oral 相对整站 SaaS 同分钟约 2/3 单价。

嵌入方式是上线分叉，不是另一档价格：页面挂件与 登录换票 能力与价格相同。试用可在接入台来回切；转正前再锁死。两种都要 → 再开一个 Oral 机构账户。见下文与两种正式接入。

集成要准备的

按这个顺序做，不必一次做完。

选定页面挂件或登录换票（分叉点）
无服务器 / 不能改登录 → 页面挂件（须名册学员码）。已有登录、要按学号写回 LMS → 登录换票。对照两种正式接入。
试用可改；正式后本机构账户锁定，不能自助更换。两种都要：新开一个 Oral 机构账户，同一学校可以挂两个账户（挂件一套、换票一套），用量、钥匙、名册/换票身份分开，独立运行。不要写成一个正式机构里两种方式热切换。
凭证（按已选定的方式）
- 换票：用 机构密钥 在你们服务器换 嵌入令牌。禁止把机构密钥放进浏览器、App 包或前端仓库。
- 挂件：使用 可发布钥匙，登记 Origin，并完成 名册学员码（或 OTP/PIN）；店钥匙仍不要进页面。
前端挂载
页面放容器，引入嵌入脚本，调用 OralEmbed.mount。表面可选练习 / 任务 / 记录 / 考试（须套餐允许）。可传 主题 token 做外观个性化。见怎么嵌进你们的系统。
完成态与成绩以 API 为准
嵌入页会回调「看起来完成了」；成绩、是否交卷、用量请再调你们后端，由后端问 Oral API（或收 Webhook）。见如何获取考试成绩与查看记录。
安全与域名
登记允许嵌入的 Origin；按需配 CSP / iframe 祖先。麦克风权限由浏览器向学生要。
（可选）先上接入台对照
官网开通试用（含预估学员规模）→ 登录口语接入台，走一遍学员 / 发布人 / 管理者 / 开发者（管理者见管理者：设置枢纽、账单与名册）。试用期可在设置里切换嵌入方式。不要把这四角色写成你们生产系统的角色。

上线前清单

先勾选嵌入方式，再只做该路径的清单。共用项两种都要勾。

先选定嵌入方式

已选定 页面挂件 或 登录换票（对照两种正式接入）
已理解：试用可改；正式后本账户锁定
若两种都要：已另开 Oral 机构账户，两套独立运行（不要共用一把店钥匙、同一份名册当唯一身份源）

共用（无论哪种）

套餐与合同用量口径已确认
至少一个表面 OralEmbed.mount 成功开口
Origin / CSP 已按生产域名登记
完成态 / 成绩已用 API 对账（若需要写回）
套餐不足时的提示已设计（接口会拒绝，按钮仍可看见）

仅页面挂件

名册就绪，能发学员码（或 OTP / PIN）
使用 可发布钥匙；机构密钥不进页面
学员能先认人（扫码 / 输码）再开口

仅登录换票

机构密钥只在服务端
能签发并刷新短时 嵌入令牌
外部用户 id 与 LMS 学号对齐

「能签发短时令牌」只属于换票。挂件是认人后由平台代签，不要两边都勾。