tencent cloud

本文主要介绍如何快速运行腾讯云即时通信 IM Demo（Unreal Engine）。

说明：

目前支持 Windows、macOS、iOS、Android。

环境要求

建议 Unreal Engine 4.27.1 及以上版本。

前提条件

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

操作步骤

步骤1：创建新的应用

1. 登录 即时通信 IM 控制台。

   说明：

   如果您已有应用，请记录其 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 文件中的相关参数：
   • SDKAPPID：默认为 0 ，请设置为实际的 SDKAppID。
   • SECRETKEY：默认为 "" ，请设置为实际的密钥信息。

说明：

• 本文提到的生成 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

重新编译项目。