两种正式接入：页面挂件与登录换票
页面挂件与登录换票能力与价格对齐；对照认人集成工作量与写回 LMS 便利性。
受众：对接开发者 / 集成负责人 · 适用：DodoSpeak Oral
目标：选接入方式时看清——两种都是正式接入，口语与按人能力、计费单价相同；差别在你们多做哪一步集成。
步骤见 怎么嵌进你们的系统。术语见 术语表 · Oral。成绩见 如何获取考试成绩与查看记录。
一句话
- 页面挂件：不用改服务器。练习 / 任务 / 考试 /「我的记录」与换票同一档。你们要在接入台 导入名册、发学员码（或让学员 OTP / PIN 自助绑定）；学生 先认人再开口。
- 登录换票：同样能力、同样价格。学生用你们自己的登录；在登录成功旁加一次请求换短时嵌入令牌。身份即你们系统里的人，写回 LMS 最省事。
不要说「挂件不能按人」或「挂件更便宜」。正确说法是：功能与价格对齐；差在谁做认人集成。 Oral 整体相对整站教务 SaaS 更省，与选挂件还是换票无关。
谁适合页面挂件
| 客户形态 | 为何常选挂件 | 挂件还要多做 |
|---|---|---|
| 没有服务器 | 静态站、落地页、只托管 HTML | 贴脚本 + 名册学员码（见下） |
| 有服务器，不能改登录接口 | 机房限制、只许改 CMS | 同上；不碰店钥匙 |
| 已有登录且能改登录旁接口 | — | 更常选 登录换票（写回更顺） |
相同的部分
| 层 | 页面挂件 | 登录换票 |
|---|---|---|
| 嵌入页（练习 / 任务 / 记录 / 考试） | 同一托管页 | 同一托管页 |
| 说话流水线 / 评分 / 考试引擎 | 同一 | 同一 |
| 按稳定学员记账、「我的记录」、老师按人看 Oral 成绩 | 有 | 有 |
| 机构分钟额度、账单单价 | 相同 | 相同 |
| Origin 白名单 | 必须登记 | 必须登记 |
| 本次练习票（嵌入令牌） | 认人后由我们代签（经可发布钥匙 + 学员码） | 客户后端签发 |
| 机构密钥 | 不进页面 | 不进页面（只在客户服务器） |
未完成认人（挂件无学员码会话 / 换票无外部用户 id）时，不能开口、不能考试、不能看个人历史。
差异一览（工作量与身份）
| 能力 / 工作 | 页面挂件 | 登录换票 |
|---|---|---|
| 开口练习 / 点评 / 考试流程 | 有 | 有 |
| 练习、任务、考试、记录按人 | 有（名册学员） | 有（外部用户 id） |
| 学员看自己的历史 | 有（学员码进入后） | 有 |
| 计费单价 | 与换票相同 | 与挂件相同 |
| 客户要不要改服务器 | 不要 | 要（登录旁一次请求） |
| 认人怎么做 | 接入台名册 + 学员码（或 OTP / PIN） | 你们登录态 + 换票 |
| 直接按 LMS 登录号写回成绩册 | 需导出映射或另对接（名册可带学号） | 顺手（同一外部用户 id） |
| 前端凭证 | 可发布钥匙 + 学员认人 | 嵌入令牌 |
一句话：挂件 = 同一套口语与按人能力，认人在接入台侧完成；换票 = 同一套能力与价格，认人在你们登录侧完成。
页面挂件必须多做的工作
选挂件时，除了贴脚本、登记网站地址，还须：
- 在口语接入台 导入名册（姓名，可选学号 / 邮箱）。
- 为每位学员生成 长期学员码 或一人一链二维码，发给学生（贴纸 / 班级群 / 邮件均可）。
- 学生打开你们的挂件页：先扫码或输入学员码，再练习、交任务、考试或查看记录。
- （建议）本机可记住学员；公用电脑提供「退出学员」。
- （可选）某场考试另设开考口令——只作第二道门，不能代替学员码。
老师不便发卡时，可改用学员 邮箱 / 手机验证 或 自设练习 PIN 等自助绑定（仍须在开口前完成）。
没有完成上述认人 = 挂件不能使用（不是引擎坏了，是产品要求按人记账）。
详情与计费口径见接入台设计说明；试用开通后可在 口语接入台 · 如何嵌 对照操作。
钥匙对照
| 凭证 | 用途 | 放哪 |
|---|---|---|
可发布钥匙（如 pk_test_） | 页面挂件在已登记 Origin 使用 | 可进页面脚本（仍须登记 Origin） |
| 学员码 / 自助绑定 | 把会话绑到名册学员 | 发给学生或由学生自助完成；不是手填学号 |
机构密钥 / 店钥匙（如 olk_test_） | 换嵌入令牌、管理类操作 | 只放后端 |
| 嵌入令牌 | 打开某次练习 / 考试会话 | 短时给浏览器 |
可发布钥匙不能代替店钥匙做管理操作；也不能在未认人时开口。
正式开通后：登录换票下的接入台
试用期两种接入都可以在接入台维护名册、分组，并用顶栏切到学员 / 发布人对照。试用期也可在设置里改嵌入方式。
选登录换票并转正式之后，生产认人发生在你们的登录态 + 后端换票，不再靠接入台名册发卡：
| 试用 / 正式+页面挂件 | 正式 + 登录换票 | |
|---|---|---|
| 学员名册、分组 | 可编辑 | 只读查阅，可删除；不能再新建或改成员 |
| 学员、发布人登录接入台 | 可以（含顶栏切换） | 不可以；请从学校系统进入 |
| 管理者、开发者登录接入台 | 可以 | 可以；页顶会提示当前规则 |
| 机构密钥 | 不进页面 | 只放后端 |
转正式前须先选定嵌入方式。若当前是登录换票，套餐页会再确认一次。
试用可在本机构账户里改嵌入方式。正式后本账户锁定，不能自助更换。同一学校要两种方式并存：再开一个 Oral 机构账户（挂件一套、换票一套），用量、钥匙、名册 / 换票身份分开，独立运行。不要指望一个正式机构里两种方式热切换。
详见接入台设计说明；操作见 管理者：设置枢纽、账单与名册、口语接入台怎么用。上线勾选见 要用起来先准备什么。