JMessage MiniProgram SDK 集成指南

本文说明如何在小程序中集成 JMessage。jmessage-wxapplet-sdk 是 JMessage 专门为适配小程序应用而开发的，其功能基本涵盖所有 Web 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')

          var JMessage=require('./libs/jmessage-wxapplet-sdk-<version>.js')

此代码块在浮窗中显示

新建 JMessage 对象：

var jim = new JMessage({ // debug : true });

          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 });

           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

其他说明

小程序SDK视频发送接口

//单聊发送视频示例,群聊、聊天室类似 //先通过小程序API获取视频资源 wx.chooseVideo({ sourceType: ['album', 'camera'], camera: 'back', success: function (res) { //sendGroupVedio(),sendChatroomVedio()类似 jim.sendSingleVedio({ 'target_username' : '<target_username>', 'target_nickname' : '<target_nickname>', 'appkey' : '<appkey>', 'file' : res.tempFilePath }).onSuccess(function(data,msg) { //TODO }).onFail(function(data) { //TODO }); } })

          //单聊发送视频示例,群聊、聊天室类似
//先通过小程序API获取视频资源
wx.chooseVideo({
        sourceType: ['album', 'camera'],
        camera: 'back',
        success: function (res) {
                      //sendGroupVedio(),sendChatroomVedio()类似
                      jim.sendSingleVedio({
                         'target_username' : '<target_username>',
                            'target_nickname' : '<target_nickname>',
                                     'appkey' : '<appkey>',
                                    'file' : res.tempFilePath
                             }).onSuccess(function(data,msg) {
                                //TODO
                             }).onFail(function(data) {
                                //TODO
                              });
                   }
            })

此代码块在浮窗中显示

发送图片(单聊,群聊,聊天室)接口跟 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 }); } })

                //先通过小程序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
                            });
                 }
          })

此代码块在浮窗中显示