broadcast

来自于:官方立即使用

概述

broadcast 模块广播通信的模块,可用于跨应用间通信。**

send

发送广播

send({params}, callback(ret, err))

params

data:

  • 类型:JSON对象
  • 描述:要发送的内容

target:

  • 类型:字符串类型
  • 描述:(可选)要发送给应用的包名

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    status: true,           //布尔型;是否有应用收到并监听了广播
    msg:''                       //字符串类型;状态描述
}

示例代码

var broadcast = api.require('broadcast');
broadcast.send({
    data:{str:'open'},
    target:''
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

setListener

设置当前页面广播监听

setListener({params}, callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    data:{}                    //JSON对象;接收到其他应用的数据
}

示例代码

var broadcast = api.require('broadcast');
broadcast.setListener( function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

removeListener

移除当前页面监听

removeListener({params}, callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    data:{}                    //JSON对象;接收到其他应用的数据
}

示例代码

var broadcast = api.require('broadcast');
broadcast.removeListener( function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本