File Manager 受管理檔案範例
- 名稱
- 已驗證的活動錄製
- 路徑
- 受管理檔案路徑
- 可見性
- 選項範例：Private
- 輸出格式
- 除非需要其他格式，否則保留目前格式
Video Stream Recorder
錄製即時輸入，並驗證完成的檔案。
選擇 Callaba 可接收的輸入，包括 SRT、RTMP、RTSP、NDI 或視訊房間。將一個連續檔案或定時分段錄製到加密的內部磁碟，再到 File Manager 開啟結果。檢查可見性，依需求建立獨立的轉換副本；只有工作流程需要時才加入已連接的 Storage。
支援的輸入 Recorder 已就緒
從單一來源到完成檔案
在整個錄製工作流程中追蹤所選來源
在下方選擇來源。選取檔案模式、選用處理與檔案檢查時，該來源會持續顯示。
01
選擇來源Recorder 使用 Callaba 的共用輸入模型
已選輸入 已接入來源
SRTRecorder 可以使用 Callaba SRT Server、Route 或明確的 SRT URL。已接入的串流會直接進入錄製工作，不需變更貢獻傳輸設計。
- 輸入類型
- 受管理來源 + URL
- Recorder 狀態
- 可開始設定
繼續使用 SRT選擇其他來源前，此來源會保持選取。下一步設定 Recorder 建立檔案的方式，不需要中介協定轉換。
02 · 檔案原則
一個連續檔案或定時分段
連續檔案與定時分段適用於不同的復原及保留計畫。驗證檔案時，所選模式會持續顯示。
03
媒體處理是選用項目傳入媒體已符合目標檔案需求時，請關閉處理
來源SRT
模式連續檔案
處理直接傳遞相容媒體
檔案保留前檢查檔案
已選擇 連續檔案連續錄製仰賴正常停止與檔案完成。先用短檔案完成檢查，再讓同一工作連續執行數小時或數天。
04 · 驗證清單
追蹤 SRT：從執行進度到可開啟的檔案
執行狀態很有用，但不能證明檔案有效。四項檢查會串連輸入、Recorder 程序、完成的媒體及其 File Manager 記錄。
- 01來源
所選 SRT 輸入具有預期的畫面、音訊、識別資訊與位元率。
- 02Recorder 程序
FPS、位元率、媒體時間、速度與進度顯示錄製持續進行。
- 03完成的檔案
連續檔案 輸出可以開啟，且具有預期的時長、時間戳記、畫面與音訊。
- 04File Manager 記錄
完成的錄製會顯示在 File Manager 中，並具有預期的名稱、受管理路徑、可見性與格式。
已審查的輸出類型
MP4MKVMPEG-TSHLS相容的音訊/檔案格式
05 · 檔案控制
錄製結束後，由 File Manager 接續工作流程
Recorder 會將完成結果寫入內部磁碟，並把受管理檔案記錄交給 File Manager。您可以在其中命名檔案、檢查可見性與路徑、保留目前格式或建立獨立的轉換副本。已連接的 Storage 始終是選用項目。
繼續處理 SRT 與 連續檔案上方的錄製結果現在是內部磁碟上的受管理檔案。擷取已完成；可見性與選用轉換仍需分別選擇，只有需要時才加入已連接的 Storage。
為其他格式建立獨立副本
變更輸出格式或轉碼設定會啟動背景重寫，並建立獨立的轉換副本，也就是衍生檔案。原始檔會保留在自己的受管理檔案記錄中，不會變更。
檔案結果直接使用已驗證的錄製檔案
已連接的 Storage 是選用項目
不需要外部 Storage，錄製即可在內部磁碟運作。設定 Storage 後，Callaba 會在中繼資料服務中註冊物件儲存空間、格式化磁碟區，並將它掛載到 POSIX 相容命名空間。接著，File Manager 可透過這個熟悉的檔案系統路徑複製驗證過的檔案，並顯示複製進度。
加密適用於預設內部磁碟和選用已連接 Storage 中的檔案。只存取實體磁碟或底層物件儲存資料區塊，無法取得可讀取或播放的媒體檔案。
可見性儲存在受管理檔案記錄中，發布或播放前應先檢查。此處顯示的 Private 僅為範例，絕不是預設值。
Recorder 預設寫入本機磁碟。選用的物件儲存目標由 File Manager 管理；可用的 Storage 類型請以已安裝介面為準。
技術規格
Video Stream Recorder 技術規格
本表說明支援的行為。容量取決於節點，部分選項取決於已安裝版本。可選輸入與欄位請以已安裝的 Callaba 介面為準。
| 功能 | 支援的行為 | 驗證方式 |
|---|---|---|
| 輸入類型 | 受管理 SRT 和 RTMP 模組；SRT Routes；SRT、RTMP、RTSP、HLS、MPEG-DASH、RIST、UDP、RTP 與 HTTP 路徑；NDI；視訊房間；以及已安裝介面中可用的檔案和產生測試來源。 | 先用來源進行短時間測試，確認畫面、音訊、識別資訊與復原行為符合預期，再開始長時間錄製。 |
| 錄製模式 | 一個連續檔案或依時間分段錄製。 | 短時間連續錄製應能正常停止。分段模式還需檢查多個連續檔案及其完整邊界。 |
| 分段時長 | 使用小時、分鐘與秒定義分段間隔。 | 第一批完成的分段應符合設定時長，且沒有無法解釋的缺口或漂移。 |
| 輸出類型 | MP4、持續增長的 MKV、持續增長的 MPEG-TS 與 HLS 封存輸出；其他音訊/檔案格式取決於所選處理路徑和已安裝版本。 | 完成結果應具有預期的容器、時長、音軌、時間戳記，並在需要時支援正確跳轉。 |
| 視訊處理 | 選用的編解碼器、位元率、畫面尺寸、影格率、GOP 及相關轉碼設定。 | 檔案應符合封存設定。需要保留相容媒體時，可以關閉轉碼。 |
| 音訊處理 | 選用的音訊編解碼器/取樣率設定，以及音軌與聲道選擇。 | 完成檔案應包含所需的節目混音、音軌與聲道配置。 |
| 圖片疊加 | 選用的已準備圖片疊加，並明確指定位置。 | 檢查整個輸出畫面，確認圖形位於預期位置且沒有遮住必要內容。 |
| 執行統計 | 工作程序執行時可傳回 FPS、位元率、媒體時間、速度與進度。 | 媒體時間與進度應持續增加。只有執行統計並不能驗證檔案。 |
| 預設檔案位置與保留 | Recorder 預設將檔案寫入內部磁碟。可依檔案存續時間自動刪除本機錄製檔案；此功能為選用項目。 | 啟用刪除前，請先驗證完成的本機檔案。如果使用已連接的 Storage，也應先完成複製與回讀檢查。 |
| File Manager | 完成的錄製會進入受管理檔案工作流程，並包含名稱、路徑、說明、可見性、輸出格式與處理中繼資料。 | 完成的錄製應具有正確的 File Manager 記錄、時長、大小與可見性，其媒體也應能播放。 |
| 錄製後轉換 | 變更輸出格式或轉碼設定可啟動背景重寫，建立受管理衍生檔案，包括 MP4、HLS 或純音訊工作流程。 | 重寫進度完成後，衍生檔案應符合指定格式、音軌、時長與時間戳記。 |
| 選用的 POSIX 相容儲存 | 設定已連接的 Storage 後，其物件儲存空間和中繼資料服務會被格式化並掛載為受管理 POSIX 相容檔案系統命名空間。Recorder 寫入內部磁碟不需要這一層。 | 如果使用，已掛載的 Storage 應能接收一次非關鍵的 File Manager 複製，並透過受管理路徑傳回同一檔案。 |
| 靜態加密 | 預設內部磁碟和選用已連接 Storage 中的受管理檔案採用靜態加密；只存取原始磁碟或底層物件，無法取得可播放的媒體。 | 一般與復原存取都應使用 Callaba 的受管理檔案路徑；原始儲存資料區塊不是媒體檔案。 |
| 選用儲存交接 | File Manager 可將內部磁碟上驗證過的檔案複製到已設定、由物件儲存支援的磁碟區，並顯示複製進度。 | 使用這項選用交接時，應在刪除本機檔案前完成複製，並能從目標 Storage 回讀。 |
| 生命週期控制 | 可透過介面/API 工作流程建立、更新、列出/計數、依 ID 取得、開始、停止、取得統計、刪除檔案和刪除工作。 | 可以使用非關鍵來源驗證開始、停止、重新啟動與正常移除行為。 |
| 部署 | 支援 Callaba 雲端部署或自行託管 Linux；容量取決於來源媒體、處理、並行工作與儲存設計。 | 應在所選節點上，使用真實的來源組合、錄製模式、處理方式與磁碟行為進行負載測試。 |
部署界線
讓錄製與檔案處理位於同一部署環境
可在 Callaba 雲端部署或自行託管的 Linux 上執行 Recorder。無論採用哪種方式，錄製都會先寫入加密的內部磁碟，已連接的 Storage 始終為選用項目。
AWS 上的 Callaba
啟動受管理的 Callaba 節點，在同一操作介面中使用 Recorder 與 File Manager，再依實際的來源和處理組合配置運算與磁碟資源。
在 AWS 上部署 Callaba自行託管 Callaba
將應用程式、網路路徑與加密媒體保留在團隊維運的基礎架構上；只有需要時才加入選用的已連接 Storage。
安裝自行託管的 Callaba先完成介面工作流程，再使用 REST
開啟連續錄製 API 工作流程透過 REST 使用同一套 Recorder 生命週期
建立或更新錄製工作、開始和停止錄製、讀取執行統計、列出產生的檔案，以及移除檔案或工作。擷取結束後由 Files API 延續工作流程；加入已連接的 Storage 時可使用 Storages API。
Video Stream Recorder 常見問題
Video Stream Recorder 可使用哪些來源？
Recorder 使用 Callaba 的共用輸入模型。目前正式環境版本支援受管理來源、以 URL 為基礎的即時協定、NDI 與視訊房間。實際可選來源請以已安裝版本中的來源選擇器為準。
Callaba 可以錄製視訊房間嗎？
可以。視訊房間可將網格版面或講者合成畫面送入錄製工作流程。正式工作階段前，請依預定版面進行一次短時間錄製，並檢查參與者音訊。
錄製內容可以自動分段嗎？
可以。選擇定時分段模式並設定每段時長。在將分段邊界用於保留或下游自動化之前，請檢查第一批完成的檔案是否有缺口。
File Manager 可以變更錄製檔案的格式嗎？
可以。受管理檔案可另存為其他輸出格式，並可選擇視訊或音訊轉碼。背景重寫會建立獨立的轉換副本，也就是衍生檔案；File Manager 會顯示處理進度。
Recorder 一定要使用 S3 bucket 或已連接的 Storage 嗎？
不需要。Recorder 預設寫入內部磁碟，File Manager 會在該處管理產生的檔案。已連接的 Storage 是選用項目。設定後，Callaba 會將它掛載為由物件儲存空間與中繼資料支援的 POSIX 相容檔案系統，File Manager 可將驗證過的檔案複製到該命名空間。Public 與 Private 是檔案記錄上彼此獨立的可見性選項。
內部磁碟和已連接 Storage 中的檔案是否加密？
是。Callaba 會對預設內部磁碟和選用已連接 Storage 中的受管理檔案進行靜態加密。只存取原始磁碟或物件儲存資料區塊，無法取得可讀取或播放的媒體檔案；必須透過受管理存取路徑。
錄製生命週期可以自動化嗎？
可以。Recordings API 控制擷取，Files API 管理中繼資料、格式重寫與複製，Storages API 註冊目的地。檔案播放與儲存回讀仍需分別檢查。
第一次錄製
先用一個短檔案檢查一個來源。
使用真實輸入，在內部磁碟進行一次短時間錄製並正常停止。在 File Manager 中開啟其記錄，檢查可見性與格式。如果工作流程使用已連接的 Storage，請先複製並回讀驗證過的檔案，再增加錄製時長或來源數量。