====== Unity 客户端集成 ======


----


===== 开发工具 =====
> Unity

Unity SDK是为使用Unity开发的游戏等软件中集成IM功能提供的SDK。依赖Unity的跨平台特性，SDK可以轻松的运行于Android、IOS、MAC、Linux和Window等多个平台产品之上，用户可以用SDK实现IM功能。Unity SDK使用C#进行开发，目前支持登录、注册、单聊、群聊、文本消息、文件消息，还可以实现群组管理等功能。尚未实现语音通话和视频通话功能。emclient-u3d 为 Open Source， Link to :[[https://github.com/easemob/emclient-u3d/]]


===== 集成准备 =====

从[[http://www.easemob.com/download/im|环信官方网站]]获取 IM Unity SDK


===== 创建项目及导入SDK =====
参照下图路径，将下载的环信Unity SDK包Easemob_Version.unitypackage导入到自己的项目中如图：

{{:im:unitysdk:unitysdkimport.jpg?600|}}

导入过程中，选择加载SDK内所有文件：

{{:im:unitysdk:selectunitysdkallfiles.jpg?600|}}

==== IOS项目设置 ====
在导入了全部文件之后，使用Unity生成Xcode项目，在生成的Xcode项目里需要单独添加一下libsqlite和zlib库。如下图：

{{:im:unitysdk:xcodeimportlibs.jpg?600|}}

Xcode工程目录Classes\UnityAppController.mm文件中添加下入以下处理：
在UnityAppController.mm的开头出添加头文件引用：

{{:im:unitysdk:xcodeaddheaderfile.jpg?600|}}

修改UnityAppController.mm初始化IM SDK：

{{:im:unitysdk:xcodeinitialimsdk1.jpg?600|}}

{{:im:unitysdk:xcodeinitialimsdk2.jpg?600|}}

其中，initializeSDK函数传入参数为appKey的名称。

==== Android项目设置 ====
导入Unity SDK之后，在Plugins／Android／emsdk目录下，可以看到AndroidManifest文件：

{{:im:unitysdk:unityandroidpackage.jpg?600|}}

Unity SDK所需权限如下图：

{{:im:unitysdk:unityandroidpermission.jpg?600|}}

设置应用的环信AppKey：

{{:im:unitysdk:unityandroidappkey.jpg?600|}}

声明SDK所需的receiver：

{{:im:unitysdk:unityandroidreceiver.jpg?600|}}


----
<WRAP group>
<WRAP half column>
上一章节：[[im:react-native|React Native 集成]]
</WRAP>

<WRAP half column>
下一页：[[im:unitysdk:basic|Unity SDK 基础功能]]
</WRAP>
</WRAP>