兩種正式接入：頁面掛件與登入換票
頁面掛件與登入換票能力與價格對齊；對照認人整合工作量與寫回 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 機構帳號（掛件一套、換票一套），用量、鑰匙、名冊 / 換票身份分開，獨立運行。不要指望一個正式機構裡兩種方式熱切換。
詳見接入台設計說明；操作見 管理者：設定樞紐、帳單與名冊、口語接入台怎麼用。上線勾選見 要用起來先準備什麼。