مسجل Azure Kinect DK

تتناول هذه المقالة كيفية استخدام أداة سطر الأوامر k4arecorder لتسجيل تدفقات البيانات من أداة الاستشعار SDK إلى ملف.

إشعار

لا يقوم مسجل Azure Kinect بتسجيل الصوت.

خيارات المسجل

يحتوي k4arecorder على وسيطات سطر أوامر متنوعة لتحديد ملف الإخراج وأوضاع التسجيل.

يتم تخزين التسجيلات في Matroska .mkv format. يستخدم التسجيل مسارات فيديو متعددة للون والعمق، وكذلك معلومات إضافية مثل معايرة الكاميرا وبيانات التعريف.

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 × 576)، RGB 1080 بكسل بمعدل 30 إطاراً في الثانية مع IMU. اضغط على مفاتيح CTRL-C لإيقاف التسجيل.

k4arecorder.exe output.mkv

مثال 2. سجل WFOV بدون تخزين (1 ميجا بكسل)، RGB 3072p بمعدل 15 إطاراً في الثانية بدون IMU، لمدة 10 ثوانٍ.

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

مثال 3. سجل WFOV 2x2 في حاوية بسرعة 30 إطاراً في الثانية لمدة 5 ثوانٍ، وحفظه في الإخراج. mkv.

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

تلميح

يمكنك استخدام Azure Kinect Viewer لتكوين عناصر تحكم كاميرا RGB قبل التسجيل (على سبيل المثال لضبط توازن اللون الأبيض يدوياً).

تحقق من التسجيل

يمكنك فتح ملف الإخراج .mkv باستخدام Azure Kinect Viewer.

لاستخراج المسارات أو عرض معلومات الملف، تتوفر أدوات مثل mkvinfo كجزء من مجموعة أدوات MKVToolNix.

الخطوات التالية

استخدام المسجل مع الوحدات الخارجية المتزامنة