已選來源 檔案已就緒
上傳
本機媒體檔案進入受管理檔案區域，完成上傳與處理後即可預覽。
- 名稱
- 主要活動母帶
- 受管理路徑
- 內部磁碟
- 可見性
- 選項範例：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。