broadcast

来自于：官方立即使用

send setListener removeListener

概述

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

send

发送广播

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

params

data：

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

target：

  • 类型：字符串类型
  • 描述：（可选）要发送给应用的包名

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  3.     status: true,           //布尔型；是否有应用收到并监听了广播
  4.     msg:''                       //字符串类型；状态描述
  5. }

示例代码

  1. var broadcast = api.require('broadcast');
  2. broadcast.send({
  3.     data:{str:'open'},
  4.     target:''
  5. }, function(ret, err) {
  6.     if (ret) {
  7.         alert(JSON.stringify(ret));
  8.     } else {
  9.         alert(JSON.stringify(err));
  10.     }
  11. });

setListener

设置当前页面广播监听

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

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  3.     data:{}                    //JSON对象；接收到其他应用的数据
  4. }

示例代码

  1. var broadcast = api.require('broadcast');
  2. broadcast.setListener( function(ret, err) {
  3.     if (ret) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

removeListener

移除当前页面监听

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

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  3.     data:{}                    //JSON对象；接收到其他应用的数据
  4. }

示例代码

  1. var broadcast = api.require('broadcast');
  2. broadcast.removeListener( function(ret, err) {
  3.     if (ret) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本