此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途

具体接入步骤

1. 从 UE4 Poco SDK 将 PocoSDK 这个文件夹克隆下来，放置到您项目的 Plugins 目录下。如果您项目没有名为 Plugins 的目录的话，需要先创建该目录。

2. 重新编译项目。确认在编辑器的 Edit > Plugins 当中能看到 Poco SDK ，且 Enabled 为被勾选的状态。

   如果此时 Enabled 未被勾选，请勾选 Enabled 并按提示重启编辑器/VS。

   

3. 运行游戏。

使用方法

1. 更新最新版的 Poco，指令为

   pip install --upgrade pocoui
   

   注意包名为pocoui，而不是poco。更新完毕后请确认poco的版本号至少为 1.0.79。

2. 当前版本的 IDE 尚未外放 UI 树查看时 UE4 的选项，此功能将会在下个版本的 IDE 中放出。因为端口与 Unity 一致，目前可以使用 Unity 的选项来查看 UI 树。

   而在脚本层面的具体使用方法如下：

   from poco.drivers.ue4 import UE4Poco
   poco = UE4Poco()
   # example
   poco("StartButton").click()
   

   如果想用编辑器模式，可以在初始化Poco的时候传入参数,

   poco = UE4Poco(ue4_editor=True)
   

此方式连接的窗口为编辑器 PIE 独立窗口模式，如果失败，可以自行修改poco/drivers/ue4/device.py下连接设备的句柄。如下列代码就是连接 UE4 窗口中带有Game Preview Standalone字样的窗口。

dev = connect_device("Windows:///?class_name=UnrealWindow&title_re=.*Game Preview Standalone.*")


一些常见的问题：

1. Poco SDK 未能正常启动。

   确认 Poco SDK为 Enabled 的状态。
   确认 .uproject 文件中包含有Poco SDK, 且为 Enabled 状态。

2. 启动游戏时报错，Output Log 中信息为

   LogPluginManager: Error: Unable to load plugin 'PocoSDK'. Aborting.
   

   请确认PocoSDK.uplugin文件中的"Installed"这一项对应的值是true，且没有"Enterprise"这一项。

3. 如果遇到其它不能自行解决的问题，可以到我们 GitHub 的项目上提个 issue，会有专门的开发者回复大家的问题。（项目地址：https://github.com/AirtestProject/Poco-SDK/tree/master/Unreal）

如想了解更多关于 AirtestProject 的教程，欢迎到公众号查看。