融云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# 為例來描述一下開發流程。
- PC官方版
- 安卓官方手機版
- IOS官方手機版