实时数据推送

云开发数据库支持实时推送变更数据的能力，给定查询条件，每当数据库更新而导致查询条件对应的查询结果发生变更时，在小程序端就可收到一个更新事件，通过更新时间返回的对象就可获取更新内容和更新后的查询结果快照。

应用场景与注意事项

实时数据推送的应用场景

当用户在小程序端停留时间比较长，需要关注其他用户的行为而导致的一些数据的实时变化时，就可以使用实时数据推送，只要数据发生变动，都能实时的在前端呈现出来。实时数据推送有着广泛的应用场景：

实时数据推送注意事项

实时数据推送案例

数据库的实时监听既可以监听集合中符合查询条件的文档的变化，也可以监听单个doc，下面以监听单个doc为例。使用开发者工具新建一个页面，比如snapshot，然后在snapshot.wxml里输入一个可以修改数据的button，比如点击一下就会增加点赞次数：

<button bindtap="addStar">点赞{{stars}}</button>

然后在数据库里新建一个集合比如livevideo（注意要修改集合的权限可以用安全规则修改为所有人可读可写，或者将点赞采用调用云函数的方式），添加一个简单的记录比如：

"_id":"room2020032101",
"star":0

再在snapshot.js的data属性里声明stars，以及添加事件处理函数addStar,还有就是在页面的onLoad生命周期函数里监听数据的变化，并将数据的变化渲染到页面。

  data:{
    stars:0
  },
  onLoad: function() {
    const that =this
    const watcher = db.collection('livevideo').doc('room2020032101')
    .watch({
      onChange: function(snapshot) {
        that.setData({
          stars:snapshot.docs[0].star
        })
        console.log('文档数据发生变化', snapshot)
      },
      onError: function(err) {
        console.error('监听因错误停止', err)
      }
    })
  }
  addStar(){
    db.collection('livevideo').doc('room2020032101').update({
      data: {
        star:  _.inc(1)
      },
      success: console.log,
      fail: console.error
    })
  }

watch有两个属性，onError是失败回调，onChange是成功回调，成功回调传入的参数 snapshot 是变更快照。onChange 和 onError 是必传参数。onChange 用于接收变更快照，onError 用于处理监听错误。如果监听发起失败或监听过程中出现不可恢复的错误，则会终止监听并通过 onError 抛出异常。onChange 会在第一次监听初始化及后续数据变更时收到推送事件。第一次初始化时会收到的查询条件对应的查询结果，后续变更事件会包含变更内容和变更后的查询结果快照。

如果想要预览实时数据推送的效果，可以使用开发者工具的多账号调试，在开发者工具栏-工具-多账号调试即可。当A用户点击点赞的button，点赞的数量就会实时同步给所有在线用户的小程序端。在多账号的控制台里也能实时看到打印的信息。

我们可以留意打印的snapshot对象，这个对象包含的信息非常多，主要有

docChanges对象里的queueType和dataType字段，前者表示更新事件对监听列表的影响，后者表示记录的具体更新类型。

注意这两者的不同，比如上面的案例我们只是更新了字段的值，所以它为update；如果监听的记录出现增加，或者减少，queueType的值就会有所不同，而removedFields也会有删除的字段；而dataType字段的值则与数据库请求的方法相对应，而所有更新的字段及字段更新后的值都会在updatedFields对象里。