開發者：如何嵌
接入台開發者對照頁面掛件與登入換票、預覽個性化並複製掛載代碼。
orallabdeveloper
受眾：接入台開發者 · 適用：口語接入台
目標：在「如何嵌」頁按兩種正式接入對照樣例：登記 Origin、領取鑰匙、預覽、複製代碼；可選調節外觀（主題 token）。
產品路徑見 怎麼嵌進你們的系統、兩種正式接入。登入見 口語接入台怎麼用。在官網開通後，頂欄切到 開發者。正式 + 登入換票 後仍可登入接入台做整合與計費，但不能再切到學員 / 發布人；預覽請用「如何嵌」裡的嵌入樣例。
前置條件
- 已按 開發者 身份登入。
- 理解：接入台是樣板，生產整合發生在你們自己的前後端。
介面在哪
側欄：首頁 / 如何嵌 / 通知 / 預覽 / 我的。首頁主按鈕是 如何嵌。四個表面（練習 / 任務 / 記錄 / 考試）可在 預覽 開啟，不佔日常底欄。產品檔等進預覽樞紐。外觀與語言在 設定（齒輪）。頂欄有通知鈴鐺。
步驟
頁上先選接入方式，再按步做：
頁面掛件（預設）
- 領取 可發佈鑰匙（按頁說明覆制）。
- 登記你們網站的地址（含 localhost / 端口）。
- 匯入名冊併發學員碼（或啟用學員自助綁定）——未認人不能正式開口。
- 在 預覽 中先完成認人再試聽；可調 主題（主色 / 圓角 / 密度 / 角標），再複製掛件代碼到你們頁面。
- 不要把 機構密鑰 / 店鑰匙 寫進掛件腳本。
登入換票
- 複製 機構密鑰（明文只出現一次；丟了再換一把）。禁止寫進瀏覽器。
- 登記 Origin。
- 在你們伺服器用密鑰換
embed_token，再把OralEmbed.mount樣例貼到你們頁面（可帶主題欄位）。 - 代碼區 / 預覽區按頁內 Tab 使用；預覽才會代換短時票（以介面為準）。
頁內預覽是嵌進去的效果，不是要你們抄這個殼。套餐對照、加配額折在「對照套餐 / 加配額」裡，不是進門條件。
不要把試用鑰匙或範例令牌用於生產。正式機構密鑰永遠留在伺服器。
個性化（主題 token）
在如何嵌 預覽 旁可調外觀，並同步進複製代碼。生產用同一套欄位傳給 mount。詳見 怎麼嵌進你們的系統「個性化」。外觀個性化不能代替學員認人或完成態核對。
套餐對照
切換到 Lite 後再開啟考試：入口仍在，請求會被拒絕。這是預期，見 套餐、權利與用量。
如何確認成功
- 自己的 localhost 能開口。
- 機構密鑰沒有出現在前端（掛件只用可發佈鑰匙）。
- 結束後，用量裡能看到本次會話的 使用時間（分鐘） 記錄。