Freigeben über


Schnellstart: Einrichten von Azure Kinect Body Tracking

Diese Schnellstartanleitung führt Sie durch das Einrichten von Body Tracking in Ihrem Azure Kinect DK.

Systemanforderungen

Für das Body Tracking SDK muss auf dem Host-PC eine NVIDIA-GPU installiert sein. Die empfohlenen Anforderungen an den Host-PC für Body Tracking sind auf der Seite Systemanforderungen beschrieben.

Installieren von Software

Installieren des neuesten NVIDIA-Treibers

Laden Sie den neuesten NVIDIA-Treiber für Ihre Grafikkarte herunter, und installieren Sie ihn. Ältere Treiber sind möglicherweise nicht mit den CUDA-Binarys kompatibel, die mit dem Body Tracking SDK geliefert werden.

Visual C++ Redistributable für Visual Studio 2015

Laden Sie das Visual C++ Redistributable für Visual Studio 2015 herunter, und installieren Sie es.

Einrichten der Hardware

Schnellstart: Einrichten Ihres Azure Kinect DK-Geräts

Starten Sie den Azure Kinect Viewer, um zu überprüfen, ob Ihr Azure Kinect DK ordnungsgemäß eingerichtet ist.

Herunterladen des Body Tracking-SDK

  1. Wählen Sie den Link zum Herunterladen des Body Tracking SDK aus
  2. Installieren Sie das Body Tracking SDK auf Ihrem PC.

Überprüfen des Body Tracking

Starten Sie den Azure Kinect Body Tracking Viewer, um zu überprüfen, ob das Body Tracking SDK ordnungsgemäß eingerichtet ist. Der Viewer wird mit dem MSI-Installationsprogramm des SDK installiert. Sie finden ihn im Startmenü oder unter <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exe.

Wenn Sie nicht über eine ausreichend leistungsstarke GPU verfügen, das Ergebnis aber trotzdem testen möchten, können Sie den Azure Kinect Body Tracking Viewer mithilfe des folgenden Befehls an der Befehlszeile starten: <SDK Installation Path>\tools\k4abt_simple_3d_viewer.exe CPU

Wenn alles ordnungsgemäß eingerichtet ist, sollte ein Fenster mit einer 3D-Punktwolke und nachverfolgten Körpern angezeigt werden.

Body Tracking 3D Viewer

Angeben der ONNX Runtime-Ausführungsumgebung

Das Body Tracking SDK unterstützt die CPU-, CUDA-, DirectML- (nur Windows) und TensorRT-Ausführungsumgebung zum Ableiten des Posenschätzungsmodells. K4ABT_TRACKER_PROCESSING_MODE_GPU ist standardmäßig auf die Ausführung von CUDA unter Linux und die Ausführung von DirectML unter Windows festgelegt. Es wurden drei zusätzliche Modi hinzugefügt, um bestimmte Ausführungsumgebungen auszuwählen: K4ABT_TRACKER_PROCESSING_MODE_GPU_CUDA, K4ABT_TRACKER_PROCESSING_MODE_GPU_DIRECTML und K4ABT_TRACKER_PROCESSING_MODE_GPU_TENSORRT.

Hinweis

Die ONNX-Runtime zeigt Warnungen für Opcodes an, die nicht beschleunigt werden. Diese können ignoriert werden.

Die ONNX-Runtime umfasst Umgebungsvariablen zum Steuern der Zwischenspeicherung von TensorRT-Modellen. Die empfohlenen Werte lauten:

  • ORT_TENSORRT_MOTOR_CACHE_AKTIVIERT=1
  • ORT_TENSORRT_CACHE_PATH="pathname"

Der Ordner muss vor dem Starten von Body Tracking erstellt werden.

Wichtig

TensorRT führt vor dem Rückschluss eine Vorverarbeitung des Modells durch. Dies führt zu längeren Startzeiten als in anderen Ausführungsumgebungen. Die Enginezwischenspeicherung schränkt dies auf die erste Ausführung ein. Dies ist jedoch ein experimentelles Feature und spezifisch für das Modell, die ONNX-Runtimeversion, die TensorRT-Version und das GPU-Modell.

Die TensorRT-Ausführungsumgebung unterstützt sowohl FP32 (Standard) als auch FP16. FP16 bietet eine ungefähr zweimal höhere Leistung auf Kosten einer minimal geringeren Genauigkeit. So legen Sie FP16 fest:

  • ORT_TENSORRT_FP16_ENABLE=1

Erforderliche DLLs für ONNX Runtime-Ausführungsumgebungen

Mode ORT 1.10 CUDA 11.4.3 CUDNN 8.2.2.26 TensorRT 8.0.3.4
CPU msvcp140 - - -
onnxruntime
CUDA msvcp140 cudart64_110 cudnn64_8 -
onnxruntime cufft64_10 cudnn_ops_infer64_8
onnxruntime_providers_cuda cublas64_11 cudnn_cnn_infer64_8
onnxruntime_providers_shared cublas64_11
DirectML msvcp140 - - -
onnxruntime
directml
TensorRT msvcp140 cudart64_110 - nvinfer
onnxruntime cufft64_10 nvinfer_plugin
onnxruntime_providers_cuda cublas64_11
onnxruntime_providers_shared cublas64_11
onnxruntime_providers_tensorrt nvrtc64_112_0
nvrtc-builtins64_114

Beispiele

Hier finden Sie Beispiele zur Verwendung des Body Tracking SDK.

Nächste Schritte