この記事では、 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 アンビン (640 x 576) モード、RGB 1080p（30 fps、IMUを含む）。 記録を停止するには、 Ctrl キーを 押しながら C キーを押します。
k4arecorder.exe output.mkv
例 2. WFOV 非ビン分割 (1MP)、RGB 3072p を IMU なしで 15 fps で 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 ビューアーを使用して、出力 .mkv ファイルを開くことができます。
トラックを抽出したり、ファイル情報を表示したりするには、 mkvinfo などのツールを MKVToolNix ツールキットの一部として使用できます。