融云Windows PC SDK簡(jiǎn)單幾行代碼集成無(wú)難度,持文本、圖文、語(yǔ)音、位置等消息類型,高度自定義,穩(wěn)定可靠。
融云Windows PC SDK前期準(zhǔn)備
1、注冊(cè)開(kāi)發(fā)者帳號(hào)
開(kāi)發(fā)者在集成融云即時(shí)通訊、實(shí)時(shí)網(wǎng)絡(luò)能力前,需前往 融云官方網(wǎng)站 注冊(cè)創(chuàng)建融云開(kāi)發(fā)者帳號(hào)。
2、下載 SDK
您可以到 融云官方網(wǎng)站 下載融云 Windows PC SDK。
Windows PC SDK 以 DLL 組件方式為開(kāi)發(fā)者提供基礎(chǔ)的通信能力,較輕量,暫不提供 IMKit 界面組件,開(kāi)發(fā)者需要自己去實(shí)現(xiàn) UI 界面功能。
3、創(chuàng)建應(yīng)用
您要進(jìn)行應(yīng)用開(kāi)發(fā)之前,需要先在融云開(kāi)發(fā)者平臺(tái)創(chuàng)建應(yīng)用。如果您已經(jīng)注冊(cè)了融云開(kāi)發(fā)者帳號(hào),請(qǐng)前往 融云開(kāi)發(fā)者平臺(tái) 創(chuàng)建應(yīng)用。
您創(chuàng)建完應(yīng)用后,首先需要了解的是 App Key / Secret,它們是融云 SDK 連接服務(wù)器所必須的標(biāo)識(shí),每一個(gè) App 對(duì)應(yīng)一套 App Key / Secret。針對(duì)開(kāi)發(fā)者的生產(chǎn)環(huán)境和開(kāi)發(fā)環(huán)境,我們提供兩套 App Key / Secret,兩套環(huán)境的功能完全一致。您在應(yīng)用最終上線前,使用開(kāi)發(fā)環(huán)境即可。
App Key / Secret 位置
開(kāi)發(fā)環(huán)境 App Key / Secret 是專門(mén)為您提供的僅供開(kāi)發(fā)使用的,開(kāi)發(fā)環(huán)境將和生產(chǎn)環(huán)境的數(shù)據(jù)隔離,避免開(kāi)發(fā)環(huán)境數(shù)據(jù)和線上生產(chǎn)環(huán)境數(shù)據(jù)互相沖突。
生產(chǎn)環(huán)境的 App Key / Secret 默認(rèn)先不提供,等您提交上線后,我們會(huì)提供生產(chǎn)環(huán)境的 App Key / Secret。
4、獲取 Token
Token 稱為用戶令牌,App Key 是您的 App 的唯一標(biāo)識(shí),Token 則是您 App 上的每一個(gè)用戶的身份授權(quán)象征。您可以通過(guò)提交 userId 等信息來(lái)獲得一個(gè)該用戶對(duì)應(yīng)的 Token,并使用這個(gè) Token 作為該用戶的唯一身份憑證與其他用戶進(jìn)行通信。
Token 的主要作用是身份授權(quán)和安全,因此不能通過(guò)客戶端直接訪問(wèn)融云服務(wù)器獲取 Token,您必須通過(guò) Server API 從融云服務(wù)器 獲取 Token 返回給您的 App,并在之后連接時(shí)使用。詳細(xì)描述請(qǐng)參考 Server 開(kāi)發(fā)指南 中的用戶服務(wù)和獲取 Token 方法小節(jié)。
為了方便您在集成和測(cè)試過(guò)程中使用,我們還提供了 API 調(diào)試工具,在您不能部署服務(wù)器程序時(shí),可以直接通過(guò)傳入 userId 和 name 來(lái)獲得 Token。請(qǐng)?jiān)L問(wèn) 融云開(kāi)發(fā)者平臺(tái),打開(kāi)您想測(cè)試的應(yīng)用,在左側(cè)菜單中選擇“API 調(diào)試”即可。
userId : 每一個(gè)用戶對(duì)應(yīng)一個(gè) userId,這個(gè) userId 是您維護(hù)的,所以您可以直接賦值,兩個(gè)您的的用戶通信,對(duì)于融云來(lái)說(shuō)就是兩個(gè) userId 間通訊。
name : 用戶的顯示名稱,用來(lái)在 Push 推送時(shí),或者您沒(méi)有傳入用戶信息時(shí),默認(rèn)顯示的用戶名稱。
portraitUri : 用戶頭像,用來(lái)當(dāng)您沒(méi)有傳入用戶信息時(shí)作為默認(rèn)頭像,如果圖片不存在,IMKit 會(huì)顯示默認(rèn)頭像。
通過(guò) API 調(diào)試,您可以得到一個(gè) Token 返回值。你就可以直接使用這個(gè) 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、開(kāi)發(fā)前準(zhǔn)備
SDK 只提供動(dòng)態(tài)加載 dll 的方式獲取 API 并調(diào)用。App 開(kāi)發(fā)者只需要引用 SDK 包里 rcsdk.h / rcsdk.cs 模塊定義頭文件即可。關(guān)于API 的定義,可以查看 API 文檔或 SDK 包里定義的頭文件。
SDK 提供了 2 種類型的接口:
第一種:注冊(cè)回調(diào)和執(zhí)行接口分開(kāi)定義,這類接口需要提前注冊(cè)好回調(diào)函數(shù),然后執(zhí)行接口時(shí),調(diào)用相應(yīng)的回調(diào)函數(shù)輸出結(jié)果,App 上層需要在回調(diào)函數(shù)里處理結(jié)果。這類回調(diào)函數(shù)可能由調(diào)用執(zhí)行接口觸發(fā),也有可能由 SDK 主動(dòng)觸發(fā),一般由 SDK 主動(dòng)觸發(fā)回調(diào)函數(shù)(如接收消息等)。
第二種:回調(diào)函數(shù)作為參數(shù),傳入執(zhí)行接口,然后執(zhí)行接口時(shí),會(huì)觸發(fā)傳入的回調(diào)函數(shù)。
融云提供了基于 C++ 的 dll 和 C# 的 dll 來(lái)滿足桌面用戶的開(kāi)發(fā)需要。C# 和 C++ 開(kāi)發(fā)流程一樣,本文以 C++ / C# 為例來(lái)描述一下開(kāi)發(fā)流程。
- PC官方版
- 安卓官方手機(jī)版
- IOS官方手機(jī)版