Uniapp作為近來最火的移動端開發技術，一套代碼，可以打包成Android/iOS app和各種平臺的小程序，可謂是沒有最方便只有更方便。

GoEasy上架DCloud Uniapp插件市場已經有一段時間了，收到很多Uniapp開發人員的贊揚和好評，小編在此隔著屏幕向大家鞠躬，小編和GoEasy團隊會繼續努力，持續為Uniapp開發者提供最簡單且優雅的API，穩定高速可靠的即時通訊服務。

這段時間，也收到了很多朋友的一些問題？比如：

1、GoEasy和Uniapp websocket API有什么區別和優勢？

Uniapp官方的websocket API主要是用來與您的websocket服務通訊，所以使用Uniapp websocket的前提是，首先要搭建好您自己的websocket服務，然后與之通訊。這是一個純技術的API，在建立網絡連接后，還有很多的工作需要自己來完成，比如：

需要自己實現心跳機制，來維護網絡連接，來判斷客戶端的網絡連接狀態；

需要自己實現斷網自動重連；

需要自己維護消息列表，確保遇到斷網重連后，消息能夠補發；

需要自己維護一個客戶端列表；

…

等等很多細致而繁雜的工作，比如websocket的安全機制和性能優化；

除此之外服務端也有很多工作需要自己完成，有興趣自己搭建websocket的話，可以參考這篇技術分享《 搭建websocket消息推送服務，必須要考慮的幾個問題》

而GoEasy是一個成熟穩定的websocket企業級PAAS服務平臺，開發人員不需要考慮websocket服務端的搭建，只需要幾行代碼，就可以輕松實現客戶端與客戶端之間，服務器與客戶端之間的的websocket通信，不需要考慮性能，安全，高可用集群的問題。只需要全力專注于開發自己的業務功能就好了。

GoEasy已經內置websocket中必備的心跳，斷網重連，消息補發，歷史消息和客戶端上下線提醒等特性，開發人員也不需要自己搭建websocket服務處理集群高可用，安全和性能問題。GoEasy已經穩定運行了5年，支持千萬級并發，成功支撐過很多知名企業的重要活動，安全性和可靠性都是久經考驗。

2、GoEasy在Uniapp開發中主要用在哪些場景呢？

首先從技術上說，Uniapp支持的所有技術android, iOS和小程序，GoEasy都是完美支持的。

從應用場景上來說，所有需要websocket通信的場景，GoEasy都可以完美支持：

聊天，IM，直播彈幕，用戶上下線提醒, 在線用戶列表

掃碼點菜，掃碼登錄， 掃碼支付， 掃碼簽到， 掃碼打印

事件提醒，工單，訂單實時提醒

在線拍賣， 在線點餐，在線選座 實時數據展示，實時監控大屏， 金融實時行情顯示，設備監控系統

實時位置跟蹤，外賣實時跟蹤，物流實時跟蹤

遠程畫板，遠程醫療，游戲，遠程在線授課

…

3、GoEasy的文檔為什么這么簡單？簡單到我都不知道如何使用

簡單還不好嗎？GoEasy從研發的第一天，就把追求API的極簡作為我們的工作重點。嚴格控制接口的數量，就是是為了降低開發人員的學習成本，其實就是為了讓您爽啊！但這并不影響GoEasy完美支持所有的websocket即時通訊需求。

今天小編就手把手的教您用GoEasy在Uniapp下，最短的時間實現一個的web即時通訊Demo。

本demo已經通過小程序, iOS和Android的真機測試，完整源代碼已經上傳gitee，下載后，只需要將代碼里的appkey換成自己的common key，就可以體驗了。下載地址：

https://gitee.com/goeasy-io/GoEasyDemo-Uniapp-Helloworld

1、獲取appkey

GoEasy官網（ http://www.goeasy.io/） 上注冊賬號，創建一個應用，拿到您的appkey

GoEasy提供了兩種類型的appkey：

Common key: 即可以接收消息，也可以發送消息，與Subscriber Key最大的區別就是有寫權限，可以發消息。適用于有消息發送需求的客戶端和服務端開發。

Subscriber key: 只能接收消息，不可以發送消息，與Common Key最大的區別就是沒有寫權限，只能收消息。可以用于一些沒有發送需求的客戶端。

2、獲取GoEasy SDK

兩個方式：

DCloud Uniapp的插件市場下載： https://ext.dcloud.net.cn/plugin?id=1334

也可以直接在goeasy官網下載： https://www.goeasy.io/cn/doc/client/get-goeasy-js.html

3、初始化GoEasy對象

在main.js中將goeasy初始化為Uniapp的全局對象，方便所有頁面都能方便的調用，同時也避免多個頁面反復new GoEasy對象。

根據您在GoEasy后臺創建應用時選擇的區域，來傳入不同的Host,如果您創建goeasy應用時,選擇了杭州，那么host:”hangzhou.goeasy.io”。選擇了新加坡,host:”singapore.goeasy.io”。

如果您的大部分用戶都是在國內，創建應用時，記得選擇杭州，以便獲得更快的通訊速度。

// 在main.js中將goeasy初始化為全局對象，所有頁面都能方便的調用，也避免多個頁面反復new GoEasy對象
Vue.prototype.$goEasy = new GoEasy({
host: "hangzhou.goeasy.io",
appkey: "my_appkey", //替換為您的應用appkey
    onConnected: function() {
      console.log('連接成功！')
    },
    onDisconnected: function() {
      console.log('連接斷開！')
    },
    onConnectFailed: function(error) {
      console.log('連接失敗或錯誤！')
    }
});

4、uniapp端接收消息

this.$goEasy.subscribe({
    channel: "my_channel", //替換為您自己的channel
    onMessage: function (message) {
        alert("Channel:" + message.channel + " content:" + message.content);
    }
});

很多朋友會問channel從哪里來，如何創建，應該傳入什么呢？

根據您的業務需求來設定，channel可以為任意字符串，除了不能包含空格，和不建議使用中文外，沒有任何限制，只需要和消息的發送端保持一致，就可以收到消息。channel可以是您直播間的uuid,也可以是一個用戶的唯一表示符，可以任意定義，channel不需要創建，可以隨用隨棄。

5、uniapp端發送消息

發送時，需要注意channel一定要和subscriber的channel完全一致，否則無法收到。

this.$goEasy.publish({
    channel: "my_channel", //替換為您自己的channel
    message: "Hello, GoEasy!" //替換為您想要發送的消息內容
});

本代碼源碼下載：

https://gitee.com/goeasy-io/GoEasyDemo-Uniapp-Helloworld

小程序特別強調：

若您需要打包為微信小程序，需要在微信公眾號平臺配置socket合法域名，否則無法使用。 具體步驟：

訪問 https://mp.weixin.qq.com，進入微信公眾平臺|小程序 -> 設置 -> 開發設置 -> 服務器域名

socket合法域名-> 添加 goeasy的地址：wx-hangzhou.goeasy.io（記得wx-開頭）

若您創建GoEasy應用時選擇了新加坡區域則添加地址：wx-singapore.goeasy.io

答疑時間：

1、我的服務器端可以發送消息嗎？都支持些哪些語言？

當然可以，任何語言都可以通過調用goeasy的Rest API發送消息，同時為了大家方便，GoEasy的官方文檔里，也準備了Java, C#,NodeJS，PHP，Ruby和Python等常見語言調用REST API的代碼，這里獲取更多詳情： https://www.goeasy.io/cn/doc/server/publish.html

2、GoEasy可以發送圖片，語音和視頻嗎？

當然可以，您可以通過推送文件路徑的方式來實現文件的發送。

按照行業慣例，不論MSN，微信，QQ對于圖片和視頻，通常的做法都是，只推送文件路徑，而不會推送文件本身。你如果有注意的話，當您接受圖片和視頻的時候，收到消息后，等一會兒才能看，就是因為發送的時候，只發送了路徑。