編輯頁面

從伺服器發送即時訊息到一個或多個客戶端

概觀

Sails 提供了兩個 API 用於與已連接的 Socket 客戶端通訊：高階的 resourceful pubsub API 和低階的 sails.sockets API。

Resourceful PubSub

Resourceful PubSub (發布/訂閱) API 提供了一種高階方式，讓 Socket 訂閱 Sails 模型類別和實例。完全有可能僅使用此 API 創建豐富的即時體驗 (例如，聊天應用程式)。Sails 藍圖使用 Resourceful PubSub 自動發送關於新模型實例和現有實例變更的通知，但您也可以在自訂控制器操作中使用它們。

範例

建立一個新的 User 模型實例並通知所有感興趣的客戶端

// Create the new user
User.create({
  name: 'johnny five'
}).exec(function(err, newUser) {
  if (err) {
    // Handle errors here!
    return;
  }
  // Tell any socket watching the User model class
  // that a new User has been created!
  User.publishCreate(newUser);
});

`sails.sockets`

sails.sockets API 允許直接與 Socket 進行更低階的通訊，使用的方法包括 sails.sockets.join() (將 Socket 訂閱到發送到特定 "房間" 的所有訊息)、sails.sockets.leave() (取消 Socket 訂閱房間) 以及 sails.sockets.broadcast() (向一個或多個房間中的所有訂閱者廣播訊息)。

範例

將 Socket 加入 "funSockets" 房間

sails.sockets.join(someSocket, "funSockets");

向 "funSockets" 房間廣播 "hello" 訊息。此訊息將被所有已 (1) 使用 sails.sockets.join() 在伺服器端加入 "funSockets" 房間，且 (2) 使用 socket.on('hello', ...) 在客戶端添加了 "hello" 事件監聽器的客戶端 Socket 接收。

sails.sockets.broadcast("funSockets", "hello", "Hello to all my fun sockets!");

參考資料

查看完整的 sails.sockets API 參考資料
請參閱 sails.io.js 函式庫的參考資料，以了解如何在客戶端使用 Socket 與您的 Sails 應用程式通訊。
請參閱 resourceful pub-sub 參考資料，以了解如何使用 Sails 藍圖自動發送關於您的模型變更的即時訊息。
請訪問 Socket.io 網站，以了解更多關於 Sails 用於即時通訊的底層函式庫資訊

是否有遺漏之處？

如果您發現我們遺漏或可以改進的地方，請點擊此連結並提交 Pull Request 到 Sails 儲存庫。一旦我們合併，變更將在下次網站部署時反映出來。

文件

概念

Built with Love

Sails 框架是由位於德州奧斯汀的網頁和行動應用程式開發工作室，以及我們的貢獻者共同建立的。我們在 2012 年創建 Sails 以協助我們進行 Node.js 專案。自然而然地，我們將其開源。我們希望它能讓您的生活更輕鬆一點！