这是一套针对 Azure Kinect 和 Femto Bolt/Mega 相机的示例，包含若干核心脚本，并统一归档于同一个文件夹中。该程序包提供了三十多个演示场景。除了 Azure Kinect、Femto Bolt 和 Femto Mega 传感器外，K4A 程序包还支持 Kinect-v2 相机（即 Kinect for Xbox One）以及 iPhone Pro 的 LiDAR 相机。
Web | Forum | Twitter/X | LinkedIn | Docs | Tips&Tricks
“Avatar-demo”（虚拟形象演示）场景展示了如何在场景中使用由 Kinect 控制的虚拟形象；“Gesture demo”（手势演示）展示了如何在项目中运用离散与连续手势；“Fitting room demos”（试衣间演示）演示了如何将用户身体与虚拟模型进行叠加或融合；“Background removal demo”（背景移除演示）展示了如何在虚拟背景上显示用户轮廓；“Point cloud demos”（点云演示）则展示了如何将真实环境或用户以网格形式呈现在场景中，等等。所有演示场景的简要说明均可在在线文档中查阅。
该软件包支持 Azure Kinect、Femto Bolt 和 Femto Mega 传感器、Kinect-v2（即 Kinect for Xbox One）以及 iPhone Pro 的 LiDAR 传感器。它适用于所有版本的 Unity（Free、Plus 和 Pro）。
如何运行演示场景：
1a. (Azure Kinect) 下载并安装最新版本的 Azure-Kinect Sensor SDK（下载链接见下文）。随后打开“Azure Kinect Viewer”以检查传感器是否正常工作。
1b. (Femto Bolt 和 Mega) 下载并解压最新版本的 Orbbec Viewer 以及 Orbbec SDK K4A Wrapper（下载链接见下文）。随后先打开“Orbbec Viewer”，再打开“K4A Viewer”，以检查传感器是否正常工作。
2. (Azure Kinect 和 Femto Bolt/Mega) 按照说明下载并安装最新版本的 Azure-Kinect Body Tracking SDK（下载链接见下文）。无论使用哪种相机，所有与人体追踪相关的场景都会用到该 SDK。
3. (Kinect-v2) 下载并安装 Kinect for Windows SDK 2.0（下载链接见下文）。
4. (iPhone Pro) 关于与 iPhone Pro 的 LiDAR 传感器集成，请参阅此提示。
5a. 将此包导入新的 Unity 项目。
5b. (Femto Bolt 和 Mega) 请按照此提示中的步骤操作。
6. 打开“File / Build settings”（文件 / 构建设置），确保当前激活的平台为“Windows”，且架构（architecture）设置为“Intel 64 bit”。
7. 在“Player Settings / Other Settings / Rendering”（播放器设置 / 其他设置 / 渲染）中，确保“Auto Graphics API for Windows”（Windows 自动图形 API）列表中的首选选项为“Direct3D11”。
8. 从 `AzureKinectExamples/KinectDemos` 文件夹的子文件夹中选择一个演示场景并运行。所有演示场景的简要说明均可在在线文档中找到。
* 可在此处获取最新版 Azure Kinect Sensor SDK (v1.4.1)。
* 可在此处获取最新版 Orbbec Viewer。
* 可在此处获取最新版 Orbbec SDK K4A-Wrapper (K4A Viewer)。
* 可在此处获取最新版 Azure Kinect Body Tracking SDK (v1.1.2)。
* 可在此处获取旧版 Azure Kinect Body Tracking SDK。
* 可在此处查看 Body Tracking SDK 的安装说明。
* 可在此处获取 Kinect for Windows SDK 2.0。
* 可在此处获取 RealSense SDK 2.0。
一个请求：
未经我明确许可，请勿将此资源包或其演示场景以源代码形式分享给他人，也请勿将其包含在公开的代码仓库中。
故障排除：
* 如果 Femto 相机仅更新一次用户姿势然后停止，请在“k4aviewer”（Orbbec K4A-wrapper 的一部分）中打开相机并检查相机流的时间戳是否仍在滚动。如果他们停止了，请重复本提示的步骤 3b。然后再次运行“k4aviewer”和 Unity 项目，检查相机是否正常工作。
* 如果Unity编辑器在场景启动时死机或崩溃，请确保Unity项目所在路径不包含任何非英文字符。
* 如果出现“Texture2D”不包含“LoadImage”定义或“Texture2D”不包含“EncodeToJPG”定义等错误，请打开包管理器，选择“内置包”并启用“图像转换”和“物理 2D”包。
* 如果您在控制台中收到语法错误，例如“类型或命名空间名称‘UI’不存在...”，请打开包管理器（菜单窗口/包管理器）并安装‘Unity UI’包。 UI元素广泛应用于K4A资产演示场景中。
* 如果由于 StartCameras() 方法失败而无法启动 Azure Kinect 传感器，请再次检查上面“如何运行演示场景”部分中的#6。
* 如果您收到“无法创建身体跟踪器”错误消息，请再次检查上面“如何运行演示场景”部分中的#2。
* Femto Bolt 和 Mega 支持：如果您需要用（或更喜欢使用）Orbbec 的 Femto Bolt 或 Mega 传感器替换 Azure Kinect，请遵循此提示。
* iPhone-Pro 支持：如果您想将 K4A 资产与 iPhone-Pro 的 LiDAR 传感器一起使用，请查看此提示。
* RealSense 支持已弃用。 Cubemos 骨骼跟踪不再可用。欲了解更多信息，请查看此提示。
* 如果在导入 K4A 资产时出现“[系统 1] 中的着色器错误...”等错误，请注意这不是错误，而是由于缺少 HDRP 和 VFX 包而导致的着色器问题。您只需要这些包来进行 VFX 点云演示。所有其他场景都应该毫无问题地启动。
* 如果控制台中存在编译错误，或者演示场景仍处于“等待用户”状态，请确保您已安装相应的传感器 SDK 和其他所需组件。另请检查传感器是否已连接。
* 对于其他已知问题，请查看此处。
文档、提示和技巧：
* 基本文档可在包中的 Readme-pdf 文件中找到。
* 在线文档可在此处获取。
* 这里提供了许多 K4A 包提示、技巧和示例。
第三方软件：
此资产使用 MIT 许可证下的 Azure Kinect Sensor SDK、Apache 许可证版本 2.0 下的 RealSense SDK 2.0 和 Microsoft Kinect for Windows v2 SDK 许可证下的 Kinect SDK 2.0。有关详细信息，请参阅包中的 Third-PartyNotices.txt 文件。
