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

融云Windows PC SDK簡單幾行代碼集成無難度，持文本、圖文、語音、位置等消息類型，高度自定義，穩(wěn)定可靠。

融云Windows PC SDK前期準(zhǔn)備

1、注冊開發(fā)者帳號

開發(fā)者在集成融云即時通訊、實(shí)時網(wǎng)絡(luò)能力前，需前往 融云官方網(wǎng)站 注冊創(chuàng)建融云開發(fā)者帳號。

2、下載 SDK

您可以到 融云官方網(wǎng)站 下載融云 Windows PC SDK。

Windows PC SDK 以 DLL 組件方式為開發(fā)者提供基礎(chǔ)的通信能力，較輕量，暫不提供 IMKit 界面組件，開發(fā)者需要自己去實(shí)現(xiàn) UI 界面功能。

3、創(chuàng)建應(yīng)用

您要進(jìn)行應(yīng)用開發(fā)之前，需要先在融云開發(fā)者平臺創(chuàng)建應(yīng)用。如果您已經(jīng)注冊了融云開發(fā)者帳號，請前往 融云開發(fā)者平臺 創(chuàng)建應(yīng)用。

您創(chuàng)建完應(yīng)用后，首先需要了解的是 App Key / Secret，它們是融云 SDK 連接服務(wù)器所必須的標(biāo)識，每一個 App 對應(yīng)一套 App Key / Secret。針對開發(fā)者的生產(chǎn)環(huán)境和開發(fā)環(huán)境，我們提供兩套 App Key / Secret，兩套環(huán)境的功能完全一致。您在應(yīng)用最終上線前，使用開發(fā)環(huán)境即可。

App Key / Secret 位置

開發(fā)環(huán)境 App Key / Secret 是專門為您提供的僅供開發(fā)使用的，開發(fā)環(huán)境將和生產(chǎn)環(huán)境的數(shù)據(jù)隔離，避免開發(fā)環(huán)境數(shù)據(jù)和線上生產(chǎn)環(huán)境數(shù)據(jù)互相沖突。 

生產(chǎn)環(huán)境的 App Key / Secret 默認(rèn)先不提供，等您提交上線后，我們會提供生產(chǎn)環(huán)境的 App Key / Secret。

4、獲取 Token

Token 稱為用戶令牌，App Key 是您的 App 的唯一標(biāo)識，Token 則是您 App 上的每一個用戶的身份授權(quán)象征。您可以通過提交 userId 等信息來獲得一個該用戶對應(yīng)的 Token，并使用這個 Token 作為該用戶的唯一身份憑證與其他用戶進(jìn)行通信。 

Token 的主要作用是身份授權(quán)和安全，因此不能通過客戶端直接訪問融云服務(wù)器獲取 Token，您必須通過 Server API 從融云服務(wù)器 獲取 Token 返回給您的 App，并在之后連接時使用。詳細(xì)描述請參考 Server 開發(fā)指南 中的用戶服務(wù)和獲取 Token 方法小節(jié)。

為了方便您在集成和測試過程中使用，我們還提供了 API 調(diào)試工具，在您不能部署服務(wù)器程序時，可以直接通過傳入 userId 和 name 來獲得 Token。請?jiān)L問 融云開發(fā)者平臺，打開您想測試的應(yīng)用，在左側(cè)菜單中選擇“API 調(diào)試”即可。

userId : 每一個用戶對應(yīng)一個 userId，這個 userId 是您維護(hù)的，所以您可以直接賦值，兩個您的的用戶通信，對于融云來說就是兩個 userId 間通訊。

name : 用戶的顯示名稱，用來在 Push 推送時，或者您沒有傳入用戶信息時，默認(rèn)顯示的用戶名稱。

portraitUri : 用戶頭像，用來當(dāng)您沒有傳入用戶信息時作為默認(rèn)頭像，如果圖片不存在，IMKit 會顯示默認(rèn)頭像。

通過 API 調(diào)試，您可以得到一個 Token 返回值。你就可以直接使用這個 Token 為這位用戶進(jìn)行發(fā)送和接受消息。

融云Windows PC SDK集成環(huán)境

1、環(huán)境要求

集成融云 SDK 操作系統(tǒng)環(huán)境要求如下：

WIN 7、WIN 8、WIN 10 版本系統(tǒng)。

2、開發(fā)前準(zhǔn)備

SDK 只提供動態(tài)加載 dll 的方式獲取 API 并調(diào)用。App 開發(fā)者只需要引用 SDK 包里 rcsdk.h / rcsdk.cs 模塊定義頭文件即可。關(guān)于API 的定義，可以查看 API 文檔或 SDK 包里定義的頭文件。

SDK 提供了 2 種類型的接口：

第一種：注冊回調(diào)和執(zhí)行接口分開定義，這類接口需要提前注冊好回調(diào)函數(shù)，然后執(zhí)行接口時，調(diào)用相應(yīng)的回調(diào)函數(shù)輸出結(jié)果，App 上層需要在回調(diào)函數(shù)里處理結(jié)果。這類回調(diào)函數(shù)可能由調(diào)用執(zhí)行接口觸發(fā)，也有可能由 SDK 主動觸發(fā)，一般由 SDK 主動觸發(fā)回調(diào)函數(shù)（如接收消息等）。

第二種：回調(diào)函數(shù)作為參數(shù)，傳入執(zhí)行接口，然后執(zhí)行接口時，會觸發(fā)傳入的回調(diào)函數(shù)。

融云提供了基于 C++ 的 dll 和 C# 的 dll 來滿足桌面用戶的開發(fā)需要。C# 和 C++ 開發(fā)流程一樣，本文以 C++ / C# 為例來描述一下開發(fā)流程。