# @ai-matrx/capture 中文文档

规范地址：https://npmcn.com/package/%40ai-matrx/capture/

版本：0\.6\.85
npm 元数据更新时间：2026-10-28T12:43:06.634Z
中文译文更新时间：2026-11-05T18:55:16.433Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-matrx/capture
原文对照：https://npmcn.com/package/%40ai-matrx/capture/?lang=original
项目主页：https://github.com/AI-Matrix-Engine/aidream/tree/main/apps/shared/capture#readme
源码仓库：https://github.com/AI-Matrix-Engine/aidream

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

- 包体积（解压后）：1.2 MB，30 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：4 个
- peer 依赖：react \>=18\.0\.0，react-dom \>=18\.0\.0
- 首次发布：2026-08-29T18:51:48.898Z
- 最新版本发布：2026-10-28T12:43:06.427Z
- 近 30 天下载量：52225（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：147（近 12 个月 147 个）

## 中文简介

AI Matrx捕获套件:可再用相机染色体,一种生产默认的媒体引擎,可注入主机-运行时端口,云库集成,并进行内浏览器媒体审查和编辑.

## 安装

```sh
npm install @ai-matrx/capture
```

也可以使用：`pnpm add @ai-matrx/capture`、`yarn add @ai-matrx/capture`、`bun add @ai-matrx/capture`

## README

# @ai-matrx/抓获

AI Matrx捕捉套件——作为可再用回放套件的有观点的iPhone风格相机体验.

**歌词法:** 云集是这个系统的作用,而不是附加. `CameraCapture` 需要一个 `CaptureCloudPort` (最近的拇指,图书库打开器,编辑-图像持续). 东道主决定如何到达云层——永远不要.

## 滴入快速启动( 任意反应主机)

不需要媒体运行时间——包装自己的引擎:

```tsx
import { useState } from "react";
import {
  CameraCapture,
  CameraFeed,
  useDefaultCaptureEngine,
  type CaptureMediaItem,
} from "@ai-matrx/capture/react";

export function Camera() {
  const [mode, setMode] = useState<"photo" | "video">("photo");
  const [items, setItems] = useState<CaptureMediaItem[]>([]);

  const add = (file: File, kind: "photo" | "video") =>
    setItems((xs) => [
      ...xs,
      { key: crypto.randomUUID(), kind, src: URL.createObjectURL(file) },
    ]);

  const engine = useDefaultCaptureEngine({
    onPhoto: (f) => add(f, "photo"),
    onVideo: (f) => add(f, "video"),
    onFiles: (fs) => [...fs].forEach((f) =>
      add(f, f.type.startsWith("video/") ? "video" : "photo")),
  });

  return (
    <div style={{ position: "fixed", inset: 0 }}>
      <CameraCapture
        engine={engine}
        preview={<CameraFeed engine={engine} />}
        mode={mode}
        onModeChange={setMode}
        media={{
          items,
          onDelete: (key) => setItems((xs) => xs.filter((x) => x.key !== key)),
          onReplacePhoto: (key, blob) =>
            setItems((xs) => xs.map((x) =>
              x.key === key
                ? { ...x, src: URL.createObjectURL(blob) }
                : x)),
        }}
        cloud={{ recentsThumb: null, onOpenLibrary: () => {/* your gallery */} }}
      />
    </div>
  );
}
```

这就是整条线:电影取景器,刷相取景器(调整手势+邻居) 预装入+分辨率缓存),以替换语义编辑器来进行裁剪/旋转编辑器, 双塔选项网格、计时器、火炬/分区(当硬件报告时), 上传道和安全区处理全部来自包. 主机为 他们自己的相机运行时间( AI Matrx) 通过自定义 `CaptureCameraEngine` 而非默认项目; 持续项目提供 `resolve()` 改为 `src` 和软件包缓存分辨率.

## 里面的东西

-   `CameraCapture` ——所组装的铬:半透明近黑条下充血饲料;上巴(接近-中插槽-火炬-外加-选项);真缩放药丸(只有轨迹能力-无假);VIDEO-PHOTO-UPROAD模式行(上载为一等);最近拇指-快取;翻转;诚实芯片(录制时钟能活出隐藏的铬).
-   `OptionsGridPanel` —— 二塔选项表面 (reveal,后为动作) : Flash (torch), Timer (0/3/10s), Grid, Aspect (full/4: 3/1: 1/16:9), 曝光(当硬件报告一个范围时), 外加被主机注入的瓦片.
-   `ImageEditSheet` ——即时浏览器编辑:收割(free/1:1/4:3/16:9),旋转,翻转;画布再编码出原始像素.
-   `CaptureSheet` ——iOS风格的系统工作表(内容+"繁忙"的瞬态变体).
-   `useTrackControls` • 诚实的火炬/区域/曝光 `MediaTrackCapabilities`。 。 。 .
-   基于槽的可扩展性( N)`CaptureCameraSlots`)——为域名加成(状态芯片,选项牌等附加模式,如SCAN,模式选择器上行,上行)打入的插槽. 无插件框架 .

## 里面没有什么(按设计)

-   **没有强制主机运行时间 .** 软件包包括 `useDefaultCaptureEngine` (仅限) `getUserMedia` 执行情况 `src/engine/`),用于无跑时主机. 现有相机运行时间的 Apps `CaptureCameraEngine`; AI Matrx这样做是为了租赁管理,记录器日记和诊断.
-   **没有网络,没有存储** 由 `src/laws.test.ts`。 。 。 .
-   粘着-介质渲染(hum,灯盒,耐用活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活 `@ai-matrx/media`。 。 。 .
-   仅录音 UX —— `@ai-matrx/browser-audio`。 。 。 .
-   QR 解码是它自己的子路径: `@ai-matrx/capture/qr` (从 `@ai-matrx/kit/qr`; 数据 `jsqr` 折返是懒入的).

默认引擎和注入的主机适配器都通过 `finalizeCapturedVideo`: 已发射/ 最终 Blob MIME 具有权威性, 文件名 扩展匹配,交付持续时间为正整数.

## 用法草图

```tsx
import { CameraCapture } from "@ai-matrx/capture/react";
import type { CaptureCameraEngine, CaptureCloudPort } from "@ai-matrx/capture";

<CameraCapture
  engine={engine}          // host camera runtime adapter
  cloud={cloud}            // REQUIRED — recents thumb, library, save-edited
  mode={mode}
  onModeChange={setMode}
  preview={<YourLivePreview />}
  onClose={close}
  blockedSheet={{ body: <p>…</p>, actions: [...] }}
  slots={{ optionTiles: [...], statusChips: <...>, extraModes: [{ id: "scan", label: "Scan", onSelect: openScanner }] }}
/>
```

参考主机集成为 matrx- 前端 `features/capture-camera/` 商业摄入量表面 `/commerce/intake/v2` 作为工作域扩展的例子.

## 常见问题

### @ai-matrx/capture 是什么？

AI Matrx捕获套件:可再用相机染色体,一种生产默认的媒体引擎,可注入主机-运行时端口,云库集成,并进行内浏览器媒体审查和编辑\.

### 如何安装 @ai-matrx/capture？

在项目目录运行 npm install @ai-matrx/capture，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ai-matrx/capture 支持 TypeScript 吗？

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

### @ai-matrx/capture 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ai-matrx/capture 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ai-matrx/capture 可以商用吗？

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

### @ai-matrx/capture 的下载量有多少？

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

### @ai-matrx/capture 还在维护吗？

最新版本 0\.6\.85 发布于 2026/10/28（8 天前）；至今共发布 147 个版本，其中过去 12 个月发布了 147 个；首次发布于 2026/08/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。