Skip to main content

快速上手

安装​

直接引用js文件​

// 下载文件https://dianxiu.coding.net/public/longjingsdk/jlongjing/git/files/master/dist/jlongjing.min.js
// 放到应用下的目录dist
<script src="./dist/jlongjing.min.js"></script>

规范​

名称字段说明
返回码code值为0时，正常
数据data出参
异常信息msgcode!=0时，返回该字段

入参格式及类型​

{
    keyName1:'字符串', // 字符串
    keyName2:['数组'], // 数组
    keyName3:{key:''}, // 对象
    keyName2:true      // boolean
}

出参格式及类型​

//成功
{
    "code":0,
    "data":{
        "key1":value1，
        "key2":value2
    }
}
//失败
{
    "code":-1,
    "msg":"错误信息"
}

js调用Native(H5应用调用app)​

  • 使用格式
// fnName = 'reboot'  方法名称   string
// options = {}  入参   jsonObject
// callback  = function(){} 回调函数  function
longjing.call(fnName,options,callback);
  • 示例一（无输出值）:
// 主动调用方法，无返回值
longjing.call('loadSuccess');  // 告知app，页面加载完成
  • 示例二（同步输出）:
// 主动调用方法，有返回值
// app返回的是{code:0,data:{id:888}};
// longjing过滤出返回值中的data
var appId = longjing.call('getAppId').id;
  • 示例三（异步输出）:
// 主动调用方法，回调中返回
// 回调返回的是{code:0,data:{url:'...'}};
// longjing过滤出回调返回值中的data
longjing.call('tts.speak',{text:'...'},function(bridge){
    if(bridge.code == 0){
        let data = bridge.data;
        // 语音播放完毕后的回调处理
        // todo ...
    }else{
        // js和app通讯桥异常
    }

})

Native调用JS(app通知到应用)​

通知的方法只需要注册一次。业务触发后，app端会通过该通知的回调返回结果。

  • 使用格式
// fnName = 'reboot'  方法名称   string
// options = {}  入参   jsonObject
// callback  = function(){} 回调函数  function
longjing.register(fnName,options,callback);
  • 示例一（异步输出）:
// 注册一个软键盘状态改变时通知
longjing.register('SOFT_INPUT_CHANGED ',function(bridge){
    if(bridge.code == 0){
        // js和app通讯桥成功，接收到通知
        // 开始处理通知业务
        let data = bridge.data;
    }else{
        // js和app通讯桥异常
    }
});