# @corti/dictation-web 中文文档

规范地址：https://npmcn.com/package/%40corti/dictation-web/

版本：0\.9\.1
npm 元数据更新时间：2026-10-06T10:47:14.235Z
中文译文更新时间：2026-11-10T20:07:01.816Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40corti/dictation-web
原文对照：https://npmcn.com/package/%40corti/dictation-web/?lang=original
项目主页：https://docs.corti.ai/sdk/dictation
源码仓库：https://github.com/corticph/speech-web-components

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2 MB，177 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2025-03-05T09:49:23.470Z
- 最新版本发布：2026-10-06T10:47:13.916Z
- 近 30 天下载量：6436（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：103（近 12 个月 58 个）

## 中文简介

Corti Dictation 的网络组件

## 安装

```sh
npm install @corti/dictation-web
```

也可以使用：`pnpm add @corti/dictation-web`、`yarn add @corti/dictation-web`、`bun add @corti/dictation-web`

## README

# @corti/起诉-web

[![Published on npm](https://img.shields.io/npm/v/@corti/dictation-web.svg?logo=npm)](https://www.npmjs.com/package/@corti/dictation-web) [![License: MIT](https://img.shields.io/npm/l/%40corti%2Fdictation-web)](https://opensource.org/licenses/MIT) [![Get Support on Discord](https://img.shields.io/badge/Discord-Get%20Support-5865F2.svg?logo=discord&logoColor=fff)](https://discord.com/invite/zXeXHgnZXX) [![Live Demo](https://img.shields.io/badge/Live%20Demo-blue.svg?logo=rocket&logoColor=fff)](https://codepen.io/hccullen/pen/OPJmxQR)

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

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

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

用于多语种环境流, 使用 [校对:soup](https://www.npmjs.com/package/@corti/ambient-web) 换句话说.

## 安装

```bash
npm i @corti/dictation-web
# yarn add @corti/dictation-web
# pnpm add @corti/dictation-web
```

```js
import "@corti/dictation-web";
// or: import { CortiDictation } from "@corti/dictation-web";
```

CDN( 只快速尝试) :

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

## 快开始

```html
<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>
```

## 模块布局

```html
<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>`数字 :

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

## 文档

-   [拼接网络组件(完整指南)](https://docs.corti.ai/sdk/dictation/overview)
-   [API 参考](https://docs.corti.ai/sdk/dictation/reference)
-   [认证](https://docs.corti.ai/sdk/dictation/authentication)
-   [样式](https://docs.corti.ai/sdk/dictation/styling)
-   [代理设置](https://docs.corti.ai/sdk/dictation/proxy)
-   [实例](https://github.com/corticph/corti-examples/tree/main/dictation)

## 仓库

来源和问题跟踪: [github.com/corticph/ditation-web (中文(简体) )](https://github.com/corticph/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 和提交记录判断。