集成Windows端美颜特效SDK

集成美颜特效SDK（C++）

本节以Visual Studio 2017创建⼀个简单的VC++控制台应⽤项⽬，并在项⽬中集成美颜特效SDK（C++）为例，介绍如何集成SDK并运行程序。

1. 点击SDK下载地址，下载SDK。

   解压SDK并打开，包含以下文件。

   目录名	说明
   include	详细接口注释的API头文件。
   lib	编译使⽤的.lib⽂件和运⾏时加载的.dll⽂件。
   queen_res	必要的运⾏资源⽂件。
   res	效果素材资源，如果使⽤⾃定义素材，可以不添加。

2. 新建工程。

   打开Visual Studio，新建⼀个AliyunQueenSDKDemo的VC++ Windows桌⾯控制台应⽤程序项⽬，如下图所示。

3. 拷贝文件。

   在AliyunQueenSDKDemo.vcxproj所在⽬录下创建名为AliyunQueenSDK的⽂件夹。将解压后的SDK文件拷贝到新建的AliyunQueenSDK文件夹中，如下所示。

4. 修改工程配置。

   单击解决⽅案资源管理器>右键AliyunQueenSDKDemo⼯程的菜单>属性打开AliyunQueenSDKDemo属性⻚， 按以下步骤进⾏配置。

   1. 添加包含目录。单击C/C++>常规>附加包含⽬录，添加SDK头文件目录$(ProjectDir)AliyunQueenSDK\include，如下所示。

   2. 添加库目录。单击链接器>常规>附加库⽬录，添加SDK库目录$(ProjectDir)AliyunQueenSDK\lib\$(PlatformShortName)，如下所示。

   3. 添加库文件。单击链接器>输入>附加依赖项，添加SDK库文件queen.lib，如下所示。

   4. 添加copy命令。单击生成事件>后期生成事件>命令行添加拷贝命令，命令和操作如下所示。

      说明

      添加拷贝命令能够在编译完成后，⾃动将SDK的.dll⽂件和必要的queen_res资源⽂件夹以及可选的res资源⽂件夹拷⻉到程序的运⾏⽬录下。

      xcopy "$(ProjectDir)AliyunQueenSDK\lib\$(PlatformShortName)\*.dll" "$(TargetDir)" /y

      xcopy "$(ProjectDir)AliyunQueenSDK\queen_res" "$(TargetDir)queen_res" /i /s /y

      xcopy "$(ProjectDir)AliyunQueenSDK\res" "$(TargetDir)res" /i /s /y

      

5. 调用SDK接口，运行程序。

   1. 将AliyunQueenSDKDemo.cpp内容替换为下方代码。

      #include 
      #include "queen_engine.h"
      using namespace queen;
      using namespace std;
      int main()
      {
      const char* queenSDKVersion = queen_engine_getSDKVersion();
      cout << "Hello QueenEngine: " << queenSDKVersion << endl;
      }

   2. 按键盘F5键运⾏程序，成功编译后会启动控制台，如下图所示。