嵌入播放器的用途
你可以把本站的粤拼播放器嵌进自己的教材或博客。在这一页输入中文,它会转成粤拼,再产生一段 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 的标志。