嵌入播放器的用途
你可以把本站的粵拼播放器嵌進自己的教材或博客。在這一頁輸入中文，它會轉成粵拼，再產生一段 iframe。播放仍然是向本站拿音節的 mp3。轉換在你的瀏覽器裡做；iframe 只帶着要顯示的字和粵拼參數，不會把你整篇課文送到本站的轉換介面。讀者是從 cantonesepinyin.com 載入播放器的。他們在你網站上讀的其他內容，我們收不到。
字數和音節都有上限，免得一次嵌入得太長。音訊和主站是同一套：每個粵拼音節一段，不是把你那一句訂製成一個人聲。這個網站不是 LSHK 的官方插件，也不對你網站的其他內容負責。iframe 裡的多音字會取常見的讀法，和轉換器一樣。如果要指定另一個讀法，請在教材裡改粵拼，或者連到字典。
這一頁的預覽，就是讀者會見到的播放器。改顯示的文字，看着粵拼更新，滿意了才複製 iframe。各個平台對 iframe 寬嚴不同；如果平台直接把 iframe 拿掉，那是他們的設定，不是轉換悄悄失敗了。不要用一個循環，在頁面載入的時候把所有音節一次請求完。播放應該跟着學生按下才發生。
怎樣嵌入一句
選一句短的：一句招呼、一句急口令，或者三個點心的名字。打字的時候留意字數和音節的上限。把 iframe 貼到教材的 HTML。告訴學生，聲音來自這個網站，用 LSHK 粵拼來標，詞庫是 CanCLID 的 to-jyutping。如果課堂跟的是另一套標準，寫在播放器旁邊。如果「行」需要全部候選，不要把轉換器的第一個讀法當成唯一合法的讀法，請連到字典。
上線之前，用手機和桌上電腦各試一次：播不播得出來、字對不對、缺了的音是不是在預覽裡已經看得到，而不是等到上課才發現。如果音錯了，請電郵那個音節，例如 nei5，不要只寄一張整個後台的截圖。課下架了就刪掉 iframe，免得舊頁面一直在拿音訊。如果學習平台只准放連結，就把學生送到本站的轉換器或一篇博客，不要硬塞 iframe。課文如果很長，請拆開：上限就是為了避免一個元件在載入的時候把一整章的音訊都抓下來。也要告訴學生，聲音是一個一個孤立的音節，不是旁邊那段流利的朗讀。
使用時請注意
這段嵌入碼是給個人教學和博客用的。請不要超量、自動地請求音訊。讀音仍然跟 to-jyutping，多音字取常見的讀法。想改文案，或者回報錯音，請電郵。不要把 iframe 說成 LSHK 的產品、付費課程或證書。
不支持把音訊庫爬下來、打包進 App，或者轉售播放器。工具維持免費，檔案仍然由本站提供。三十人的課堂各自按播放，是正常使用。用腳本通宵把每個音節走一遍，就不是。如果平台的快取讓學生聽到舊的句子，請從這一頁重新產生片段，不要自己改參數。教材頁尾註明音訊來自 cantonesepinyin.com、粵拼跟 LSHK 和 CanCLID 就可以了，不要假冒 LSHK 的標誌。