开发者：如何嵌
接入台开发者对照页面挂件与登录换票、预览个性化并复制挂载代码。
orallabdeveloper
受众：接入台开发者 · 适用：口语接入台
目标：在「如何嵌」页按两种正式接入对照样例：登记 Origin、领取钥匙、预览、复制代码；可选调节外观（主题 token）。
产品路径见 怎么嵌进你们的系统、两种正式接入。登录见 口语接入台怎么用。在官网开通后，顶栏切到 开发者。正式 + 登录换票 后仍可登录接入台做集成与计费，但不能再切到学员 / 发布人；预览请用「如何嵌」里的嵌入样例。
前置条件
- 已按 开发者 身份登录。
- 理解：接入台是样板，生产集成发生在你们自己的前后端。
界面在哪
侧栏：首页 / 如何嵌 / 通知 / 预览 / 我的。首页主按钮是 如何嵌。四个表面（练习 / 任务 / 记录 / 考试）可在 预览 打开，不占日常底栏。产品档等进预览枢纽。外观与语言在 设置（齿轮）。顶栏有通知铃铛。
步骤
页上先选接入方式，再按步做：
页面挂件（默认）
- 领取 可发布钥匙（按页说明复制）。
- 登记你们网站的地址（含 localhost / 端口）。
- 导入名册并发学员码（或启用学员自助绑定）——未认人不能正式开口。
- 在 预览 中先完成认人再试听；可调 主题（主色 / 圆角 / 密度 / 角标），再复制挂件代码到你们页面。
- 不要把 机构密钥 / 店钥匙 写进挂件脚本。
登录换票
- 复制 机构密钥（明文只出现一次；丢了再换一把）。禁止写进浏览器。
- 登记 Origin。
- 在你们服务器用密钥换
embed_token，再把OralEmbed.mount样例贴到你们页面（可带主题字段）。 - 代码区 / 预览区按页内 Tab 使用；预览才会代换短时票（以界面为准）。
页内预览是嵌进去的效果，不是要你们抄这个壳。套餐对照、加配额折在「对照套餐 / 加配额」里，不是进门条件。
不要把试用钥匙或示例令牌用于生产。正式机构密钥永远留在服务器。
个性化（主题 token）
在如何嵌 预览 旁可调外观，并同步进复制代码。生产用同一套字段传给 mount。详见 怎么嵌进你们的系统「个性化」。外观个性化不能代替学员认人或完成态核对。
套餐对照
切换到 Lite 后再打开考试：入口仍在，请求会被拒绝。这是预期，见 套餐、权利与用量。
如何确认成功
- 自己的 localhost 能开口。
- 机构密钥没有出现在前端（挂件只用可发布钥匙）。
- 结束后，用量里能看到本次会话的 使用时间（分钟） 记录。