融云新手引导

名词解释

前期准备

获取App Key

首先需要了解的是 App Key / Secret,它们是融云 SDK 连接服务器所必须的标识,每一个 App 对应一套 App Key / Secret。针对开发者的生产环境和开发环境,我们提供两套 App Key / Secret,两套环境的功能完全一致。您在应用最终上线前,使用开发环境即可。

开发环境 App Key / Secret 是专门为您提供的仅供开发使用的,开发环境将和生产环境的数据隔离,避免开发环境数据和线上生产环境数据互相冲突。 

生产环境的 App Key / Secret 默认先不提供,等您提交上线后,我们会提供生产环境的 App Key / Secret。

获取 Token

Token 称为用户令牌,App Key 是您的 App 的唯一标识,Token 则是您 App 上的每一个用户的身份授权象征。您可以通过提交 userId 等信息来获得一个该用户对应的 Token,并使用这个 Token 作为该用户的唯一身份凭证与其他用户进行通信。

Token 的主要作用是身份授权和安全,因此不能通过客户端直接访问融云服务器获取 Token,您必须通过 Server API 从融云服务器 获取 Token 返回给您的 App,并在之后连接时使用。详细描述请参考 Server 开发指南中的用户服务和获取 Token 方法小节。

为了方便您在集成和测试过程中使用,我们还提供了 API 调试工具,在您不能部署服务器程序时,可以直接通过传入 userId 和 name 来获得 Token。请访问融云开发者平台,打开您想测试的应用,在左侧菜单中选择“API 调试”即可。

  • userId : 每一个用户对应一个 userId,这个 userId 是您维护的,所以您可以直接赋值,两个您的的用户通信,对于融云来说就是两个 userId 间通讯。
  • name : 用户的显示名称,用来在 Push 推送时,或者您没有传入用户信息时,默认显示的用户名称。
  • portraitUri : 用户头像,用来当您没有传入用户信息时作为默认头像,如果图片不存在,IMKit 会显示默认头像。

通过 API 调试,您可以得到一个 Token 返回值。您就可以直接使用这个 Token 为这位用户进行发送和接受消息。

SDK 下载

您可以到融云官方网站下载融云 SDK。融云 SDK 各部分功能以插件化的形式独立提供,

开发者可以根据自己的需要,自由组合下载。各组件的功能如下:

名词 功能介绍 支持的 CPU 架构
IMKit 融云 IM 界面组件 ——
IMLib 融云 IM 通讯能力库 armeabi, armeabi-v7a, arm64-v8a,
CallKit 融云音视频界面组件 ——
CallLib 融云音视频核心组件 armeabi-v7a, x86
LocationLib 融云位置相关库 ——
PushLib 融云第三方推送库 armeabi, armeabi-v7a, arm64-v8a
RedPacket 融云红包相关组件 ——

IMKit 集成了会话界面,并且提供了丰富的自定义功能,我们推荐首次接触融云的客户直接使用 IMKit 来快速集成和开发。

IMLib 提供了基础的通信能力,较轻量,适用于对 UI 有较高订制需求的开发者,但您需要自己去实现大量的界面和功能。

CallKit 融云音视频通话的界面组件,包含了单人、多人音视频通话的界面的各种场景和功能。您可以通过集成该组件来实现丰富的音视频通话界面,并进行自己的 UI 定制开发。同时我们开源了 CallKit,您可以根据您的需要去使用。 

CallLib 融云音视频通话核心能力组件。

LocationLib 位置相关库文件

PushLib 融云支持第三方推送(小米),您可以从这里下载对应的第三方推送 jar 包。

RedPacket 融云红包相关组件,通过集成该组件,即可快速实现红包功能。

SDK 下载链接

为了方便广大开发者,节约您的开发资源和时间,我们在 GitHub 上提供了一组开源的 Server SDK。您可以选择合适的语言直接应用在您的服务端项目中。

猜你喜欢

转载自www.cnblogs.com/sunupo/p/10572328.html