@corti/dictation-web

中文文档
0.9.1发布于 2026/10/06MITTypeScriptES Module构建来源已验证近 30 天下载 6436

Corti Dictation 的网络组件

中文使用文档
文档目录6 节
  1. 安装
  2. 快开始
  3. 模块布局
  4. 密钥绑定
  5. 文档
  6. 仓库

@corti/起诉-web

Published on npm License: MIT Get Support on Discord Live Demo

Corti Translacy API上用于实时,单口语拼音的Web组件.

  • 全能无相: <corti-dictation> ——记录按钮,设置,键盘快捷键和主题
  • 模块 : <dictation-root> 加号 <dictation-recording-button>, (中文(简体) ), <dictation-settings-menu>,并选择自定义布局

说明: OAuth 2.0 认证不由此库处理 。 客户端在使用组件时必须提供授权令牌或令牌刷新功能.

用于多语种环境流, 使用 校对:soup 换句话说.

安装

npm i @corti/dictation-web
# yarn add @corti/dictation-web
# pnpm add @corti/dictation-web
import "@corti/dictation-web";
// or: import { CortiDictation } from "@corti/dictation-web";

CDN( 只快速尝试) :

<script type="module" src="https://cdn.jsdelivr.net/npm/@corti/dictation-web/dist/bundle.js"></script>

快开始

<corti-dictation id="dictation"></corti-dictation>
<textarea id="transcript" placeholder="Transcript will appear here..."></textarea>

<script type="module">
  import "@corti/dictation-web";

  const dictationEl = document.getElementById("dictation");
  const transcriptEl = document.getElementById("transcript");

  dictationEl.addEventListener("ready", () => {
    dictationEl.accessToken = "<your-access-token>";
  });

  dictationEl.addEventListener("transcript", (e) => {
    if (e.detail.data.isFinal) {
      transcriptEl.value += `${e.detail.data.text} `;
    }
  });
</script>

模块布局

<dictation-root id="dictationRoot">
  <dictation-recording-button></dictation-recording-button>
  <dictation-settings-menu settingsEnabled="device,language,keybinding"></dictation-settings-menu>
</dictation-root>

<script type="module">
  import "@corti/dictation-web";

  const root = document.getElementById("dictationRoot");
  root.addEventListener("ready", () => {
    root.accessToken = "<your-access-token>";
  });
</script>

模块组件需要 <dictation-root> 作为父母。 他们通过Lit语境分享状态.

构成部分作用
<dictation-root>上下文提供者(自动、配置、设备、密钥绑定)
<dictation-recording-button>启动/ 停止音频可视化
<dictation-settings-menu>设备、语言和密钥绑定 UI
<dictation-device-selector>设备滴入
<dictation-language-selector>语言下降
<dictation-keybinding-selector>推到对讲 / 切到对讲键

密钥绑定

默认 : 输入 (笑声) (笑声), 空间 (呼为口. 关键名称( E)event.key)和代码(event.code) 得到支持。 在输入焦点时忽略快捷键 。 如果两个模式都使用相同的密钥,则切换到对讲机获胜.

配置于 <corti-dictation> 或者说 <dictation-root>数字 :

<corti-dictation toggleToTalkKeybinding="`" pushToTalkKeybinding="Space"></corti-dictation>

文档

仓库

来源和问题跟踪: github.com/corticph/ditation-web (中文(简体) )

版本与发布记录

@corti/dictation-web 共发布 103 个版本,首次发布于 2025/03/05;过去 12 个月发布了 58 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.9.1latest2026/10/061 个月前
0.9.1-rc.2rc2026/10/061 个月前
0.9.1-rc2026/10/061 个月前
0.9.02026/08/192 个月前
0.0.0-languages.4languages2026/08/192 个月前
0.0.0-languages.32026/08/192 个月前

其他发布通道:test → 0.0.0-test.8,ambient → 0.7.0-ambient.19,languages → 0.0.0-languages.4,rc → 0.9.1-rc.2。

关于 @corti/dictation-web 的常见问题

@corti/dictation-web 是什么?

Corti Dictation 的网络组件

如何安装 @corti/dictation-web?

在项目目录运行 npm install @corti/dictation-web,或使用 pnpm add / yarn add / bun add。

@corti/dictation-web 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@corti/dictation-web 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@corti/dictation-web 可以商用吗?

@corti/dictation-web 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@corti/dictation-web 的下载量有多少?

根据 npm 官方下载统计,@corti/dictation-web 在 2026/10/11 – 2026/11/09 这 30 天内被下载 6,436 次,日均约 215 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@corti/dictation-web 还在维护吗?

最新版本 0.9.1 发布于 2026/10/06(1 个月前);至今共发布 103 个版本,其中过去 12 个月发布了 58 个;首次发布于 2025/03/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。