.. _4 SDK使用快速入门:

4 SDK使用快速入门
===============================

Step1：新建工程
------------------------------

新建项目时选择蓝图及C++项目均可，这里以蓝图Blank项目模板为例：

.. image:: _static/4.1.png

图4.1 创建项目

请务必保证目标硬件为：Mobile/Tablet，目标图像级别为：Scalable 3D or 2D。另外项目名称及项目路径不要出现中文。


Step2：设置项目
------------------------------

为兼容我们的SDK，需要对项目进行设置，主要包括以下几点：

1、设置项目的Editor Start Map与Game Default Map：即保持当前地图，然后进入Edit->Project Setting->Project->Maps and Modes，设置为项目的Editor Start Map与Game Default Map为先前保持的地图。

.. image:: _static/4.2.png

图4.2 设置地图

2、清除默认虚拟按键：进入Engine->Input->Mobile，清除Default Touch Interface；

.. image:: _static/4.3.png

图4.3 清除游戏默认虚拟按键

3、进入Platforms->Android->APKPackaging，勾选Enable FullScreen Immersive on KitKat and above devices。

.. image:: _static/4.4.png

图4.4 隐藏系统虚拟按键

4、设置Android平台的SDK与NDK版本：进入Platforms->Android，将Minimum SDK Version与Target SDK Version均设为19；

.. image:: _static/4.5.png

图4.5 设置SDK版本

5、进入Platforms->Android SDK，将SDK API Level设置为matchndk，NDK API Level设置为android-19。

.. image:: _static/4.6.png

图4.6 设置NDK版本

6、关闭与SDK相冲突的Plugins：进入Edit->Plugins，取消勾选Built-in / Virtual Reality下的所有项，以及Built-in /Input Devices下的所有项。此时编辑器会提示重启，直接关闭编辑器即可。


Step3：导入SDK开发包
------------------------------

请务必保持编辑器关闭，将解压出的Plugins目录复制到项目的根目录下：

.. image:: _static/4.7.png

图4.7 将SDK导入目录

然后双击项目名称重新打开。

待项目打开后，在Plugins页面下可以看到我们的插件：

.. image:: _static/4.9.png

图4.8 Pico相关插件


Step4：完成项目
------------------------------

1、新建Pawn蓝图类，为其DefaultSceneRoot组件下添加Scene组件，然后在Scene组件下新建Camera组件：

.. image:: _static/4.10.png

图4.9 Pawn组件结构

打包安装到头盔后，此Camera的相对位置/姿态将根据头盔实时刷新，完成头部跟踪与立体渲染。

2、将Pawn拖入场景，并将其Auto Possess Player设为Player0：

.. image:: _static/4.11.png

图4.10 将Pawn拖入场景


Step5：项目打包
------------------------------

Pico系列设备支持的纹理压缩格式为ASTC，所以在打包项目时需选择Android（ASTC）。具体打包流程为：在编辑器中，执行文件->打包项目->Android-> Android（ASTC），即可打包（建议先进入“Project Settings“，勾选Platforms子项Android中的“Package game data inside .apk?”，以便将数据打包进apk）：

.. image:: _static/4.12.png

图4.11 打包流程

打包后，双击“Install_项目名称_编译配置-armv7-es2.bat”进行安装：

.. image:: _static/4.13.png

图4.12 安装apk