Docs Overview/
UE/

UE

本文主要介绍如何快速运行腾讯云即时通信 IM Demo（Unreal Engine）。
说明：
目前支持 Windows、macOS、iOS、Android。

环境要求

建议 Unreal Engine 4.27.1 及以上版本。
开发端
环境
Android
Android Studio 4.0 及以上版本。
Visual Studio 2017 15.6 及以上版本。
只支持真机调试。
iOS & macOS
Xcode 11.0 及以上版本。
OSX 系统版本要求 10.11 及以上版本 。
请确保您的项目已设置有效的开发者签名。
Windows
操作系统：Windows 7 SP1 及以上版本（基于 x86-64 的 64 位操作系统）。
磁盘空间：除安装 IDE 和一些工具之外还应有至少 1.64 GB 的空间。
安装 Visual Studio 2019 。


前提条件

您已 注册腾讯云 账号，并完成 实名认证。

操作步骤



步骤1：创建新的应用

说明：
如果您已有应用，请记录其 SDKAppID 并 获取密钥信息。 同一个腾讯云帐号，最多可创建300个即时通信 IM 应用。若已有300个应用，您可以先 停用并删除 无需使用的应用后再创建新的应用。应用删除后，该 SDKAppID 对应的所有数据和服务不可恢复，请谨慎操作。
2. 单击创建新应用，在创建应用对话框中输入您的应用名称，单击确定。

3. 创建完成后，可在控制台总览页查看新建应用的状态、业务版本、SDKAppID、创建时间、标签以及到期时间。请记录 SDKAppID 信息。



步骤2：获取密钥信息

1. 单击目标应用卡片，进入应用的基础配置页面。

2. 在基本信息区域，单击显示密钥，复制并保存密钥信息。
注意：
请妥善保管密钥信息，谨防泄露。


步骤3：配置 Demo 工程文件

1. 下载即时通信 IM Demo 工程，具体下载地址请参见 Demo 下载。
2. 找到并打开 /IM_Demo/Source/debug/include/DebugDefs.h 文件。
3. 设置 DebugDefs.h 文件中的相关参数：
<ul><li/>SDKAPPID：默认为 0 ，请设置为实际的 SDKAppID。
<li/>SECRETKEY：默认为 "" ，请设置为实际的密钥信息。</ul>
说明：
本文提到的生成 UserSig 的方案是在客户端代码中配置 SECRETKEY，该方法中 SECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 Demo 和功能调试。
正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。


步骤4：编译打包运行

1. 双击打开 /IM_Demo/IM_Demo.uproject。
2. 编译运行调试：
macOS 端
Windows 端
iOS 端
Android 端
File -> Package Project -> Mac
File->Package Project->Windows->Windows(64-bit)

打包项目 File -> Package Project-> iOS
1. 开发调试：详见 Android 快速入门。
2. 打包项目：详见 打包 Android 项目。

IM Unreal Engine API 文档

更多接口介绍，请参见 API 概览。

常见问题

Android“Attempt to construct staged filesystem reference from absolute path"”报错

关闭 UE4 项目，打开 CMD，运行如下命令：
adb shell

cd sdcard

ls (you should see the UE4Game directory listed)

rm -r UE4Game

重新编译项目。