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
- Wählen Sie den Link zum Herunterladen des Body Tracking SDK aus
- 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.
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.