tencent cloud

文档反馈

最后更新时间:2024-07-09 15:25:38
    本文主要介绍如何快速运行即时通信 Chat Demo。

    操作步骤

    1. 创建应用

    1. 登录控制台。如果您已有应用,请记录其 SDKAppID 及 SDKSecretKey。
    说明
    1. 同一个控制台账号,最多可创建 300 个即时通信 Chat 应用。若已有 300 个应用,您可以先停用并删除无需使用的应用后再创建新的应用。
    2. 应用删除后,该 SDKAppID 对应的所有数据和服务不可恢复,请谨慎操作!
    2. 单击Create Application,在对话框中输入您的 Application name、product、Region,单击Create
    

    2. 获取 SDKAppID 及 SDKSecretKey

    创建完成后,可在控制台总览页查看新建应用的 Status、SDKAppID、Expiration time 等:
    
    
    
    记录下 Application 信息中的 SDKAppID 及 SDKSecretKey。
    禁止:
    请妥善保管 SDKSecretKey,谨防泄露!

    3. 下载并配置 Demo 源码

    1. 从 Github 下载 iOS Demo 工程
    2. 打开终端目录的工程,找到对应的 GenerateTestUserSig.h 文件,路径为:
    iOS 平台:iOS/Demo/TUIKitDemo/Private/GenerateTestUserSig.h
    Mac 平台:Mac/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
    3. 设置相关参数:
    SDKAPPID:上文获取的 SDKAppID。
    SECRETKEY:上文获取的 SDKSecretKey。
    
    警告:
    1. 本文提到的获取 UserSig 的方案是在客户端代码中配置 SECRETKEY,该方法中 SECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。
    2. 正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向 App 的接口,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig
    3. 为尊重表情设计版权,下载的 Demo 工程中不包含大表情元素切图,您可以使用自己本地表情包来配置代码。未授权使用 Demo 中的表情包可能会构成设计侵权。

    4. 编译运行

    可参见克隆的 Demo 工程中对应目录下的README.md文件。
    1. 终端执行以下命令,检查 pod 版本。
    pod --version
    若提示 pod 不存在,或 pod 版本小于 1.7.5,请执行以下命令安装最新 pod。
    //更换 gem 源
    gem sources --remove https://rubygems.org/
    gem sources --add https://gems.ruby-china.com/
    //安装 pod
    sudo gem install cocoapods -n /usr/local/bin
    //如果安装了多个 Xcode ,请使用下面的命令选择 Xcode 版本(一般选择最新的 Xcode 版本)
    sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
    //更新 pod 本地库
    pod setup
    2. 终端执行以下命令,安装依赖库。
    //iOS
    cd iOS/TUIKitDemo
    pod install
    //Mac
    cd Mac/TUIKitDemo
    pod install
    如果安装失败,执行以下命令更新本地的 CocoaPods 仓库列表。
    pod repo update
    3. 编译运行:
    iOS 进入 iOS/TUIKitDemo 文件夹,打开TUIKitDemo.xcworkspace编译运行。
    Mac 进入 Mac/TUIKitDemo 文件夹,打开TUIKitDemo.xcworkspace编译运行。
    注意:
    Demo 默认集成了音视频通话功能,由于该功能依赖的音视频 SDK 暂不支持模拟器,请使用真机调试或者运行 Demo。
    联系我们

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

    技术支持

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

    7x24 电话支持