含 UI 集成方案(荐)

无 UI 集成方案

服务端 API

数据库文档捉虫大赛邀您参加,好礼多多> HOT
本文主要介绍如何快速运行腾讯云即时通信 IM Demo(iOS)。以下视频将帮助您快速入门:


操作步骤

步骤1:创建应用

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



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




步骤2:获取密钥信息

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



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

步骤3:下载并配置 Demo 源码

1. 下载即时通信 IM Demo 工程,具体下载地址请参见 SDK 下载
说明
为尊重表情设计版权,下载的 Demo 工程中不包含大表情元素切图,您可以使用自己本地表情包来配置代码。未授权使用 IM Demo 中的表情包可能会构成设计侵权。
2. 打开所属终端目录的工程,找到对应的 GenerateTestUserSig.h 文件。n iOS 路径:iOS/Demo/TUIKitDemo/Private/GenerateTestUserSig.hn Mac 路径:Mac/Demo/TUIKitDemo/Debug/GenerateTestUserSig.h
3. 设置 GenerateTestUserSig.h 文件中的相关参数:
SDKAPPID:请设置为 步骤1 中获取的实际应用 SDKAppID。
SECRETKEY:请设置为 步骤2 中获取的实际密钥信息。



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

步骤4:编译运行

可参见 步骤3 克隆的 Demo 工程中对应目录下的 README.md 文件。
1. 终端执行以下命令,检查 pod 版本。
pod --version
若提示 pod 不存在,或 pod 版本小于 1.7.5,请执行以下命令安装最新 pod。
更换 gem 源
安装 pod
更新 pod 本地库
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
sudo gem install cocoapods -n /usr/local/bin
如果安装了多个 Xcode ,请使用下面的命令选择 Xcode 版本(一般选择最新的 Xcode 版本)。
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
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。

可选操作:开通内容审核功能

在消息发送、资料修改场景中,很有可能会扩散不合适的内容,特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容,不仅严重损害了用户们的身心健康,更很有可能违法并导致业务被监管部门查封。
即时通信 IM 支持内容审核(反垃圾信息)功能,可针对不安全、不适宜的内容进行自动识别、处理,为您的产品体验和业务安全保驾护航。可以通过以下两种内容审核方式来实现:
本地审核功能:在客户端本地检测在单聊、群聊、资料场景中由即时通信 SDK 发送的文本内容,支持对已配置的敏感词进行拦截或者替换处理。此功能通过在 IM 控制台开启服务并配置词库的方式实现。
云端审核功能:在服务端检测由单聊、群聊、资料场景中产生的文本、图片、音频、视频内容,支持针对不同场景的不同内容分别配置审核策略,并对识别出的不安全内容进行拦截。此功能已提供默认预设拦截词库和审核场景,只需在 IM 控制台打开功能开关,即可直接使用。

交流与反馈

欢迎加入 QQ 群进行技术交流和反馈问题。



目录