微信《小程序·云》實時數據推送支持實時推送變更數據的能力【珠海微信小程序定制開發電話】為了進一步提高在即時通信、實時數據更新和推送等場景下的開發效率，小程序·云開發新增實時數據推送能力。開發者在小程序端給定查詢條件后，每當查詢結果發生變更時，小程序可收到一個更新事件，實時獲取更新內容。實時數據推送可被廣泛地應用于棋牌類等回合制小游戲、在線協作文檔以及團隊任務管理等場景。

微信《小程序·云》實時數據推送支持實時推送變更數據的能力

介紹

云開發數據庫支持實時推送變更數據的能力，給定查詢條件，每當數據庫更新而導致查詢條件對應的查詢結果發生變更時，小程序可收到一個更新事件，其中可獲取更新內容和更新后的查詢結果快照。

實時數據推送有廣泛應用場景，此處是一些示例：

1. 聊天/即時通信：小游戲內聊天、大廳廣播、區服廣播等；企業內部小程序中的即時通信能力等

2. 多人小游戲：使用狀態同步的小游戲，如棋牌類等回合制游戲

3. 協作工具：如在線協作文檔、團隊任務管理等

4. 實時應用狀態同步：以信息流為例，可以實時獲取最新文章、以及最新評論、點贊、通知等內容，讓交互更順暢自然

監聽

調用 Collection 上的 watch 方法即可監聽給定查詢條件對應的數據：

const db = wx.cloud.database() const watcher = db.collection('todos').where({ team: 'our dev team' }).watch({ onChange: function(snapshot) { console.log('docs\'s changed events', snapshot.docChanges) console.log('query result snapshot after the event', snapshot.docs) console.log('is init data', snapshot.type === 'init') }, onError: function(err) { console.error('the watch closed because of error', err) } }) // ... // 等到需要關閉監聽的時候調用 close() 方法 watcher.close()

onChange 和 onError 是必傳參數。onChange 用于接收變更快照，onError 用于處理監聽錯誤。如果監聽發起失敗或監聽過程中出現不可恢復的錯誤，則會終止監聽并通過 onError 拋出異常。onChange 會在第一次監聽初始化及后續數據變更時收到推送事件。第一次初始化時會收到的查詢條件對應的查詢結果（此處不會有默認 20 條上限，包含集合中所有滿足查詢條件的記錄），后續變更事件會包含變更內容和變更后的查詢結果快照。

onChange 收到的 snapshot 變更快照中帶有如下字段：

ChangeEvent 記錄變更事件的內容包括：

DataType 枚舉值

QueueType 枚舉值

變更事件會細分記錄數據變更類型 dataType 和監聽列表變更類型 queueType，其可能的搭配和意義如下。

注意事項與系統限制

監聽返回的數據不受默認 20 條限制

監聽返回的數據可能超過 20 條，不受小程序端默認 20 條上限限制。

監聽暫只支持 where 語句

監聽暫僅支持 where 語句，不支持 orderBy、limit、field 等語句。

監聽記錄數限制

一次監聽的記錄數上限為 5000，若超出上限會拋錯并停止監聽。監聽過大量的數據時初始化會較慢，對監聽效率也有影響，如果預期監聽發起時少于 5000，但后續有可能超過 5000，請注意在即將超過時重新監聽并保證不超過 5000。

最佳實踐

只監聽必要的數據

監聽時應明確查詢條件，只監聽必須用到的數據，避免監聽不必要的數據，以此提高初次加載數據的性能以及接收數據變更的性能。