32 lines
1.2 KiB
Plaintext
32 lines
1.2 KiB
Plaintext
|
---
|
||
|
|
title: 概览
|
||
|
|
description: 了解 Media 包、存储边界以及它负责的媒体工作流。
|
||
|
|
order: 1
|
||
|
|
toc:
|
||
|
|
- id: package-role
|
||
|
|
title: 包的职责
|
||
|
|
- id: capabilities
|
||
|
|
title: 功能范围
|
||
|
|
- id: design-boundary
|
||
|
|
title: 设计边界
|
||
|
|
---
|
||
|
|
|
||
|
|
## 包的职责 {#package-role}
|
||
|
|
|
||
|
|
`@workspace/media` 提供可复用的媒体库和资源选择界面。宿主应用通过 `MediaAdapter` 提供持久化能力；Media 负责浏览、筛选、分页、上传、目录、选择和资源操作。
|
||
|
|
|
||
|
|
## 功能范围 {#capabilities}
|
||
|
|
|
||
|
|
- 通过搜索、筛选、目录、收藏和分页浏览图片与视频。
|
||
|
|
- 上传到 Adapter 暴露的本地或云端存储目标。
|
||
|
|
- 创建、重命名、嵌套和删除分类目录。
|
||
|
|
- 通过 `MediaPickerDialog` 单选或多选资源。
|
||
|
|
- 分别解析展示 URL 和稳定引用。
|
||
|
|
- 提供 `en-US` 与 `zh-Hans` 消息词典。
|
||
|
|
|
||
|
|
## 设计边界 {#design-boundary}
|
||
|
|
|
||
|
|
Media 不会替应用选择 API、数据库、对象存储、CDN 或签名策略。应用在 `MediaAdapter` 后实现这些决策，替换实现时无需修改界面组件。
|
||
|
|
|
||
|
|
> 目录只用于媒体库内部分类，不必对应对象存储路径，也不需要改变公开 URL。
|