tencent cloud

文档反馈

Unreal Engine

最后更新时间:2022-05-09 15:39:18

    本文主要介绍如何快速运行腾讯云 TRTC 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:创建新的应用

    1. 登录实时音视频控制台,选择【开发辅助】>【快速跑通Demo】。
    2. 单击【新建应用】输入应用名称,例如 TestTRTC;若您已创建应用可单击【选择已有应用】。
    3. 根据实际业务需求添加或编辑标签,单击【创建】。
    说明:

    • 应用名称只能包含数字、中英文字符和下划线,长度不能超过15个字符。
    • 标签用于标识和组织您在腾讯云的各种资源。例如:企业可能有多个业务部门,每个部门有1个或多个 TRTC 应用,这时,企业可以通过给 TRTC 应用添加标签来标记部门信息。标签并非必选项,您可根据实际业务需求添加或编辑。

    步骤2:下载 SDK 和 Demo 源码

    1. 根据实际业务需求下载 SDK 及配套的 Demo 源码(有疑问可在此处提issue单)。
    2. 下载完成后,单击【已下载,下一步】。

    步骤3:配置 Demo 工程文件

    1. 进入修改配置页,根据您下载的源码包,选择相应的开发环境。
    2. 找到并打开 /TRTC_Demo/Source/debug/include/DebugDefs.h 文件。
    3. 设置 DebugDefs.h 文件中的相关参数:
      • SDKAPPID:默认为 0 ,请设置为实际的 SDKAppID。
      • SECRETKEY:默认为 "" ,请设置为实际的密钥信息。
    4. 粘贴完成后,单击【已复制粘贴,下一步】即创建成功。
    5. 编译完成后,单击【回到控制台概览】即可。
    说明:

    • 本文提到的生成 UserSig 的方案是在客户端代码中配置 SECRETKEY,该方法中 SECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试
    • 正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向 App 的接口,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig

    步骤4:编译打包运行

    1. 双击打开 /TRTC_Demo/TRTC_Demo.uproject
    2. 编译运行调试:
      1. File -> Package Project -> Mac
      2. 配置权限。右击上一步编译出的 xxx.app 文件 - 选择 "显示包内容"
      3. 进入 "Contents->Info.plist"
      4. 选择 "Information Property List" 然后添加以下两个权限:
        <key>NSCameraUsageDescription</key>
        <string>授权摄像头权限才能正常视频通话</string>
        <key>NSMicrophoneUsageDescription</key>
        <string>授权麦克风权限才能正常语音通话</string>
        
      5. 如果你现在在UE4的editor运行的话,需要找到 UE4Editor.app 文件并且按照上面步骤添加权限。

    Demo运行

    Demo 里面提供了一对一视频通话的实现,可以测试和作为调用参考,API 文档参见 C++ 全平台 API

    说明:

    UI 可能会有部分调整更新,请以最新版为准。

    TRTC全平台 C++ API文档

    中文文档

    英文文档

    常见问题

    如何查看 TRTC 日志?

    TRTC 的日志默认压缩加密,后缀为 .xlog。地址如下:

    • iOS 端:sandbox 的 Documents/log
    • Android 端
      • 6.7及之前的版本:/sdcard/log/tencent/liteav
      • 6.8之后的版本:/sdcard/Android/data/包名/files/log/tencent/liteav/

    macos UE4 editor闪退

    请确认在您的UE4Editor.app info.plist 中设置了音视频权限

    <key>NSCameraUsageDescription</key>
    <string>授权摄像头权限才能正常视频通话</string>
    <key>NSMicrophoneUsageDescription</key>
    <string>授权麦克风权限才能正常语音通话</string>
    

    安卓“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
    重新编译项目

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持