构建 ADLX 的 Python 绑定

导航: 使用 ADLX 进行编程 → ADLX 编程指南 → 快速入门

本指南概述了为 ADLX 构建 Python 绑定包装器的步骤，这是在 Python 应用程序中使用 ADLX 进行编程的先决条件。

先决条件

• 已安装ADLX SDK。
• 已安装Visual Studio 2019。
• 已安装Python 3.9。
• 已安装pybind11。
• Python 3.9 安装的路径已添加到 **PYHOME** 系统环境变量中。

构建 Python 绑定以使用 ADLX

• 为您的 Python ADLX 绑定包装器创建一个文件夹，例如 ADLXPybind。
• 在 ADLXPybind 文件夹中创建一个新文件，并将其命名为 bind.cpp。
• 编辑 bind.cpp 并使用 pybind11 绑定您希望包装的接口。要为事件通知创建绑定，请继承相应的监听器接口。

例如，继承 IADLXDisplayListChangedListener。

注意: 有关 Python 绑定的示例，请参阅 Python 示例 bind.cpp 文件。

• 创建一个名为 ADLXPybind 的 C++ 动态链接库项目，并按如下方式配置该项目
• | 键 | 值 | 说明 | |---|---|---| | 高级 > 目标文件扩展名 | .pyd | 使用 .pyd 作为扩展名 | | VC++ Directories > Include Directories | $(PYHOME)/include

$(PYHOME)/Lib/site-packages/pybind11/include | Add Path of python include and path of pybind11 include | | VC++ Directories > Library Directories |$(PYHOME)/libs | 添加 Python 库路径 | | C/C++ > 预编译头 | 不使用预编译头 | 不使用预编译头 | | 链接器 > 输入 | python39.lib | 添加 Python 库 |

• 将 bind.cpp 文件添加到项目中
• 将以下文件添加到项目中
• SDK/Platform/Windows/WinAPIs.cpp
• SDK/ADLXHelper/Windows/Cpp/ADLXHelper.h
• SDK/ADLXHelper/Windows/Cpp/ADLXHelper.cpp
• 构建项目。

结果: ADLXPybind.pyd 在 "$(SolutionDir)$(Platform)$/(Configuration)/" 文件夹中生成。

另请参阅: IADLXDisplayListChangedListener, ADLXPybind