開発者:埋め込み方
接続台の開発者でページウィジェットとログイン換票を対照し、外観をプレビューしてマウントコードをコピーする。
対象:接続台の開発者 · 適用:スピーキング接続台
目標:埋め方 で 2 つの正式な埋め込みを対照する。Origin 登録、キー受領、プレビュー、コードコピー。任意で外観(テーマ token)を調整。
製品側の手順は 自社システムへの埋め込み方、2つの正式な埋め込み。ログインは スピーキング接続台の使い方。公式サイトで開設後、ヘッダーで 開発者 に切り替える。本番 + ログイン換票 のあとも連携と課金のために接続台へログインできるが、受講者 / 公開者へは戻せない。プレビューは「埋め方」の埋め込み見本を使う。
前提
- 開発者 でログイン済み。
- 接続台は見本。本番の連携は自社のバックエンドとフロントで行う。
画面の場所
サイドバー:ホーム / 埋め方 / 通知 / プレビュー / マイ。ホームの主ボタンは 埋め方。4 表面(練習 / 課題 / 記録 / 試験)は プレビュー から開き、日常の下バーには置かない。製品枠はプレビューハブへ。外観と言語は 設定(歯車)。ヘッダーに通知ベルがある。
手順
ページで埋め込み方式を選んでから進める。
ページウィジェット(既定)
- 公開可能キー を受け取る(画面の案内どおりコピー)。
- 自社サイトのアドレスを登録(localhost / ポートを含む)。
- 名簿を取り込み学習者コードを発行(または学習者の自己紐づけを有効化)——人が紐づくまで正式に発話できない。
- プレビュー で先に認人してから試聴。任意で テーマ(主色 / 角丸 / 密度 / バッジ)を調整し、ウィジェットコードを自社ページにコピーする。
- テナント鍵 / 店舗キー をウィジェットスクリプトに書かない。
ログイン換票
- テナント鍵 をコピーする(全文は一度だけ。失くしたら新しい鍵に替える)。ブラウザに置かない。
- Origin を登録。
- 自社サーバー で鍵を使って
embed_tokenを発行し、OralEmbed.mountサンプルを自社ページに貼る(テーマ欄は任意)。 - コード欄 / プレビュー欄はページ内 Tab に従う。プレビューだけが短命チケットを代行発行する(画面が正)。
ページ内プレビューは埋め込んだ結果であり、このシェルをコピーする必要はない。プラン対照とクォータ追加は「プラン対照 / クォータ追加」に折りたたむ。入場条件ではない。
トライアル鍵やサンプルトークンを本番に使わない。本番テナント鍵はサーバーに置く。
外観(テーマ token)
埋め方の プレビュー 横で外観を調整でき、コピーコードに同期する。本番は同じ欄を mount に渡す。詳細は 自社システムへの埋め込み方 の「外観」。外観は学習者の認人や完了突合の代わりにならない。
プランの確認
製品枠 で Lite に切り替えてから試験を開く:入口は残り、リクエストは拒否される。想定どおり。プラン・権限と使用量。
成功の確認
- 自分の localhost で話せる。
- テナント鍵はフロントに無い(ウィジェットは公開可能キーのみ)。
- 完了後、利用量 に今回セッションの 使用時間(分) が出る。