融云Windows PC SDK0.9.9 官方最新版【c# c++】

融云Windows PC SDK简单几行代码集成无难度，持文本、图文、语音、位置等消息类型，高度自定义，稳定可靠。

融云Windows PC SDK前期准备

1、注册开发者帐号

开发者在集成融云即时通讯、实时网络能力前，需前往 融云官方网站 注册创建融云开发者帐号。

2、下载 SDK

您可以到 融云官方网站 下载融云 Windows PC SDK。

Windows PC SDK 以 DLL 组件方式为开发者提供基础的通信能力，较轻量，暂不提供 IMKit 界面组件，开发者需要自己去实现 UI 界面功能。

3、创建应用

您要进行应用开发之前，需要先在融云开发者平台创建应用。如果您已经注册了融云开发者帐号，请前往 融云开发者平台 创建应用。

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

App Key / Secret 位置

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

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

4、获取 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 为这位用户进行发送和接受消息。

融云Windows PC SDK集成环境

1、环境要求

集成融云 SDK 操作系统环境要求如下：

WIN 7、WIN 8、WIN 10 版本系统。

2、开发前准备

SDK 只提供动态加载 dll 的方式获取 API 并调用。App 开发者只需要引用 SDK 包里 rcsdk.h / rcsdk.cs 模块定义头文件即可。关于API 的定义，可以查看 API 文档或 SDK 包里定义的头文件。

SDK 提供了 2 种类型的接口：

第一种：注册回调和执行接口分开定义，这类接口需要提前注册好回调函数，然后执行接口时，调用相应的回调函数输出结果，App 上层需要在回调函数里处理结果。这类回调函数可能由调用执行接口触发，也有可能由 SDK 主动触发，一般由 SDK 主动触发回调函数（如接收消息等）。

第二种：回调函数作为参数，传入执行接口，然后执行接口时，会触发传入的回调函数。

融云提供了基于 C++ 的 dll 和 C# 的 dll 来满足桌面用户的开发需要。C# 和 C++ 开发流程一样，本文以 C++ / C# 为例来描述一下开发流程。