@happyvertical/smrt-资产-本地
S-m-r-t资产运行时间的本地图像处理. 它提取出正态图像
元数据并生成带有 Sharp 的决定性 WebP 变体, 而资产
身份、储存、租赁和出版政策仍为
@happyvertical/smrt-assets。 。 。 .
选择此适配器用于本地开发、 单节点部署和应用程序 需要实际的图像处理,而不需要媒体资产管理服务.
安装
pnpm add @happyvertical/smrt-assets @happyvertical/smrt-assets-local
sharp 由这个适配器安装,而不被拖入 s-m-r-t 核心资产
消费者.
快开始
import { createAssetRuntime } from '@happyvertical/smrt-assets';
import { createLocalAssetProcessor } from '@happyvertical/smrt-assets-local';
const runtime = await createAssetRuntime({
db: 'assets.db',
storage: './data/assets',
capabilityProviders: [createLocalAssetProcessor()],
});
const source = await runtime.storeSourceAsset(
'photo.png',
imageBytes,
{ mimeType: 'image/png', typeSlug: 'image' },
);
const processed = await runtime.processAsset(source, {
variants: [{ variant: 'thumb' }, { variant: 'card' }],
});
console.log(processed.metadata, processed.variants);
处理器将普通元数据保存到源资产并创建 与该来源有关的衍生资产.
标准变体
| 名称 | 大小 | 适应 |
|---|---|---|
thumb | 160x160 (中文(简体) ) | cover |
card | 480×270 (中文(简体) ) | cover |
preview | 960×960 (英语) | inside |
publish | 1200x630 (英语) | cover |
创建处理器时覆盖预设或输出质量 :
const processor = createLocalAssetProcessor({
quality: 85,
variants: {
card: { width: 640, height: 360, fit: 'cover' },
},
});
未知的变种名称必须提供明确的 width 财务报告和审定财务报表 height重复
在源版本和参数时请求重用匹配的衍生资产
没有改变.
元数据
extractAssetImageMetadataFromBuffer() 报告前的定向正常化
维度和返回 MIME 类型、维度、捕获时间、,
和GPS坐标 GPS 值保持足够的精度
附近图片搜索.
非图像资产被明确跳出,以便后来注册的提供者能够 处理他们.
公共 API
| 导出 | 目的 |
|---|---|
createLocalAssetProcessor() | 创建资产能力提供者 |
extractAssetImageMetadataFromBuffer() | 提取正版图像元数据 |
normalizeAssetImageMetadata() | 将原始的Sharp/EXIF元数据规范化 |
LocalAssetProcessorOptions | 配置变体预设和质量 |
发展
pnpm --filter @happyvertical/smrt-assets-local test
pnpm --filter @happyvertical/smrt-assets-local typecheck
pnpm --filter @happyvertical/smrt-assets-local build
见 AGENTS.md 确定性、元数据和提供者边界
所需经费.