What the embed is for
Put this site’s Jyutping player on your lesson or blog. You type Chinese here; the page turns it into Jyutping and builds an iframe. Play still fetches syllable mp3 files from this host. Conversion runs in your browser. The iframe only carries the display text and Jyutping parameters; it does not send your whole article to a conversion API. Your readers load the player from cantonesepinyin.com. We do not receive the rest of the page they were reading.
There is a cap on characters and syllables so one embed cannot run on forever. Audio is the same set as the main site: one recording per Jyutping syllable, not a custom voice of your sentence. This is not an official LSHK plugin, and we are not responsible for the rest of your page. If a polyphonic character takes the common reading in the iframe, that is the same behaviour as the converter. To force another reading, edit the Jyutping you need in a lesson note, or link the dictionary.
The preview on this page is the same player your readers will see. Change the display text, watch the Jyutping update, copy the iframe when it looks right. Hosts differ in how they allow iframes; if your platform strips them, that is their setting, not a silent conversion failure. Do not wrap the player in a loop that requests every syllable on page load. Play should follow a student tap. Width and height in the snippet are a starting size; your CSS may crop the controls if you squeeze the iframe. Leave room for the text line. If you translate the display text into English but leave Jyutping for Cantonese, say so in the caption so students are not surprised when play does not match the English words.
How to embed a line without surprising anyone
Pick a short line: a greeting, a tongue twister, three dim-sum names. Stay under the character and syllable caps shown as you type. Paste the iframe into a lesson HTML block. Tell students the sound files come from this site, labelled in LSHK Jyutping, using CanCLID to-jyutping. If your class follows a different standard, say so next to the player. If you need every candidate for 行, do not embed the converter’s first pick as if it were the only legal reading; link the dictionary.
Test the embed on a phone and on a desktop before you ship the lesson. Check that play works, that the text is the text you meant, and that a missing syllable fails loudly in your preview rather than in class. When a sound is wrong, email the syllable (nei5, not a screenshot of your whole CMS). When you take the lesson down, remove the iframe so old pages do not keep fetching audio. If your LMS only allows a link, send students to this site’s converter or to a blog post instead of fighting the iframe. If you need a long passage, split it: the cap exists so one widget cannot request an entire chapter of audio on load. Tell students the voice is isolated syllables, not a fluent reading of the paragraph they see beside it.
Please use it gently
The snippet is for personal teaching and blogs. Do not hammer the audio endpoint. Readings still follow to-jyutping; polyphonic characters take the common reading. To change copy or report a bad sound, email us. Do not present the iframe as an LSHK product, a paid course, or a certificate.
We do not support scraping the audio library, bundling the files into an app, or reselling the player. The tools on this site stay free; the files are still this site’s to serve. A classroom of thirty each tapping play is ordinary use. A script that walks every syllable overnight is not. If your host caches the iframe aggressively and students hear a stale line, rebuild the snippet from this page rather than editing the query by hand. Attribution in a lesson footer (“audio: cantonesepinyin.com, Jyutping via LSHK / CanCLID”) is enough; a fake LSHK logo is not.
Independently maintained. The embed is a window onto this host, not a download of the library. Sources and contact: About · Contact