项目名称: PythonAI

---

说明: PythonAI 是一个使用Python做算法脚本，附加在UE4游戏中的 AI工具， 可以通过Python脚本来获取数据，进行训练，在拿到训练数据后，在游戏中使用AI算法，进行角色人物化的一些行为模拟 。

人员相关

---

---

使用平台

Unreal Editor(下边简称:UE)

1. 引擎版本 4.27.1
2. 引擎自带python解释器版本3.7.7
3. python库 Gym
4. python库 Torch

UE4使用

1. 下载UE4源码，选择4.27.1版本。下载地址：https://github.com/EpicGames/UnrealEngine.git
2. 下载成功后点击 GenerateProjectFiles.bat 下载辅助性dll
3. dll下载完毕后点击 Setup.bat 生成 UE4.sln
4. 编译UE4.sln
5. 双击 Engine\Binaries\Win64\UnrealVersionSelector-Win64-Shipping.exe 注册UE4路径

项目使用

1. 右键点击 PythonAI\PythonAI.uproject,点击 Switch Unreal Version，在弹出窗口中选择下载好UE4的路径，2. 点击OK，生成PythonAI.sln
2. 编译，运行PythonAI.sln
3. 在编辑器窗口选择运行，就可以体验demo版本了

VS版本

1. VS2019 + update3
2. 工作负荷

• .Net桌面开发
• 使用C++的桌面开发
• 使用C++的游戏开发
• 单个组件
• 1. .Net Framework 4.5 目标包
• 2. .Net Framework 4.5.1 目标包
• 3. .Net Framework 4.6.2 目标包
• 4. Windows 10 SDK(10.0.18362.0)
• 5. .Net Framework 4.6.2 SDK

环境配置

如何使用UE中的Python运行

1. 打开UE中菜单栏中编辑,在下拉菜单中找到插件,点击，打开插件UI
2. 在插件UI中，搜索栏目中查找python字，回车后，出现三个插件。
3. 三个插件都进行打勾
4. 打勾后，即可引入了python插件。
5. 打开UE中菜单栏中编辑,在下拉菜单中找到项目设置,点击，打开设置UI
6. 在左边设置列表中，找到插件1级标题，在下边找到Python二级标题,并且单击。
7. 在其它路径中 如果为0数组元素时，则使用+号，增加一行，如果已有一行，则到那行中，点击后边的...进行路径选择，一般直接选择Content/PythonScript。
8. 在其它路径下边有个小箭头，点击后，可看到开发者模式，进行打勾。

如何在UE中引擎Python库

1. （可选)在环境变量中，增加UE的Python执行器，一般位置在.引擎安装目录的\Epic Games\UE_4.27\Engine\Binaries\ThirdParty\Python3\Win64下
2. 装完后，在系统命令窗口或者是当前Python命名窗口中，执行: python -m pip install [库名称]

如何在UE中运行Python

1. 在工程创建后,可以看到有__pychche__和init_unreal.py的文件。
2. 在init_unreal.py是初始化中，要引入的python脚本，在引入后，需要重启ue4工程，才可以使用引入后的脚本

如何查看UE相关的api

1. 可以在https://docs.unrealengine.com/5.0/en-US/PythonAPI/查询相关的api函数
2. 也可以在工程的 例:PythonAI工程名 PythonAI\Intermediate\PythonStub\unreal.py查询相关的api函数,该文件中主要存放着UE封闭过的API
3. 具体用法， 一般使用 类名.函数( 对象 )的方式去调用，例如果获取角色的当前位置可以使用以下代码

  import unreal                                           #引入unreal的库
  world = unreal.EditorLevelLibrary.get_game_world()      
  # unreal.EditorLevelLibrary是调用unreal的EditorLevelLibrary类  get_game_world()是该库中的集成的方法，该方法在unreal的文件中已定义，可以去unreal.py中搜索得到，也可以通过API中搜索得到，返回值是当前【世界】的对象，该方法是在Edtiro模式下运行的，Runtime要使用其它方法。
  pawn = unreal.GamePlayStatic.get_player_pawn(world,0)
  #  该方法中把world对象，当做参数，传入到了get_player_pawn中 该方法返回一个pawn(操作对象)
  position = pawn.get_actor_location()
  # 使用刚才的操作对象,去Pawn中查找相关的方法 也可以从引擎的C++层，查询APawn的方法得到 GetActorLoction()与get_actor_location()相同，只是在c++使用 大写函数名称 在python中使用 _小写的方式，当然，也需要看unreal文件是否支持该函数。
  print(position)

4. 带Editor的类或者名称，一般是编辑器模式下，带Engine一般指运行时模式下，暂时，都可以混用，等以后熟悉后，将会模式隔离。

-------回放数据-------- ---目前记录的数据是以文本形式记录的，文件保存在桌面上名字叫CharacterData,文本数据目前记录了角色的位置，朝向以及摄像机朝向每10秒切割一次文件文件顺序依次为0,1,2,3...连续。 在角色蓝图右侧有WriteOrRead选项，true为写文件，false为读文件，如果文件存在，并设置为true，会分别在0,1,2...文件末尾添加新数据。选项为false时，如果没有Character文件将不做任何反应，如果有Character文件依次读取0,1,2,3... 文本中1、2、3为角色位置X、Y、Z；4、5、6为角色旋转Pitch、Yaw、Row;7、8、9为相机向前向量X、Y、Z（目前相机向量暂且没用）以此类推。