已选来源 文件已就绪
上传
本地媒体文件进入受管文件区域，完成上传和处理后即可预览。
- 名称
- 主活动母版
- 受管路径
- 内部磁盘
- 可见性
- 选项示例：Private
- 格式
- 原始格式
云文件管理器
从文件进入系统到投入下一项用途，全程掌握其状态。
文件可以直接上传，也可以来自 Recorder。名称、路径、描述和可见性统一保存在一处，便于预览媒体、在需要其他格式时创建独立的转换副本，或将验证过的文件交给 Restreaming 或 Web Player。文件默认使用内部磁盘；已连接的 Storage 是可选项。
受管文件工作区 文件已就绪
- 受管路径
- 内部磁盘
- 可见性
- 选项示例：Private
- 格式
- 原始格式
一个受管文件，多种后续用途
继续使用已有文件
查看文件记录和媒体、判断是否需要其他格式以及选择下一个产品工作流时，文件来源会始终显示。
01
这个文件来自哪里？进行后续选择时，来源会始终显示
从 上传 继续文件现已进入受管工作流。在更改格式、可见性或目标之前，其记录和媒体都可供检查。
02 · 文件控制
文件记录始终与媒体决策并列显示
此示例遵循产品边界：元数据明确可见，Private 是有意展示的选项，内部磁盘仍为默认位置。
预览已验证主活动母版
- 名称
- 主活动母版
- 受管路径
- 内部磁盘
- 可见性
- 选项示例：Private
03 · 可选转换
只有工作流需要时才创建其他格式
更改格式或转码设置会启动后台重写并生成独立的受管副本，不会替换原始文件。
- 后台重写进度
- 原始文件仍然可用
- 格式
- 保留当前格式
04 · 下一项产品步骤
验证过的文件无需再次上传即可继续使用
File Manager 保留媒体记录；每个下游产品分别管理自己的运行和访问策略。
已连接的 Storage 是选项，而非前提
文件默认使用加密的内部磁盘。工作流需要其他存储层时，Callaba 会注册带有元数据的对象存储，并为受管副本挂载 POSIX 兼容命名空间。
技术规格
云文件管理器技术规格
本表将默认文件行为与可选 Storage 和下游产品选择区分开来。可选格式和设置请以已安装的 Callaba 界面为准。
| 功能 | 支持的行为 | 验证方法 |
|---|---|---|
| 文件来源 | 上传的文件、已完成的录制和其他受管处理结果。 | 有效结果会以预期的来源、名称和受管路径显示。 |
| 默认位置 | 无需配置外部 Storage 即可使用加密的内部磁盘。 | 在添加任何 Storage 前，一次非关键上传或短时录制应能完成、预览并保持可管理状态。 |
| 受管元数据 | 名称、描述、路径、可见性、格式、处理设置，以及可用时的时长、大小和时间戳。 | 保存的记录和最终媒体在身份、时长、大小和格式上应保持一致。 |
| 可见性 | Public 和 Private 是明确的文件记录选项。 | 连接到播放前应检查可见性；播放器授权仍是独立控制项。 |
| 上传 | 二进制上传会显示进度，并为待处理文件记录提供关联 ID。 | 有效上传完成后，Preview 或下游选择才可视为就绪。 |
| 预览 | 可以打开已完成的受管媒体供操作人员检查。 | 实际文件应具有预期的画面、音频、时长和跳转行为。 |
| 输出格式 | 所选处理路径支持时，受管输出类型包括 MOV、MP4、AVI、FLV、MP3、HLS、MKV 和 MPEG-TS。 | 已安装界面中的格式选择器为准；最终结果应符合所选容器和音轨。 |
| 格式重写 | 更改格式或转码设置可启动后台重写，并创建独立的受管副本。 | 处理进度应完成，原始文件应继续保留，新副本应能以指定格式打开。 |
| 处理状态 | 后台工作进程统计可以提供比特率、FPS、媒体时间、速度和进度。 | 完成前进度应持续增加，但最终文件仍需单独打开；仅有运行状态不能验证文件。 |
| Web Player 交接 | 验证过的受管文件可以选为浏览器播放来源。 | 准确的播放器 URL 应能启动、持续播放，并执行各自配置的受众访问控制。 |
| Restreaming 交接 | 受管文件可以选为基于文件的 Restreaming 输入。 | 输出作业应读取预期文件，并将测试过的媒体配置交付到目标。 |
| 可选的已连接 Storage | 对象存储和元数据服务可以注册、格式化并挂载为受管 POSIX 兼容命名空间。 | 一次小型 File Manager 复制应能完成，并可通过已挂载的受管路径读回。 |
| 复制进度 | File Manager 可以将受管文件复制到内部或已配置的外部 Storage，并显示百分比和完成状态。 | 完成状态和目标读回验证后，才可考虑删除源文件。 |
| 静态加密 | 内部磁盘和可选已连接 Storage 上的受管文件采用静态加密；仅有底层原始数据块不会暴露可播放媒体。 | 正常和恢复访问应使用受管元数据和文件路径，而不是原始存储数据块。 |
| 生命周期 API | 已有文档涵盖创建/上传、计数/列出、获取、更新、删除、重写状态、复制和复制进度工作流。 | 在自动化生产媒体前，先用非关键文件验证所需生命周期。 |
| 部署 | 支持 Callaba 云部署或自托管 Linux；容量取决于文件大小、并发处理和存储设计。 | 应使用真实的上传、转换、播放和复制组合，对所选节点和磁盘进行负载测试。 |
部署边界
让文件工作流与媒体部署在一起
Callaba 云部署提供托管式起点。自托管则让基础设施、网络和数据位置继续由团队掌控。
AWS 上的 Callaba
Callaba 节点默认使用加密的内部磁盘；只有工作流需要其他存储层时，才添加已连接的 Storage。
在 AWS 中启动 Callaba自托管 Callaba
应用、加密媒体和任何可选存储连接都位于团队运营的基础设施中。
安装自托管 Callaba为已经确定的文件工作流使用 REST
打开 Files API也可通过 REST 操作受管文件生命周期
先在界面中确认工作流，再通过已有文档的端点完成上传和文件创建、列出与检查、更新元数据、创建转换副本、读取处理状态、复制到可选 Storage 以及删除。
云文件管理器常见问题
Callaba 中的云文件管理器是什么？
上传、录制和处理后的媒体会在云文件管理器中进入受管工作流。文件记录会把路径、描述、可见性、格式、处理状态和后续交接统一关联起来。
使用前必须连接对象存储吗？
不需要。内部磁盘是默认文件位置。已连接的 Storage 是可选项，只有工作流需要其他受管存储层时才添加。
云文件管理器可以更改文件格式吗？
可以。更改格式或转码设置会启动后台重写，并生成独立的转换副本。原始文件仍保留在自己的受管文件记录中，File Manager 会显示新结果的处理进度。
同一个文件可以在 Web Player 和 Restreaming 中重复使用吗？
可以。文件通过验证后，可以作为 Web Player 或基于文件的 Restreaming 工作流的受管输入。具体的交付和受众访问设置仍由各下游作业独立管理。
受管文件是否采用静态加密？
是。Callaba 会对内部磁盘和可选已连接 Storage 中的受管文件进行静态加密。仅访问原始磁盘或底层对象数据块并不能得到可读取的媒体文件；还需要受管元数据和访问路径。
为什么已连接的 Storage 使用 POSIX 兼容层？
Callaba 将对象存储与元数据服务结合，并把结果挂载为受管文件系统命名空间。产品模块可以使用熟悉的文件路径，底层 bucket 则保留为实现细节，不会直接暴露为产品工作流。
Private 可见性可以替代播放器授权吗？
不能。可见性属于受管文件记录。Web Player 授权和受众访问是独立的下游决策，在共享观看 URL 前仍需分别检查。
第一个受管文件
用一个真实文件即可测试完整交接。
先用一次短时上传或录制确认文件记录、可见性、预览和元数据，再测试工作流真正需要的下一步：转换副本、Web Player、Restreaming 或可选 Storage。