本文说明如何在小程序中集成 JMessage。jmessage-wxapplet-sdk 是 JMessage 专门为适配小程序应用而开发的,其功能基本涵盖所有 WEB SDK 所提供的功能
GitHub 下载地址:https://github.com/jpush/jmessage-wxapplet-sdk
socket 合法域名:wss://ws.im.jiguang.cn
uploadFile 合法域名:https://sdk.im.jiguang.cn
downloadFile 合法域名:https://dl.im.jiguang.cn/
1.下载 jmessage-wxapplet-sdk-.js,移动到 libs 目录下
2.在 app.js 中引入:
var JMessage=require('./libs/jmessage-wxapplet-sdk-<version>.js')
新建 JMessage 对象:
var jim = new JMessage({
// debug : true
});
初始化连接:
jim.init({
"appkey" : "<appkey>",
"random_str": "<random_str>",
"signature" : "<signature>",
"timestamp" : "<timestamp>"
}).onSuccess(function(data) {
//TODO
}).onFail(function(data) {
//TODO
});
所有 api 操作跟 WEB SDK 类似,可以直接参考 WEB SDK API
-
小程序不支持文件传输,所以单聊以及群聊文件发送相关 api 不可用
-
发送图片(单聊和群聊)接口跟 WEB SDK API 有所差异
//先通过小程序API获取图片 wx.chooseImage({ count: 1, // sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图,默认二者都有 sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机,默认二者都有 success: function (res) { var tempFilePaths = res.tempFilePaths[0]; //获取成功,读取文件路径 jim.sendSinglePic({ 'target_username' : '<target_username>', 'target_nickname' : '<target_nickname>', 'appkey' : '<appkey>', 'image' : tempFilePaths //设置图片参数 }).onSuccess(function(data,msg) { //TODO }).onFail(function(data) { //TODO }); } })