共用方式為

Azure Kinect DK 錄製器

  • 發行項

本文涵蓋如何使用 k4arecorder 命令列公用程式，將來自感應器 SDK 的資料流程記錄到檔案。

注意

Azure Kinect 錄製器不會錄製音訊。

錄製器選項

k4arecorder 具有各種命令列引數，可指定輸出檔案和錄製模式。

錄製會以 Matroska .mkv 格式儲存。 錄製會使用多個影片播放軌進行色彩和深度，以及相機校正和中繼資料等其他資訊。

k4arecorder [options] output.mkv

 Options:
  -h, --help              Prints this help
  --list                  List the currently connected K4A devices
  --device                Specify the device index to use (default: 0)
  -l, --record-length     Limit the recording to N seconds (default: infinite)
  -c, --color-mode        Set the color sensor mode (default: 1080p), Available options:
                            3072p, 2160p, 1536p, 1440p, 1080p, 720p, 720p_NV12, 720p_YUY2, OFF
  -d, --depth-mode        Set the depth sensor mode (default: NFOV_UNBINNED), Available options:
                            NFOV_2X2BINNED, NFOV_UNBINNED, WFOV_2X2BINNED, WFOV_UNBINNED, PASSIVE_IR, OFF
  --depth-delay           Set the time offset between color and depth frames in microseconds (default: 0)
                            A negative value means depth frames will arrive before color frames.
                            The delay must be less than 1 frame period.
  -r, --rate              Set the camera frame rate in Frames per Second
                            Default is the maximum rate supported by the camera modes.
                            Available options: 30, 15, 5
  --imu                   Set the IMU recording mode (ON, OFF, default: ON)
  --external-sync         Set the external sync mode (Master, Subordinate, Standalone default: Standalone)
  --sync-delay            Set the external sync delay off the master camera in microseconds (default: 0)
                            This setting is only valid if the camera is in Subordinate mode.
  -e, --exposure-control  Set manual exposure value (-11 to 1) for the RGB camera (default: auto exposure)

錄製檔案

範例 1. 錄製深度 NFOV 未分類 (640x576) 模式，RGB 1080p，以 30 fps 搭配 IMU。 按 CTRL-C 鍵停止錄製。

k4arecorder.exe output.mkv

範例 2. 錄製 WFOV 沒有分類 (1MP) ，RGB 3072p 於15 fps 沒有 IMU，10 秒。

k4arecorder.exe -d WFOV_UNBINNED -c 3072p -r 15 -l 10 --imu OFF output.mkv

範例 3. 錄製 WFOV 2x2 分類於 30 fps 長度 5 秒，並儲存至 output.mkv。

k4arecorder.exe -d WFOV_2X2BINNED -c OFF --imu OFF -l 5 output.mkv

提示

您可以在錄製前使用 Azure Kinect Viewer 設定 RGB 相機控制項 (例如設定手動白平衡)。

確認錄製內容

您可以使用 Azure Kinect Viewer 開啟輸出 .mkv 檔案。

若要擷取追蹤或檢視檔案資訊，mkvinfo 這類工具可做為 MKVToolNix 工具組的一部分使用。

下一步

搭配外部同步處理單位使用錄製器